Citrix ADC

キャッシュされたオブジェクトとキャッシュ統計を表示する

特定のキャッシュされたオブジェクトを表示したり、キャッシュヒット、ミス、メモリ使用量に関するサマリー統計を表示できます。この統計は、キャッシュから提供されるデータの量、最大のパフォーマンス上の利点の原因となる項目、およびキャッシュのパフォーマンスを向上させるために調整できる項目に関する洞察を提供します。

ここでは、次の詳細について説明します。

  • キャッシュされたオブジェクトの表示
  • キャッシュされた特定のレスポンスの検索
  • キャッシュ統計情報の表示

キャッシュされたオブジェクトの表示

キャッシュを有効にすると、キャッシュされたオブジェクトの詳細を表示できます。たとえば、次のアイテムを表示できます。

  • Response sizeとheader size
  • Status code
  • Content group
  • ETag、Last-Modified、Cache-Controlヘッダー
  • Request URL
  • Hit parameters
  • Destination IP address
  • Request timeとresponse time

コマンドラインインターフェイスを使用してキャッシュされたオブジェクトのリストを表示するには

コマンドプロンプトで、次のように入力します。

show cache object

プロパティ 仕様
Response size (bytes) レスポンスヘッダーと本文のサイズ。
Response header size (bytes) レスポンスのヘッダー部分のサイズ。
Response status code 応答とともに送信されるステータスコード。
ETag レスポンスに挿入された ETag ヘッダー。通常、このヘッダーは、応答が最近変更されたかどうかを示します。
Last-Modified レスポンスに挿入された最終変更ヘッダー。このヘッダーは、応答が最後に変更された日付を示します。
Cache-Control 応答に挿入されたキャッシュ制御ヘッダー。
日付 レスポンスがいつ送信されたかを示す Date ヘッダー。
Contentgroup 応答が格納されるコンテンツグループ。
Complex match このオブジェクトがパラメータ化された値に基づいてキャッシュされた場合、このフィールド値は YES です。
Host この応答を要求した URL で指定されたホスト。
Host port このレスポンスを要求した URL で指定されたホストのリスンポート
URL 保存された応答に対して発行された URL。
Destination IP この応答が取得されたサーバーの IP アドレス。
Destination port 宛先サーバーのリッスンポート。
Hit parameters レスポンスを格納するコンテンツグループがヒットパラメータを使用する場合、それらがこのフィールドにリストされます。
Hit selector このコンテンツグループがヒットセレクタを使用する場合、このフィールドにリストされます。
Inval selector このコンテンツグループが無効化セレクターを使用する場合、このフィールドに表示されます。
Selector Expressions このコンテンツグループがセレクタを使用する場合、このフィールドには選択ルールを定義する式が表示されます。
Request time リクエストが発行されてからの時間(ミリ秒)。
Response time キャッシュがレスポンスの受信を開始してから経過した時間(ミリ秒)。
Age オブジェクトがキャッシュに保持された時間。
Expiry オブジェクトが期限切れとしてマークされるまでの時間。
Flushed 応答が満了後にフラッシュされたかどうか。
Prefetch このコンテンツ・グループに対してプリフェッチが構成されている場合、有効期限が切れる前にオブジェクトがオリジンからフェッチされる時間。プリフェッチは、ネガティブ・オブジェクトには適用されません(たとえば、404「オブジェクトが見つかりません」というレスポンス)。
Current readers 現在提供されているヒット数の概算です。Content-Length ヘッダーオブジェクトを含むレスポンスがダウンロードされるとき、現在のミスおよび現在のリーダーの値はそれぞれ通常 1 です。チャンク応答オブジェクトがダウンロードされている場合、現在のミス値は通常 1 ですが、クライアントに提供されるチャンク応答は、統合キャッシュバッファから来ていないため、現在のリーダーの値は通常 0 です。
Current misses キャッシュミスが発生し、オリジンサーバーからのフェッチが発生したリクエストの現在の数。この値は、通常 0 または 1 です。コンテンツグループに対して [毎回ポーリング] が有効になっている場合、カウントは 1 より大きくなる可能性があります。
Hits このオブジェクトのキャッシュヒット数。
Misses このオブジェクトのキャッシュミスの数。
Compression format このオブジェクトに適用される圧縮のタイプ。圧縮フォーマットには、gzip、デフレート、圧縮、およびpack200-gzipが含まれます。
HTTP version in response レスポンスの送信に使用された HTTP のバージョン。
Weak etag present in response エンティティのビットが変更された場合、強力なetagヘッダーが変更されます。強力なヘッダーは、オブジェクトのオクテット値に基づいています。エンティティの意味が変更されると、弱いetagヘッダーが変更されます。弱いetag値は、セマンティックアイデンティティに基づいています。弱いetag値は「W」で始まります。
Negative marker cell マーカーオブジェクトはキャッシュ可能ですが、まだキャッシュされる条件をすべて満たしていません。たとえば、オブジェクトがコンテンツグループの最大応答サイズを超える場合があります。このタイプのオブジェクトには、マーカーセルが作成されます。次回ユーザーがこのオブジェクトに対するリクエストを送信すると、キャッシュミスが処理されます。
Reason marker created マーカーセルが作成された理由 (例:「minhit を待機中」、「コンテンツ長の応答データがグループサイズ制限にありません」)。
Auto poll every time 統合キャッシュが、バリデータ(Last-ModifiedまたはETagレスポンスヘッダーのいずれか)で既に期限切れの200 OKレスポンスを受け取った場合、レスポンスを保存し、Auto-PETとしてマークします(毎回自動的にポーリングします)。
応答として挿入された Citrix ADC タグ Citrix ADCアプライアンスによって生成されるETagヘッダーのバリエーション。Citrix ADCが応答にタグを挿入すると、値「YES」が表示されます。
Full response present in cache これが完全な応答かどうかを示します。
Destination IP verified by DNS オブジェクトを格納するときに DNS 解決が実行されたかどうかを示します。
Object stored through a cache forward proxy 統合キャッシュに設定されているフォワードプロキシが原因で、この応答が格納されたかどうかを示します。
Object is a Delta basefile デルタ圧縮されたレスポンス。
Waiting for minhits 応答をキャッシュする前に、このコンテンツグループで最低数のオリジナルサーバーヒットが必要かどうかを示します。
Minhit count このコンテンツグループがオブジェクトをキャッシュする前に最低数のオリジナルサーバヒットを必要とする場合、このフィールドにはこれまでに受信したヒット数が表示されます。
HTTP Request Method このオブジェクトを取得したリクエストで使用されるメソッド GET または POST。
Stored by policy このオブジェクトを格納する原因となったキャッシュポリシーの名前。NOT AVAILABLE の値は、ポリシーが非アクティブ化または削除されたことを示します。NONE の値は、オブジェクトが可視ポリシーと一致しなかったが、キャッシュの内部基準に従って格納されたことを示します。
Application firewall metadata exists このパラメータは、アプリケーションファイアウォールと統合キャッシュの両方が有効になっている場合に使用されます。アプリケーションファイアウォールは、応答ページの内容を分析し、そのメタデータ(ページに含まれる URL やフォームなど)を格納し、応答とともにメタデータをキャッシュにエクスポートします。キャッシュはページとメタデータを格納し、キャッシュがページを提供するとき、メタデータをリクエストのセッションに送り返します。
HTTP callout object, name, type, response これらのセルは、このデータが HTTP コールアウト式の結果として格納されたかどうかを示し、コールアウトと対応する応答のさまざまな側面に関する情報を提供します。HTTP コールアウトの詳細については、「HTTP コールアウト」を参照してください。

キャッシュされた特定のレスポンスを検索する

検索条件に基づいて、キャッシュ内の個々のアイテムを検索できます。キャッシュされた項目を検索する方法は、データを含むコンテンツグループがヒットセレクタと無効セレクタを使用するかどうかによって異なります。

コンテンツグループがセレクターを使用する場合、キャッシュされたアイテムのロケーター ID を使用してのみ検索を実行できます。

コンテンツグループがセレクタを使用しない場合は、URL、ホスト、コンテンツグループ名などの条件を使用して検索を実行します。

キャッシュされたレスポンスを検索するときは、URLとホストでいくつかの項目を見つけることができます。応答がセレクタを使用するコンテンツグループ内にある場合は、ロケーター番号 (0x0000000000ad7af000050 など) を使用してのみ検索できます。後で使用するために保管棚番号を保存するには、エントリを右クリックして「コピー」を選択します。セレクタの詳細は、「セレクタおよび基本コンテンツグループの構成」を参照してください。

コマンドラインインターフェイスを使用して、セレクタを持たないコンテンツグループにキャッシュされたレスポンスを表示するには

コマンドプロンプトで、次のように入力します。

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>]

GUI を使用してセレクタを持たないコンテンツグループにキャッシュされた応答を表示するには

最適化」>「 統合キャッシュ」>「キャッシュオブジェクト 」に移動し、「 検索 」をクリックして、必要なキャッシュレスポンスを表示する検索条件を設定します。

コンテンツグループをまだ構成していない場合は、すべてのオブジェクトが Default グループに含まれます。

GUI を使用してセレクタを持つコンテンツグループにキャッシュされた応答を表示するには

最適化 」>「 統合キャッシュ」>「キャッシュオブジェクト 」に移動し、「 検索 」をクリックし、セレクタ検索条件を設定して、必要なキャッシュされたレスポンスを表示します。

キャッシュ統計の表示

次の表は、キャッシュの統計情報をまとめたものです。

カウンタ

仕様

キャッシュ統計情報の表示

更新済み:2013-10-28

次の表は、表示できる詳細なキャッシュ統計をまとめたものです。

カウンタ 指定内容
Hits 統合キャッシュで検出され、統合キャッシュから提供される応答。イメージファイル、ステータスコードが 200、203、300、301、302、304、307、403、404、410、およびCACHEアクションを持つユーザー定義ポリシーと一致する応答などの静的オブジェクトが含まれます。
Misses 応答が最終的にオリジンサーバーからフェッチされたHTTPリクエストをインターセプトしました。
Requests キャッシュ・ヒットの合計とキャッシュ・ミスの合計。
304件以外 ユーザーがアイテムを複数回要求し、最後にCitrix ADCアプライアンスがアイテムを配信してからキャッシュ内のアイテムが変更されない場合、Citrix ADCアプライアンスはキャッシュされたオブジェクトの代わりに304レスポンスを返します。この統計は、Citrix ADCアプライアンスがキャッシュから処理したアイテムの数(304レスポンスを除く)を示します。
ヒット回数 304 件 Citrix ADCアプライアンスがキャッシュから処理した304(オブジェクトが変更されていない)応答の数。
304 hit ratio (%) Citrix ADCアプライアンスが処理した304応答の割合(他の応答に対する割合)。
Hit ratio (%) Citrix ADCアプライアンスがキャッシュから処理したレスポンス(キャッシュヒット)のうち、キャッシュから処理できなかったレスポンスの割合。
Origin bandwidth saved (%) キャッシュからの応答を提供するためにCitrix ADCアプライアンスがオリジナル・サーバーに保存した処理キャパシティの見積もり。
Citrix ADC によって処理されるバイト数 Citrix ADCアプライアンスがオリジナル・サーバーとキャッシュから処理した合計バイト数。
Bytes served by cache Citrix ADCアプライアンスがキャッシュから処理した合計バイト数。
Byte hit ratio(%) Citrix ADCアプライアンスがキャッシュから処理したデータの割合。すべての応答に含まれるすべてのデータに対する相対的な割合。
Compressed bytes from cache Citrix ADCアプライアンスが圧縮形式で処理したデータの量(バイト単位)。
Storable misses Citrix ADCアプライアンスは、要求されたオブジェクトをキャッシュ内で検出しない場合、オリジナル・サーバーからオブジェクトをフェッチします。これは、キャッシュミスと呼ばれます。保存可能なキャッシュミスをキャッシュに保存できます。
Non-storable misses 保存不可能なキャッシュミスはキャッシュに保存できません。
Misses すべてのキャッシュミス。
Revalidations Cache-Control ヘッダーの Max-Age 設定は、介在するキャッシュが統合キャッシュでコンテンツをユーザーに提供する前に再検証する必要があるタイミングを秒単位で決定します。詳細は、「キャッシュ制御ヘッダーの挿入」を参照してください。
Successful revalidations 実行された再検証の数。詳細は、「キャッシュ制御ヘッダーの挿入」を参照してください。
Conversions to conditional req キャッシュされた PET オブジェクトに対するユーザーエージェント要求は、常に条件付き要求に変換され、オリジンサーバーに送信されます。詳細は、「要求を受信するたびにオリジンサーバーをポーリングする」を参照してください。
Storable miss ratio (%) 格納可能なキャッシュ・ミスの割合として、格納不可能なキャッシュ・ミスを示します。
Successful reval ratio (%) 再検証の成功率(すべての再検証試行の割合)。詳細は、「キャッシュ制御ヘッダーの挿入」を参照してください。
Expire at last byte 最後のボディバイトを受信した直後にキャッシュがコンテンツを期限切れにした回数。「キャッシュ・ヒットとミス」の表で説明されているように、ポジティブな応答にのみ適用されます。 詳細については、「パフォーマンス最適化の例」を参照してください。
フラッシュキャッシュ Flash Cache を有効にすると、キャッシュはサーバーへのリクエストを 1 つだけ許可し、フラッシュクラウドを排除します。この統計は、キャッシュミスした Flash Cache リクエストの数を示します。詳細については、「キャッシュへのリクエストのキューイング」を参照してください。
Flashcache hits キャッシュヒットであったフラッシュキャッシュリクエストの数。詳細については、「キャッシュへの要求のキューイング」を参照してください。
Parameterized inval requests 無効化(INVAL)アクションを持つポリシーと、無効化セレクタまたはパラメータを使用してグループ内のキャッシュされたオブジェクトを選択的に期限切れにするコンテンツグループと一致するリクエスト。
Full inval requests invalGroups パラメータが設定され、1 つ以上のコンテンツグループが期限切れになる無効ポリシーと一致するリクエスト。
Inval requests 無効化ポリシーに一致し、特定のキャッシュされた応答またはコンテンツグループ全体の有効期限が切れるリクエスト。
Parameterized requests パラメータ化されたコンテンツグループを持つポリシーを使用して処理されたキャッシュリクエストの数。
パラメータ化された 304 以外のヒット パラメータ化されたコンテンツグループを持つポリシーを使用して処理されたキャッシュリクエストの数。フルキャッシュされた応答が見つかり、応答が 304 (オブジェクトが更新されていない) 応答ではなかった。
Parameterized 304 hits パラメータ化されたコンテンツグループを持つポリシーを使用して処理されたキャッシュ要求の数。キャッシュされたオブジェクトが見つかり、オブジェクトが304(オブジェクトが更新されていない)応答でした。
Total parameterized hits パラメータ化されたコンテンツグループを持つポリシーを使用して処理され、キャッシュされたオブジェクトが見つかったキャッシュ要求の数。
Parameterized 304 hit ratio (%) すべてのキャッシュヒットに対する、パラメータ化されたポリシーを使用して検出された 304(オブジェクトが更新されていない)応答の割合。
Poll every time requests [毎回ポーリング]が有効になっている場合、Citrix ADCアプライアンスは、保存されているオブジェクトを提供する前に、常にオリジナル・サーバーに問い合わせます。詳細は、「要求を受信するたびにオリジンサーバーをポーリングする」を参照してください。
Poll every time hits [毎回ポール] メソッドを使用してキャッシュヒットが検出された回数。詳細は、「要求を受信するたびにオリジンサーバーをポーリングする」を参照してください。
Poll every time hit ratio (%) [Poll Every Time] メソッドを使用したキャッシュヒットの割合。[Poll Every Time] を使用したキャッシュオブジェクトのすべての検索に対する、[Poll Every Time] を使用したキャッシュヒットの割合。詳細は、「要求を受信するたびにオリジンサーバーをポーリングする」を参照してください。
Maximum memory (KB) キャッシュに割り当てられるCitrix ADCアプライアンスの最大メモリ容量。詳細は、「キャッシュ用のグローバル属性の構成」を参照してください。
Maximum memory active value (KB) メモリが実際にキャッシュに割り当てられた後に設定されるメモリの最大量(アクティブな値)。詳細については、「Citrix ADCアプライアンスの統合キャッシュ機能をさまざまなシナリオで構成する方法」を参照してください。
Utilized memory (KB) 実際に使用されているメモリの量。
Memory allocation failures 応答をキャッシュに格納する目的でメモリを使用しようとして失敗した試行回数。
Largest response so far キャッシュまたはオリジンサーバーのいずれかで検出され、クライアントに送信される最大のレスポンス(バイト単位)。
Cached objects まだ完全にダウンロードされていないレスポンス、期限切れだがフラッシュされていないレスポンスを含む、キャッシュ内のオブジェクトの数。
Marker objects マーカーオブジェクトは、応答がコンテンツグループの最大応答サイズまたは最小応答サイズを超えた場合、またはコンテンツグループの最小ヒット数をまだ受信していない場合に作成されます。
Hits being served キャッシュから提供されたヒット数。
Misses being handled オリジンサーバーからフェッチされ、キャッシュに格納されてから処理されたレスポンス。保存可能なミスの数に近似する必要があります。保管不可能なミスは含まれません。

コマンドラインインターフェイスを使用してサマリーキャッシュ統計を表示するには

コマンドプロンプトで、次のように入力します。

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 Citrix ADC                        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 を使用してサマリーキャッシュ統計情報を表示するには

  1. ページ上部の [ダッシュボード] タブをクリックします。
  2. ウィンドウの [統合キャッシュ] セクションまで下にスクロールします。
  3. 詳細な統計情報を表示するには、表の下部にある [More…] リンクをクリックします。

GUI を使用して特定のキャッシュ統計を表示するには

  1. ページ上部の [レポート] タブをクリックします。
  2. [組み込みレポート] で、[統合キャッシュ] を展開し、表示する統計情報を含むレポートをクリックします。
  3. レポートをテンプレートとして保存するには、[名前を付けて保存] をクリックしてレポートに名前を付けます。保存したレポートが [カスタムレポート] の下に表示されます。

キャッシュされたオブジェクトとキャッシュ統計を表示する