キャッシュポリシーとセレクタの式を構成する
リクエスト時間式は、リクエストタイムトランザクションのデータを検査し、応答時間式は応答時間トランザクション内のデータを検査します。キャッシュのポリシーで、式が要求または応答のデータと一致する場合、NetScalerアプライアンスはポリシーに関連付けられたアクションを実行します。セレクタでは、リクエスト時間式を使用して、コンテンツグループに格納されている一致する応答を検索します。
統合キャッシュのポリシーとセレクタを構成する前に、少なくとも HTTP 要求および応答 URL に表示されるホスト名、パス、および IP アドレスを知っておく必要があります。そして、おそらくHTTPリクエストとレスポンス全体の形式を知る必要があります。Live HTTP ヘッダー
http://livehttpheaders.mozdev.org/) or HTTPFox https://addons.mozilla.org/en-US/firefox/addon/6647などのプログラムは、組織が操作する HTTP データの構造を調べるのに役立ちます。
株価プログラムに対する HTTP GET リクエストの例を次に示します。
GET /quote.dll?page=dynamic&mode=data&mode=stock&symbol=CTXS&page=multi&selected=CTXS&random=0.00792039478975548 HTTP/1.1
Host: quotes.mystockquotes.com
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.9) Gecko/2008052906 Firefox/3.0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,\*/\*;q=0.8
Accept-Language: en-us,en;q=0.5
Accept-Encoding: gzip,deflate,compress,pack200-gzip
Accept-Charset: ISO-8859-1,utf-8;q=0.7,*;q=0.7
Keep-Alive: 300
Connection: keep-alive
Referer: http://quotes.mystockquotes.com/quote.dll?mode=stock&symbol=CTXS&page=multi&selected=CTXS
Cookie: __qca=1210021679-72161677-10297606
式を設定するときは、次の制限事項に注意してください。
| エクスプレッションタイプ | 制限 |
|---|---|
| リクエスト | CACHE アクションまたは NOCACHE アクションを使用して、ポリシーにリクエスト時間式を設定しないでください。代わりに MAY_CACHE または MAY_NOCACHE を使用してください。 |
| 応答 | キャッシュポリシーでのみ応答時間式を構成します。セレクタはリクエスト時間式のみを使用できます。INVAL アクションを使用してポリシーで応答時間式を設定しないでください。注:CACHE アクションとパラメータ化されたコンテンツグループを使用して、ポリシーで応答時間式を設定しないでください。MAY_CACHE アクションを使用します。 |
注: 高度な式の包括的な説明については、「 ポリシーと式」を参照してください。
Related information
式の構文
構文の基本的なコンポーネントは次のとおりです。
-
次のように、キーワードをピリオド (.) で区切ります。
http.req.url
-
次のように、文字列値を括弧と引用符で囲みます。
http.req.url.query.contains("this")
-
コマンドラインから式を構成するときは、内部引用符 (式を区切る引用符ではなく、式の値を区切る引用符) をエスケープする必要があります。1 つの方法は、次のようにスラッシュを使用することです。
\"abc\"
セレクタ式は外観順に評価され、セレクタ定義内の複数の式は論理 AND で結合されます。セレクタ式とは異なり、ブール演算子を指定し、ポリシールールの高度な式の優先順位を変更できます。
キャッシュポリシーまたはセレクタで式を設定する
注: ポリシー式の構文は、セレクタ式とは異なります。高度な表現に関する包括的な説明については、「ポリシーと式」を参照してください。
コマンドラインインターフェイスを使用してポリシー式を設定するには
-
「統合キャッシュポリシーのグローバルバインド」の説明に従って、ポリシー定義を開始します。
-
ポリシールールを設定するには、ルール全体を引用符で囲み、ルール内の文字列値をエスケープ引用符で囲みます。
以下はその例です：
"http.req.url.contains("jpg")"
-
ブール値を追加するには、&& を挿入し、 ||、または!オペレーター。
以下の例を参照してください：
"http.req.url.contains(\"jpg\") || http.req.url.contains(\"jpeg\")"
"http.req.url.query.contains(\"IssuePage\")"
"http.req.header(\"Host\")contains(\"my.company.com\") && http.req.method.eq(\"GET\") && http.req.url.query.contains(\"v=7\")"
-
コンパウンドの構成部分の評価順序を設定するには
"http.req.url.contains(\"jpg\") || (http.req.url.contains(\"jpeg\") && http.req.method.eq(\"GET\"))"
コマンドラインインターフェイスを使用してセレクタ式を設定するには、次の手順を実行します。
-
「コンテンツ・グループについて」の説明に従って、セレクタ定義を開始します。
-
セレクタ式を設定するには、ルール全体を引用符で囲み、ルール内の文字列値をエスケープ引用符で囲みます。
以下はその例です：
"http.req.url.contains(\"jpg\")"
-
ブール値を追加したり、&& を挿入したりすることはできません。 ||、または!オペレーター。各式エレメントを引用符で囲んで入力します。定義内の複数の式は、論理 AND で結合された複合式として扱われます。
以下の例を参照してください：
"http.req.url.query.value("ProductId")" "http.req.url.query.value("BatchNum")" "http.req.url.query.value("depotLocation")"
GUI を使用してポリシーまたはセレクタ式を設定するには
-
「構成ユーティリティを使用してキャッシュまたは無効化のポリシーを構成するには」または「構成ユーティリティを使用してセレクタを構成するには」の説明に従って、ポリシーまたはセレクタ定義を開始します。
キャッシュされたオブジェクトとキャッシュ統計を表示する
特定のキャッシュされたオブジェクトを表示したり、キャッシュリクエスト、ミス、メモリ使用量に関するサマリー統計を表示できます。この統計は、キャッシュから提供されるデータの量、最大のパフォーマンス上の利点の原因となる項目、およびキャッシュのパフォーマンスを向上させるために調整できる内容に関する洞察を提供します。
ここでは、次の詳細について説明します。
-
キャッシュされたオブジェクトの表示
-
特定のキャッシュされたレスポンスの検索
-
キャッシュ統計の表示
キャッシュされたオブジェクトの表示
キャッシュを有効にすると、キャッシュされたオブジェクトの詳細を表示できます。たとえば、次の項目を表示できます。
-
レスポンスサイズとヘッダーサイズ
-
ステータスコード
-
コンテンツグループ
-
ETag、最終変更ヘッダー、およびキャッシュ制御ヘッダー -
URL をリクエストする
-
ヒットパラメータ
-
宛先 IP アドレス
-
リクエストと応答時間
コマンドラインインターフェイスを使用してキャッシュされたオブジェクトのリストを表示するには
コマンドプロンプトで入力します：
show cache object
| プロパティ | 説明 |
|---|---|
| 応答サイズ (バイト) | レスポンスヘッダーとボディのサイズ。 |
| レスポンスヘッダーのサイズ (バイト) | レスポンスのヘッダー部分のサイズ。 |
| レスポンスステータスコード | レスポンスとともに送信されるステータスコード。 |
| ETag | 応答に挿入された ETag ヘッダー。通常、このヘッダーは、応答が最近変更されたかどうかを示します。 |
| 最終変更日 | レスポンスに挿入された Last-Modified ヘッダー。このヘッダーは、レスポンスが最後に変更された日付を示します。 |
| キャッシュコントロール | レスポンスに挿入された Cache-Control ヘッダー。 |
| 日付 | 応答がいつ送信されたかを示す Date ヘッダー。 |
| コンテンツグループ | レスポンスが格納されるコンテンツグループ。 |
| 複合マッチ | このオブジェクトがパラメータ化された値に基づいてキャッシュされている場合、このフィールド値は YES です。 |
| ホスト | このレスポンスを要求した URL で指定されたホスト。 |
| ホストポート | このレスポンスを要求した URL で指定されたホストのリスニングポート |
| URL | 格納されたレスポンスに対して発行された URL。 |
| 接続先IP | このレスポンスが取得されたサーバーの IP アドレス。 |
| Destination port | 宛先サーバーのリスニングポート。 |
| ヒットパラメータ | レスポンスを格納するコンテンツグループがヒットパラメータを使用している場合は、このフィールドに表示されます。 |
| ヒットセレクタ | このコンテンツグループがヒットセレクタを使用している場合は、このフィールドに表示されます。 |
| 無効なセレクタ | このコンテンツグループが無効化セレクタを使用している場合は、このフィールドに表示されます。 |
| セレクタ式 | このコンテンツグループがセレクタを使用している場合、このフィールドには選択ルールを定義する式が表示されます。 |
| 要求時間 | リクエストが発行されてからの時間（ミリ秒）。 |
| 応答時間 | キャッシュがレスポンスの受信を開始してから経過した時間（ミリ秒）。 |
| 年齢 | オブジェクトがキャッシュ内にある時間。 |
| 有効期限 | オブジェクトが期限切れとしてマークされるまでの時間。 |
| フラッシュされた | 有効期限が切れた後に応答がフラッシュされたかどうか。 |
| プリフェッチ | このコンテンツグループに対してプリフェッチが設定されている場合、オブジェクトがオリジンからフェッチされる有効期限までの時間。プリフェッチはネガティブオブジェクトには適用されません (たとえば、404「オブジェクトが見つかりません」というレスポンス)。 |
| 現在の読者 | 現在処理されているリクエストの概数。Content-Length ヘッダーオブジェクトを含むレスポンスがダウンロードされている場合、現在のミスおよび現在のリーダー値はそれぞれ 1 になります。チャンクレスポンスオブジェクトがダウンロードされている場合、現在のミス値は通常 1 になりますが、クライアントに対して提供されるチャンク応答は統合キャッシュバッファから送信されないため、現在のリーダー値は通常 0 になります。 |
| 現在のミス | キャッシュミスおよびオリジンサーバーからのフェッチの結果となったリクエストの現在の数。この値は、通常 0 または 1 です。コンテンツグループに対して [毎回ポーリング] が有効になっている場合、カウントは 1 より大きくなる可能性があります。 |
| ヒット数 | このオブジェクトのキャッシュヒット数。 |
| ミス | このオブジェクトのキャッシュミス数 |
| 圧縮形式 | このオブジェクトに適用される圧縮のタイプ。圧縮形式としては、gzip、deflate、compress、pack200-gzip などがある。 |
| 応答中の HTTP バージョン | レスポンスの送信に使用された HTTP のバージョン。 |
| 応答に弱いetagが存在する | エンティティのビットが変更された場合、強力な etag ヘッダーが変わります。強力なヘッダーは、オブジェクトのオクテット値に基づいています。エンティティの意味が変わると、弱い etag ヘッダーが変わります。弱な etag 値は、セマンティックアイデンティティに基づいています。弱いetagsの値は「W」で始まります。 |
| ネガティブマーカーセル | マーカーオブジェクトはキャッシュ可能ですが、キャッシュされるための条件をすべて満たしているわけではありません。たとえば、オブジェクトがコンテンツグループの最大応答サイズを超えている可能性があります。このタイプのオブジェクトに対してマーカーセルが作成されます。ユーザーが次回このオブジェクトに対するリクエストを送信すると、キャッシュミスが提供されます。 |
| 理由マーカーが作成されました | マーカーセルが作成された理由 (たとえば、「minhit を待っている」、「コンテンツ長の応答データがグループサイズの制限にありません」など)。 |
| 毎回オートポーリング | 統合キャッシュがバリデーター（Last-Modified または eTag レスポンスヘッダーのいずれか）で既に期限切れの 200 OK レスポンスを受け取った場合、レスポンスを保存し、Auto-PET（毎回自動的にポーリング）としてマークします。 |
| NetScaler Etagがレスポンスで挿入されました | NetScalerアプライアンスによって生成されるETagヘッダーのバリエーション。NetScalerが応答にEtagを挿入すると、値YESが表示されます。 |
| キャッシュに完全なレスポンスが存在 | これが完全な応答であるかどうかを示します。 |
| DNS によって検証された宛先 IP | オブジェクトの格納時に DNS 解決が実行されたかどうかを示します。 |
| キャッシュフォワードプロキシを介して格納されたオブジェクト | 統合キャッシュに設定されたフォワードプロキシが原因で、この応答が格納されたかどうかを示します。 |
| オブジェクトはデルタベースファイルです | デルタ圧縮された応答。 |
| minhits待ち | レスポンスをキャッシュする前に、このコンテンツグループで最小数のオリジンサーバーヒットが必要かどうかを示します。 |
| ミニヒットカウント | オブジェクトをキャッシュする前に、このコンテンツグループが最小数のオリジンサーバー要求を必要とする場合、このフィールドにはこれまでに受信したリクエストの数が表示されます。 |
| HTTP リクエストメソッド | このオブジェクトを取得したリクエストで使用されるメソッド GET または POST。 |
| ポリシー別に格納 | このオブジェクトが格納された原因となったキャッシュポリシーの名前。[利用不可] の値は、ポリシーが非アクティブ化または削除されたことを示します。NONE の値は、オブジェクトが可視ポリシーと一致せず、キャッシュの内部基準に従って格納されたことを示します。 |
| アプリケーションファイアウォールのメタデータが存在します | このパラメータは、アプリケーションファイアウォールと統合キャッシュの両方が有効になっている場合に使用されます。アプリケーションファイアウォールは、レスポンスページのコンテンツを分析し、そのメタデータ（ページに含まれる URL やフォームなど）を保存し、レスポンスを含むメタデータをキャッシュにエクスポートします。キャッシュはページとメタデータを格納し、キャッシュがページを提供すると、メタデータをリクエストのセッションに送り返します。 |
| HTTP コールアウトオブジェクト、名前、タイプ、応答 | これらのセルは、HTTP コールアウト式の結果としてこのデータが格納されたかどうかを示し、コールアウトのさまざまな側面と対応する応答に関する情報を提供します。HTTP コールアウトの詳細については、「HTTP コールアウト」を参照してください。 |
GUI を使用してキャッシュされたオブジェクトを表示するには
キャッシュされた特定のレスポンスを見つける
検索条件に基づいて、キャッシュ内の個々のアイテムを検索できます。キャッシュされたアイテムを検索するには、データを含むコンテンツグループがヒットセレクターと無効化セレクターを使用するかどうかに応じて、次のようにさまざまな方法があります。
-
コンテンツグループがセレクターを使用している場合、キャッシュされたアイテムのロケータ ID を使用してのみ検索を実行できます。
-
コンテンツグループがセレクタを使用しない場合は、URL、ホスト、コンテンツグループ名などの基準を使用して検索を実行します。
キャッシュされたレスポンスを検索するときに、URL とホストでいくつかの項目を見つけることができます。レスポンスがセレクタを使用するコンテンツグループ内にある場合は、ロケータ番号（たとえば、0x00000000ad7af00000050）を使用してのみ検索できます。後で使用するためにロケータ番号を保存するには、エントリを右クリックし、 を選択します。セレクタの詳細については、「セレクタと基本コンテンツグループの設定」を参照してください。
コマンドラインインターフェイスを使用して、セレクタを持たないコンテンツグループのキャッシュされたレスポンスを表示するには
コマンドプロンプトで入力します：
show cache object [-locator <positiveInteger>] | [(-url <URL> (-host <hostName> [-port <port>] [-groupName <contentGroupName>] [-httpMethod GET | POST ])) | [-httpStatus <positive integer>] | -group <contentGroupName> | -ignoreMarkerObjects (ON | OFF) | -includeNotReadyObjects (ON | OFF)]
コマンドラインインターフェイスを使用してセレクタを持つコンテンツグループのキャッシュされたレスポンスを表示するには
コマンドプロンプトで入力します：
show cache object -locator <locatorString> MarkerObjects ( ON | OFF ) | -includeNotReadyObjects ( ON | OFF ) | [-httpStatus<positive integer>]
構成ユーティリティを使用して、セレクタを持たないコンテンツグループのキャッシュされた応答を表示するには
コンテンツグループをまだ構成していない場合は、すべてのオブジェクトが Default グループに属します。
キャッシュ統計の表示
次の表に、表示できる詳細なキャッシュ統計情報をまとめたものです。
| カウンター | 説明 |
|---|---|
| ヒット数 | 統合キャッシュで見つかり、統合キャッシュから提供されるレスポンス。イメージファイルなどの静的オブジェクト、ステータスコード 200、203、300、301、302、304、307、403、404、410、および CACHE アクションを使用したユーザー定義のポリシーに一致する応答を含むページが含まれます。 |
| ミス | レスポンスが最終的にオリジンサーバーからフェッチされた HTTP リクエストをインターセプトしました。 |
| リクエスト | キャッシュリクエストの合計とキャッシュミスの合計。 |
| 304ヒット以外 | ユーザーがアイテムを複数回要求し、NetScalerアプライアンスが最後にアイテムを提供してからキャッシュ内のアイテムが変更されていない場合、NetScalerアプライアンスはキャッシュされたオブジェクトの代わりに304の応答を提供します。 |
**コマンドラインインターフェイスを使用してサマリーキャッシュ統計を表示するには、**次の手順を実行します。
コマンドプロンプトで入力します：
stat cache
**コマンドラインインターフェイスを使用して特定のキャッシュ統計情報を表示するには、**次の手順を実行します。
コマンドプロンプトで入力します：
stat cache -detail
> stat cache -detail
Integrated Cache Statistics - Detail
Integrated Cache Statistics - Summary
Rate (/s) Total
Hits 0 0
Misses 0 0
Requests 0 0
Hit ratio(%) -- 0
Origin bandwidth saved(%) -- 0
Cached objects -- 0
Marker objects -- 0
Rate (/s) Total
Requests 0 0
Hit Statistics
Rate (/s) Total
Non-304 hits 0 0
304 hits 0 0
Sql hits 0 0
Hits 0 0
304 hit ratio(%) -- 0
Hit ratio(%) -- 0
Origin bandwidth saved(%) -- 0
Byte Statistics
Rate (/s) Total
Bytes served by NetScaler 648 55379204
Bytes served by cache 0 0
Byte hit ratio(%) -- 0
Compressed bytes from cache 0 0
Miss Statistics
Rate (/s) Total
Storable misses 0 0
Non-storable misses 0 0
Misses 0 0
Revalidations 0 0
Successful revalidations 0 0
Conversions to conditional req 0 0
Storable miss ratio(%) -- 0
Successful reval ratio(%) -- 0
Flashcache Statistics
Rate (/s) Total
Expire at last byte 0 0
Flashcache misses 0 0
Flashcache hits 0 0
Invalidation Statistics
Rate (/s) Total
Parameterized inval requests 0 0
Full inval requests 0 0
Inval requests 0 0
Parameterized Caching Statistics
Rate (/s) Total
Parameterized requests 0 0
Parameterized non-304 hits 0 0
Parameterized 304 hits 0 0
Total parameterized hits 0 0
Parameterized 304 hit ratio(%) -- 0
Poll Every Time (PET) Statistics
Rate (/s) Total
Poll every time requests 0 0
Poll every time hits 0 0
Poll every time hit ratio(%) -- 0
Memory Usage Statistics
Total
Maximum memory(KB) 0
Maximum memory active value(KB) 0
Utilized memory(KB) 0
Memory allocation failures 0
Largest response so far(B) 0
Cached objects 0
Marker objects 0
Hits being served 0
Misses being handled 0
Done
GUI を使用してサマリーキャッシュ統計を表示するには
GUI を使用して特定のキャッシュ統計を表示するには