セレクタと基本的なコンテンツグループを構成する
セレクターを設定してコンテンツグループに適用できます。セレクターを 1 つ以上のコンテンツグループに追加する場合、そのセレクターをキャッシュリクエストの識別に使用するのか、無効化する (期限切れの) キャッシュオブジェクトの識別に使用するのかを指定します。セレクターはオプションです。または、
hit パラメータと無効化パラメータを使用するようにコンテンツグループを設定することもできます。ただし、Citrixではセレクターを構成することをお勧めします。
セレクターを設定するか、代わりにパラメーターを使用することを決定したら、基本的なコンテンツグループを設定する準備が整います。基本コンテンツグループを作成したら、キャッシュからオブジェクトを期限切れにする方法を決定し、キャッシュの有効期限を設定する必要があります。「 キャッシュパフォーマンスの向上 」および「 Cookie、ヘッダー、およびポーリングの設定」の説明に従って、キャッシュをさらに変更できますが、最初にキャッシュポリシーを構成する必要がある場合があります。
注
コンテンツグループのパラメータとセレクタはリクエスト時にのみ使用され、通常は MAY_CACHE または MAY_NOCACHE アクションを使用するポリシーに関連付けます。
Related information
セレクターの利点
セレクターは、コンテンツグループ内の特定のオブジェクトを検索するフィルターです。セレクターを構成しない場合、Citrix® ADCアプライアンスはコンテンツグループ内で完全に一致するものを探します。これにより、コンテンツグループに同じオブジェクトの複数のコピーが存在する可能性があります。たとえば、セレクターのないコンテンツグループには、host1.domain.com\ mypage.htm、host2.domain.com\ mypage.htm、host3.domain.com\ mypage.htm の URL を保存する必要がある場合があります。これに対し、セレクターは URL (mypage.html、http.req.url という表現を使用) とドメイン (.com、http.req.hostname.domain という表現を使用) のみを照合できるため、同じURLでリクエストを処理できます。
セレクター式を使用すると、パラメータを簡単に照合できます (たとえば、いくつかのクエリ文字列パラメータとその値に一致するオブジェクトを検索する場合など)。セレクター式では、ブール論理、算術演算、属性の組み合わせを使用してオブジェクト (URL ステムのセグメント、クエリ文字列、POST リクエスト本文の文字列、HTTP ヘッダーの文字列、Cookie など) を識別できます。セレクターはプログラム関数を実行してリクエスト内の情報を分析することもできます。例えば、セレクタは、POST本文内のテキストを抽出し、テキストをリストに変換し、リストから特定の項目を抽出することができます。
式および式で指定できる内容の詳細については、「 ポリシーと式」を参照してください。
セレクタの代わりにパラメータを使用する
Citrixではコンテンツグループでセレクターを使用することを推奨していますが、
hit 代わりにパラメーターと無効化パラメーターを構成できます。たとえば、バグレポート用のコンテンツグループに BugID、Issuer、Assignee の 3 hit つのパラメーターを設定するとします。リクエストにBugID=456、発行者=Rohitv、担当者=Robertの場合、NetScalerアプライアンスはこれらのパラメーターと値のペアに一致する応答を処理できます。
コンテンツグループの無効化パラメータは、キャッシュされたエントリを期限切れにします。たとえば、BugID が無効化パラメータで、ユーザが POST リクエストを発行してバグレポートを更新したとします。無効化ポリシーによってリクエストがこのコンテンツグループに送信され、コンテンツグループの無効化パラメータにより、BugID 値と一致するキャッシュされたすべての応答が期限切れになります。（次回ユーザーがこのレポートに対してGETリクエストを発行したときに、キャッシュポリシーにより、NetScalerアプライアンスはオリジンサーバーからのレポートのキャッシュされたエントリを更新できます。）
hit 同じパラメーターをパラメーターまたは無効化パラメーターとして使用できることに注意してください。
コンテンツグループは次の順序でリクエストパラメータを抽出します。
-
URL クエリ
-
ポストボディ
-
クッキーヘッダー
パラメータが最初に出現した後は、リクエスト内のどこで発生したかに関係なく、それ以降の出現はすべて無視されます。たとえば、URL クエリと POST 本文の両方にパラメータが存在する場合、URL クエリのパラメータのみが考慮されます。
コンテンツグループにヒットパラメータと無効化パラメータを使用する場合は、コンテンツグループを設定するときにパラメータを設定します。
注：Citrixでは、パラメータ化されたコンテンツグループではなくセレクターを使用することをお勧めします。セレクターはより柔軟で、より多くの種類のデータに対応できるためです。
セレクタを構成する
コンテンツグループは、ヒットセレクターを使用してキャッシュヒットを取得したり、無効化セレクターを使用して期限切れのキャッシュオブジェクトを期限切れにしてオリジンサーバーから新しいオブジェクトを取得したりできます。
セレクタには、 高度な式と呼ばれる名前と論理式が含まれています。
高度な式の詳細については、「 ポリシーと式」を参照してください。
セレクタを設定するには、セレクタに名前を割り当て、1 つ以上の式を入力します。ベストプラクティスとして、特に省略する理由がない限り、セレクター式には URL のステムとホストを含める必要があります。
CLI を使用してセレクターを設定するには
コマンドプロンプトで入力します。
add cache selector \<selectorName\> ( \<rule\> ... )
式を設定する方法については、「 コマンドラインインターフェイスを使用してセレクタ式を設定するには」を参照してください。
>add cache selector product_selector "http.req.url.query.value("ProductId")" "http.req.url.query.value("BatchNum")" "http.req.url.query.value("depotLocation")"
> add cache selector batch_selector "http.req.url.query.value("ProductId")" "http.req.url.query.value("BatchId")" "http.req.url.query.value("depotLocation")"
> add cache selector product_id_selector "http.req.url.query.value("ProductId")"
> add cache selector batchnum_selector "http.req.url.query.value("BatchNum")" "http.req.url.query.value("depotLocation")"
> add cache selector batchid_selector "http.req.url.query.value("depotLocation")" "http.req.url.query.value("BatchId")"
GUI を使用してセレクタを設定するには
コンテンツグループ
コンテンツグループは、レスポンスで提供できるキャッシュされたオブジェクトのコンテナです。統合キャッシュを初めて有効にすると、キャッシュ可能なオブジェクトは Default という名前のコンテンツグループに保存されます。独自のプロパティを持つコンテンツグループを作成できます。たとえば、画像データ、バグレポート、株価情報用に個別のコンテンツグループを定義したり、株価コンテンツグループを他のグループよりも頻繁に更新するように構成したりできます。
コンテンツグループ全体またはコンテンツグループ内の選択したエントリの有効期限を設定できます。
コンテンツグループのデータは、次のように静的でも動的でもかまいません。
-
静的コンテンツグループ。リクエストの URL ステムとホスト名、およびレスポンスの URL ステムとホスト名が完全に一致するものを検索します。
-
動的コンテンツグループ。特定のパラメータと値のペア、任意の文字列、または文字列パターンを含むオブジェクトを検索します。動的コンテンツグループは、頻繁に更新されるデータ (バグレポートや株価情報など) をキャッシュする場合に便利です。
コンテンツグループからのリクエストを処理する
-
ブラウザは 1 つ以上の HTTP GET リクエストを発行します。これらのリクエストにはパラメーター (バグ所有者、バグ ID など) が含まれます。
-
NetScalerアプライアンスは要求を受信すると、一致するポリシーを検索し、これらの要求と一致するキャッシュポリシーが見つかると、要求をコンテンツグループに送信します。
-
コンテンツグループは、セレクターで設定した基準に基づいて、コンテンツグループ内の適切なオブジェクトを検索します。
たとえば、コンテンツグループは
NameField=username and BugID=IDに一致する応答を取得できます。
-
一致するオブジェクトが見つかると、NetScalerアプライアンスはそれらをユーザーのブラウザに提供し、そこで完全な応答（バグレポートなど）にまとめられます。
コンテンツグループのオブジェクトを無効にする
-
ブラウザは、このデータを 1 つ以上の HTTP リクエストの形式で送信します。たとえば、バグの所有者とバグ ID に関する情報を含む複数の HTTP POST リクエストの形式でバグレポートを送信できます。
-
NetScalerアプライアンスは、リクエストを無効化ポリシーと照合します。通常、これらのポリシーは HTTP POST メソッドを検出するように設定されます。
-
要求が無効化ポリシーと一致する場合、NetScalerアプライアンスはこのポリシーに関連付けられているコンテンツグループを検索し、構成された無効化条件に一致する応答を期限切れにします。
たとえば、無効化セレクターは一致する応答を検索できます。
NameField=username and BugID=ID
-
NetScalerアプライアンスがこれらの応答に対するGET要求を次回受信すると、元のサーバーから更新されたバージョンを取得し、更新された応答をキャッシュして、これらの応答をユーザーのブラウザーに提供します。これらの応答は、完全なバグレポートにまとめられます。
基本コンテンツグループの設定
デフォルトでは、キャッシュされたデータはすべてデフォルトのコンテンツグループに保存されます。複数のコンテンツグループを設定し、これらのコンテンツグループを 1 つ以上のポリシーで指定できます。
静的コンテンツにはコンテンツグループを設定でき、動的コンテンツにはコンテンツグループを構成する必要があります。デフォルトグループを含むすべてのコンテンツグループの設定を変更できます。
コマンドラインインターフェイスを使用して基本的なコンテンツグループを設定するには
コマンドプロンプトで入力します。
add cache contentgroup <name> (-hitSelector <hitSelectorName> -invalSelector <invalidationSelectorName> | -hitParams <hitParamName> -invalParams<invalidationParamName>) -type <type> [-relExpiry <sec> | -relExpiryMilliSec <msec>] [-heurExpiryParam <positiveInteger>]
add cache contentgroup Products_Details –hitSelector product_selector –invalSelector id_selector
add cache contentgroup bugrep -hitParams IssuePage RecordID Template TableId -invalParams RecordID -relExpiry 864000
GUI を使用して基本的なコンテンツグループを設定するには
キャッシュされたオブジェクトを期限切れにするかフラッシュする
応答に Expires ヘッダーまたは有効期限 (Max-Age または Smax-Age) の Cache-Control ヘッダーがない場合は、次のいずれかの方法を使用してコンテンツグループのオブジェクトを期限切れにする必要があります。
-
コンテンツグループの有効期限設定を設定して、オブジェクトを保持するかどうか、また保持する期間を決定します。
-
コンテンツグループの無効化ポリシーとアクションを構成します。詳細については、「 キャッシュと無効化のポリシーの設定」を参照してください。
-
コンテンツグループまたはコンテンツグループ内のオブジェクトを手動で期限切れにします。
キャッシュされた応答の有効期限が切れると、NetScalerアプライアンスは次回クライアントが応答を要求したときにそれを更新します。デフォルトでは、キャッシュがいっぱいになると、NetScalerアプライアンスは最も使用頻度の低い応答を最初に置き換えます。
次のリストでは、コンテンツグループの設定を使用してキャッシュされた応答を期限切れにする方法について説明します。通常、これらのメソッドはパーセントまたは秒単位で指定されます。
-
マニュアル。コンテンツグループのすべての応答またはキャッシュ内のすべての応答を手動で無効にする。
-
レスポンスベース。肯定応答と否定応答の特定の有効期限。レスポンスベースの有効期限は、レスポンスに Last-Modified ヘッダーがない場合にのみ考慮されます。
-
ヒューリスティックな有効期限。Last-Modified ヘッダーを持つ応答の場合、ヒューリスティック有効期限は応答が変更されてからの経過時間を指定します (現在の時刻から Last-Modified 時間を引き、ヒューリスティック有効期限の値を掛けて計算されます)。たとえば、Last-Modified ヘッダーが応答が 2 時間前に更新されたことを示していて、ヒューリスティック有効期限設定が 10% の場合、キャッシュされたオブジェクトは 0.2 時間後に期限切れになります。この方法では、頻繁に更新される応答は、より頻繁に期限切れになる必要があると想定しています。
-
絶対または相対。回答が毎日期限切れになる正確な（絶対）時刻を、HH: MM 形式、ローカル時間、または GMT で指定します。ローカルタイムはすべてのタイムゾーンで機能しない場合があります。
相対的な有効期限は、キャッシュミスによりオリジンサーバーにアクセスした時点から応答の有効期限が切れるまでの数秒またはミリ秒を指定します。相対有効期限をミリ秒単位で指定する場合は、10 の倍数を入力します。この形式の有効期限は、すべての肯定的な回答に適用されます。レスポンスの Last Modified、Expires、Cache-Control ヘッダーは無視されます。
絶対有効期限と相対有効期限は、レスポンス自体の有効期限情報よりも優先されます。
-
ダウンロード時。「レスポンス受信完了後に期限切れ」オプションを選択すると、レスポンスがダウンロードされた時点で期限切れになります。これは、株価情報など、頻繁に更新される回答に役立ちます。デフォルトでは、このオプションは無効になっています。
「Flash Cache」と「レスポンス受信完了後に期限切れ」の両方を有効にすると、動的アプリケーションのパフォーマンスが向上します。両方のオプションを有効にすると、NetScalerアプライアンスは同時リクエストのブロックに対して1つの応答のみを取得します。
-
**固定されています。**デフォルトでは、キャッシュがいっぱいになると、NetScalerアプライアンスは最も使用頻度の低い応答を最初に置き換えます。NetScalerアプライアンスは、固定されているとマークされているコンテンツグループにはこの動作を適用しません。
コンテンツグループの有効期限設定を行わない場合、グループ内のオブジェクトを期限切れにするオプションは次のとおりです。
-
コンテンツグループに適用される INVAL アクションを含むポリシーを設定します。
-
INVAL アクションを使用するポリシーを設定する場合は、コンテンツグループの名前を入力します。
有効期限法の適用方法
有効期限の仕組みは、肯定的な回答と否定的な回答で異なります。肯定的反応と否定的反応は、下記の表「 陽性反応の有効期限、および否定的回答の有効期限 」に記載されています。
コンテンツグループに適用される有効期限方法を理解するための経験則は次のとおりです。
-
オブジェクトを期限切れにするかどうかを決定するときに、NetScalerアプライアンスが応答ヘッダーを評価するかどうかを制御できます。
-
絶対有効期限と相対有効期限により、NetScalerアプライアンスは応答ヘッダーを無視します（応答の有効期限情報は上書きされます）。
-
ヒューリスティックな有効期限設定と「弱陽性」および「弱陰性」の有効期限（ 構成ユーティリティではデフォルト値として表示 ）により、NetScalerアプライアンスは応答ヘッダーを調べます。これらの設定は次のように連動します。
-
Expires または Cache-Control ヘッダーの値は、これらのコンテンツグループ設定よりも優先されます。
-
ExpiresまたはCache-Controlヘッダーがないが、Last-Modifiedヘッダーがある肯定応答の場合、NetScalerアプライアンスはヒューリスティックな有効期限設定をヘッダー値と比較します。
-
Expires、Cache-Control、Last-Modifiedのヘッダーがない肯定的な応答には、NetScalerアプライアンスは「弱い陽性」の値を使用します。
-
ExpiresまたはCache-Controlヘッダーのない否定的な応答の場合、NetScalerアプライアンスは「弱い負の」値を使用します。
-
次の表は、これらの方法の適用方法をまとめたものです。
| 応答タイプ | 有効期限ヘッダータイプ | コンテンツグループ設定 | オブジェクトがキャッシュに残っている期間 |
|---|---|---|---|
| ポジティブ | すべてのヘッダー | 他の設定なしでコンテンツを期限切れにする (REExpiry) | 「 コンテンツを期限切れにする 」設定の値を使用してください。 |
| ポジティブ | すべてのヘッダー | 他の設定なしでコンテンツを期限切れにする (ABS期限) | [ コンテンツの有効期限 ] 設定の値から現在の日付を引きます。 |
| ポジティブ | すべてのヘッダー | [コンテンツの有効期限] ([有効期限]) と [コンテンツの期限切れ] (ABS期限) | コンテンツグループの設定には、2 つの値の小さい方を使用します。この表の前の行を参照してください。 |
| ポジティブ | 最終更新日 (他のヘッダーを含む) | ヒューリスティック (HeuRExpiry パラメータ) とその他の設定 | 現在の日付から最終更新日を引き、その結果にヒューリスティック有効期限設定の値を掛けて、100 で割ります。 |
| ポジティブ | 最終更新日 (他のヘッダーを含む) | デフォルト (正) (WeakPosREL 有効期限)、その他の設定なし | デフォルト (正) 有効期限設定の値を使用してください。 |
| ポジティブ | 有効期限切れまたはキャッシュコントロール:Max-Age ヘッダーが存在する | 最終更新ヘッダーが存在しない、ヒューリスティック (HeuRespiry パラメーター)、デフォルト (正) (WeakPosREL 有効期限)、またはその両方が表示される | 有効期限または日付から現在の日付を引きます。 Cache-Control:Max-Age |
| ポジティブ | キャッシュヘッダーなし | デフォルト (正) (WeakPosREL 有効期限) およびその他の有効期限設定 | デフォルト (正) 設定の値を使用してください。 |
| ポジティブ | キャッシュヘッダーなし | ヒューリスティック (HeuRespiry パラメーター) は存在しますが、デフォルト (正) (WeakPosREL 有効期限) 設定はありません。 | Last-Modified ヘッダーがない場合、応答はキャッシュされないか、既に Expired ステータスでキャッシュされます。Last-Modified ヘッダーが存在する場合は、ヒューリスティックな有効期限値を使用してください。 |
| ネガティブ | 有効期限が切れるまたは Cache-Control:Max-Age |
[コンテンツを期限切れにする (RELExpiry)]、[コンテンツの有効期限] (ABS Expiry)、またはその両方の設定 | Expires ヘッダーの値から現在の日付を減算するか、Cache-Control: Max-Age ヘッダーの値を使用してください。 |
| ネガティブ | 有効期限またはキャッシュコントロールヘッダーがない | [コンテンツを期限切れにする (RELExpiry)]、[コンテンツの有効期限] (ABS Expiry)、またはその両方の設定 | レスポンスはキャッシュされていないか、すでに期限切れのステータスでキャッシュされています。 |
| ネガティブ | 有効期限が切れるまたは Cache-Control:Max-Age |
すべての設定 | Cache-Control:Max-Age 有効期限または日付から現在の日付を引きます。 |
| ネガティブ | 有効期限とキャッシュコントロール:Max-Age ヘッダーはありません | デフォルト (マイナス) (弱ネグレルの有効期限) | デフォルト (マイナス) 設定の値を使用してください。 |
| ネガティブ | 有効期限とキャッシュコントロール:Max-Age ヘッダーはありません | デフォルト (マイナス) (WeakNegrel 有効期限) 以外のすべての設定 | オブジェクトはキャッシュされていないか、すでに期限切れのステータスでキャッシュされています。 |
手動でコンテンツグループを期限切れにする
コンテンツグループのすべてのエントリを手動で期限切れにすることができます。
コマンドラインインターフェイスを使用してコンテンツグループのすべての回答を手動で期限切れにするには
コマンドプロンプトで入力します。
expire cache contentGroup <name>
GUI を使用してコンテンツグループ内のすべての応答を手動で期限切れにするには
GUI を使用してキャッシュ内のすべての応答を手動で期限切れにするには
コンテンツグループの定期的な有効期限の設定
エントリを選択的に期限切れにするか、完全に期限切れにするように、コンテンツグループを設定できます。有効期限は固定でも相対でもかまいません。
コマンドラインインターフェイスを使用してコンテンツグループの有効期限を設定するには
コマンドプロンプトで入力します。
set cache contentgroup \<name> (-relExpiry|-relExpiryMilliSec|-absExpiry|-absExpiryGMT| -heurExpiryParam|-weakPosRelExpiry|-weakNegRelExpiry| -expireAtLastBye) \<expirationValue>
GUI を使用してコンテンツグループの有効期限を設定するには
個々の回答を期限切れにする
応答の期限が切れると、NetScalerアプライアンスは更新されたコピーを元のサーバーから強制的に取得します。たとえば、
ETag バリデーターや Last-Modified ヘッダーがないレスポンスは再検証できません。そのため、これらの応答をフラッシュしても、期限切れになるのと同じ効果があります。
静的データのコンテンツグループ内のキャッシュされたレスポンスを期限切れにするには、保存されている URL と一致する必要がある URL を指定できます。キャッシュされた応答がパラメータ化されたコンテンツグループの一部である場合は、グループ名と正確な URL ステムを指定する必要があります。ホスト名とポート番号は、キャッシュされたレスポンスのホスト HTTP リクエストヘッダーと同じでなければなりません。ポートが指定されていない場合、ポート80と見なされます。
コマンドラインインターフェイスを使用してコンテンツグループ内の個々の回答を期限切れにするには
コマンドプロンプトで入力します。
expire cache object -url <URL> -host <hostName> [-port <port>] [-groupName<contentGroupName>] [-httpMethod GET|POST]
CLI を使用してコンテンツグループの個々の回答を期限切れにするには
コマンドプロンプトで、次のコマンドを入力します。
expire cache object -locator <positiveInteger>
GUI を使用してキャッシュされたレスポンスを期限切れにするには
GUI を使用して応答を期限切れにするには
コンテンツグループ内の回答をフラッシュする
コンテンツグループ内のすべての応答、グループ内の一部の応答、またはキャッシュ内のすべての応答を削除またはフラッシュできます。キャッシュされたレスポンスをフラッシュすると、キャッシュされた新しいレスポンス用にメモリが解放されます。
注：
一度に複数のオブジェクトの応答をフラッシュするには、設定ユーティリティメソッドを使用します。コマンドラインインターフェイスにはこのオプションはありません。
コマンドラインインターフェイスを使用してコンテンツグループからの応答をフラッシュするには
コマンドプロンプトで入力します。
flush cache contentGroup <name> [-query <queryString> | [-selectorValue <selectorExpressionIDList> -host <hostName>]]
GUI を使用してコンテンツグループからの応答をフラッシュするには
-
詳細ペインで、次のように回答をフラッシュします。
-
すべてのコンテンツグループのすべての回答を消去するには、「すべて無効」をクリックし、すべての回答をフラッシュします。
-
特定のコンテンツグループの回答を消去するには、コンテンツグループを選択し、「 無効化」をクリックして、すべての回答をフラッシュします。
-
注: このコンテンツグループがセレクターを使用している場合は、「セレクター値」テキストボックスに文字列を入力し、「ホスト」テキストボックスにホスト名を入力することで、回答を選択的にフラッシュできます。次に、「 **フラッシュ」と「OK」**をクリックします。Selector の値には、パラメータ化された無効化に使用される最大 2319 文字のクエリ文字列を使用できます。
コンテンツグループが無効化パラメータを使用している場合は、クエリフィールドに文字列を入力することで回答を選択的にフラッシュできます。
コンテンツグループが無効化パラメータを使用しており、ターゲットホストに属するオブジェクトを無効化するように設定されている場合は、「クエリー」フィールドと「ホスト」フィールドに文字列を入力します。
コマンドラインインターフェイスを使用してキャッシュされた応答をフラッシュするには
コマンドプロンプトで入力します。
flush cache object -locator <positiveInteger> | -url <URL> -host <hostName> [-port <port>] [-groupName <contentGroupName>] [-httpMethod GET|POST]
GUI を使用してキャッシュされたレスポンスをフラッシュするには
コンテンツグループを削除する
キャッシュにレスポンスを保存するポリシーで使用されていないコンテンツグループを削除できます。コンテンツグループがポリシーにバインドされている場合は、最初にポリシーを削除する必要があります。コンテンツグループを削除すると、そのグループに保存されているすべての回答が削除されます。
デフォルト、BASEFILE、またはデルタグループを削除することはできません。デフォルトグループには、他のコンテンツグループに属さないキャッシュされた応答が格納されます。
コマンドラインインターフェイスを使用してコンテンツグループを削除するには
コマンドプロンプトで入力します。
rm cache contentgroup <name>
GUI を使用してコンテンツグループを削除するには