Citrix ADC

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

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

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

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

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

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

  • 応答サイズとヘッダーサイズ
  • ステータスコード
  • コンテンツグループ
  • ETag、Last-Modified、およびCache-Controlヘッダー
  • 要求 URL
  • ヒットパラメーター
  • 送信先IPアドレス
  • 要求と応答の時間

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

コマンドプロンプトで入力します。

show cache object

プロパティ 仕様
応答サイズ(バイト) レスポンスヘッダーと本文のサイズ。
応答ヘッダーサイズ(バイト) レスポンスのヘッダー部分のサイズ。
応答ステータスコード 応答とともに送信されるステータスコード。
ETag 応答に挿入された ETag ヘッダー。通常、このヘッダーは、応答が最近変更されたかどうかを示します。
Last-Modified レスポンスに挿入された最終変更ヘッダー。このヘッダーは、応答が最後に変更された日付を示します。
Cache-Control 応答に挿入されたキャッシュ制御ヘッダー。
日付 レスポンスがいつ送信されたかを示す Date ヘッダー。
Contentgroup 応答が格納されるコンテンツグループ。
複雑さの一致 このオブジェクトがパラメーター化された値に基づいてキャッシュされた場合、このフィールド値はYESです。
ホスト この応答を要求した URL で指定されたホスト。
ホストポート このレスポンスを要求した URL で指定されたホストのリスンポート
URL 保存された応答に対して発行された URL。
接続先IP この応答が取得されたサーバーの IP アドレス。
Destination port 宛先サーバーのリッスンポート。
ヒットパラメーター レスポンスを格納するコンテンツグループがヒットパラメータを使用する場合、それらがこのフィールドにリストされます。
ヒットセレクタ このコンテンツグループがヒットセレクタを使用する場合、このフィールドにリストされます。
Inval selector このコンテンツグループが無効化セレクターを使用する場合、このフィールドに表示されます。
セレクタ式 このコンテンツグループがセレクタを使用する場合、このフィールドには選択ルールを定義する式が表示されます。
要求時間 リクエストが発行されてからの時間(ミリ秒)。
Response time キャッシュがレスポンスの受信を開始してから経過した時間(ミリ秒)。
年齢 オブジェクトがキャッシュに保持された時間。
期限 オブジェクトが期限切れとしてマークされるまでの時間。
フラッシュ済み 応答が満了後にフラッシュされたかどうか。
プリフェッチ このコンテンツ・グループに対してプリフェッチが構成されている場合、有効期限が切れる前にオブジェクトがオリジンからフェッチされる時間。プリフェッチは、ネガティブ・オブジェクトには適用されません(たとえば、404「オブジェクトが見つかりません」というレスポンス)。
現在のリーダー 現在提供されているヒット数の概算です。Content-Length ヘッダーオブジェクトを含むレスポンスがダウンロードされるとき、現在のミスおよび現在のリーダーの値はそれぞれ通常 1 です。チャンク応答オブジェクトがダウンロードされている場合、現在のミス値は通常 1 ですが、クライアントに提供されるチャンク応答は、統合キャッシュバッファから来ていないため、現在のリーダーの値は通常 0 です。
現在のミス キャッシュミスが発生し、オリジンサーバーからのフェッチが発生したリクエストの現在の数。この値は、通常 0 または 1 です。コンテンツグループに対して [毎回ポーリング] が有効になっている場合、カウントは 1 より大きくなる可能性があります。
ヒット数 このオブジェクトのキャッシュヒット数。
ミス このオブジェクトのキャッシュミスの数。
圧縮形式 このオブジェクトに適用される圧縮のタイプ。圧縮フォーマットには、gzip、デフレート、圧縮、およびpack200-gzipが含まれます。
レスポンスのHTTPバージョン レスポンスの送信に使用された HTTP のバージョン。
応答に弱い etag が存在する エンティティのビットが変更されると、強力な etag ヘッダーが変更されます。強力なヘッダーは、オブジェクトのオクテット値に基づいています。エンティティの意味が変わると、弱い etag ヘッダーも変わります。弱い etag 値は、セマンティックアイデンティティに基づいています。弱い etags 値は「W」で始まります。
負のマーカーセル マーカーオブジェクトはキャッシュ可能ですが、まだキャッシュされる条件をすべて満たしていません。たとえば、オブジェクトがコンテンツグループの最大応答サイズを超える場合があります。このタイプのオブジェクトには、マーカーセルが作成されます。次回ユーザーがこのオブジェクトに対するリクエストを送信すると、キャッシュミスが処理されます。
作成された理由マーカー マーカーセルが作成された理由 (例:「minhit を待機中」、「コンテンツ長の応答データがグループサイズ制限にありません」)。
毎回自動ポーリング 統合キャッシュは、バリデーター(Last-Modifiedまたは ETag 応答ヘッダー)を使用してすでに期限切れの200 OK応答を受信すると、応答を格納し、Auto-PETとしてマークします(毎回自動的にポーリングします)。
応答として挿入された Citrix ADC タグ Citrix ADCアプライアンスによって生成される ETag ヘッダーのバリエーション。Citrix ADCが応答に Etag を挿入すると、値YESが表示されます。
キャッシュに完全な応答が存在 これが完全な応答かどうかを示します。
DNS検証済み送信先IP オブジェクトを格納するときに DNS 解決が実行されたかどうかを示します。
キャッシュフォワードプロキシ経由で格納されるオブジェクト 統合キャッシュに設定されているフォワードプロキシが原因で、この応答が格納されたかどうかを示します。
オブジェクトはデータベースファイル デルタ圧縮されたレスポンス。
最小ヒットを待機 このコンテンツグループが、応答をキャッシュする前にヒットするオリジンサーバーの最小数を必要とするかどうかを示します。
最小ヒット数 このコンテンツグループがオブジェクトをキャッシュする前に最小数のオリジンサーバーヒットを必要とする場合、このフィールドにはこれまでに受信したヒット数のカウントが表示されます。
HTTP 要求メソッド このオブジェクトを取得したリクエストで使用されるメソッド GET または POST。
ポリシーで格納 このオブジェクトを格納する原因となったキャッシュポリシーの名前。NOT AVAILABLE の値は、ポリシーが非アクティブ化または削除されたことを示します。NONE の値は、オブジェクトが可視ポリシーと一致しなかったが、キャッシュの内部基準に従って格納されたことを示します。
アプリケーションファイアウォールメタデータが存在 このパラメータは、アプリケーションファイアウォールと統合キャッシュの両方が有効になっている場合に使用されます。アプリケーションファイアウォールは、応答ページの内容を分析し、そのメタデータ(ページに含まれる URL やフォームなど)を格納し、応答とともにメタデータをキャッシュにエクスポートします。キャッシュはページとメタデータを格納し、キャッシュがページを提供するとき、メタデータをリクエストのセッションに送り返します。
HTTPコールアウトオブジェクト、名前、タイプ、応答 これらのセルは、このデータが 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 を使用してセレクタを持つコンテンツグループにキャッシュされた応答を表示するには

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

キャッシュ統計の表示

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

Counter

仕様

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

更新済み:2013-10-28

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

Counter Specifies
ヒット数 統合キャッシュで検出され、統合キャッシュから提供される応答。イメージファイル、ステータスコードが 200、203、300、301、302、304、307、403、404、410、およびCACHEアクションを持つユーザー定義ポリシーと一致する応答などの静的オブジェクトが含まれます。
ミス 応答が最終的にオリジンサーバーからフェッチされたHTTPリクエストをインターセプトしました。
要求 キャッシュ・ヒットの合計とキャッシュ・ミスの合計。
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 保存不可能なキャッシュミスはキャッシュに保存できません。
ミス すべてのキャッシュミス。
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 ヒット曲 キャッシュヒットであったフラッシュキャッシュリクエストの数。詳細については、「キャッシュへの要求のキューイング」を参照してください。
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
<!--NeedCopy-->

GUI を使用してサマリーキャッシュ統計情報を表示するには

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

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

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