Varnish Cacheのモニタリング統合

Varnish Cache on-host integration は、Varnish Cache 環境のインベントリとメトリクスを収集し、New Relic に送信することで、その健全性を監視することができます。メトリクスは、インスタンス、ロック、メモリプール、ストレージ、バックエンドの各レベルで収集します。

統合をインストールし、収集するデータを確認するために読んでください。

互換性と要件

Varnish Cache 1.0以上に対応しています。

統合をインストールする前に、次の要件を満たしていることを確認してください。

インフラストラクチャエージェントをインストールします。
Linux ディストリビューションまたは Windows バージョン当社のインフラストラクチャ・エージェントと互換性がある。

クイックスタート

ガイド付きインストールで、Varnish Cache 環境をすばやくインスツルメンテーションし、テレメトリーデータを送信します。ガイド付きインストールでは、お客様の環境に合わせてカスタマイズされたCLIコマンドを作成し、New Relic CLIとインフラストラクチャ・エージェントをダウンロードしてインストールします。

始める準備はできましたか？これらのボタンのいずれかをクリックして試してください。

ガイド付きインストール

EUガイド付きインストール

ガイド付きインストールでは、インフラストラクチャ・エージェントを使用して、Varnish Cacheの統合を設定します。それだけでなく、あなたの環境で稼働している他のアプリケーションやログソースを発見し、どのアプリケーションを導入すべきかを推奨してくれます。

このガイド付きインストールは、ほとんどのセットアップに対応しています。Varnish Cache環境の監視を開始するには、以下の方法がありますので、ご利用ください。

インストールしてアクティブ化する

Varnish Cacheインテグレーションをインストールするには、以下の手順に従います。

インフラストラクチャエージェントをインストールし、 INTEGRATION_FILE_NAME変数をnri-varnishに置き換えます。
ディレクトリを統合フォルダに変更します。
```
cd /etc/newrelic-infra/integrations.d
```
サンプル構成ファイルのコピー：
```
sudo cp varnish-config.yml.sample varnish-config.yml
```
構成設定の説明に従って、 varnish-config.ymlファイルを編集します。

nri-varnish .MSIインストーラーイメージを以下からダウンロードします。
https://download.newrelic.com/infrastructure_agent/windows/integrations/nri-varnish/nri-varnish-amd64.msi
Windowsコマンドプロンプトからインストールするには、次のコマンドを実行します。
bash
```
$msiexec.exe /qn /i PATH\TO\nri-varnish-amd64.msi
```
IntegrationsディレクトリC:\Program Files\New Relic\newrelic-infra\integrations.d\で、次のコマンドを実行してサンプル構成ファイルのコピーを作成します。
bash
```
$copy varnish-config.yml.sample varnish-config.yml
```
構成設定の説明に従って、 varnish-config.ymlファイルを編集します。

その他の注意事項：

Advanced: tarball ファイルから統合をインストールすることもできます。これにより、インストールと設定のプロセスを完全に制御できるようになります。
On-host integrations do not automatically update. 最善の結果を得るため、インテグレーションパッケージの更新とInfrastructureエージェントの更新を定期的に実施してください。

このドキュメントはインストールの役に立ちましたか？

統合を構成する

統合のYAML形式の構成では、必要なログイン資格情報を配置し、データの収集方法を構成できます。どのオプションを変更するかは、セットアップと設定によって異なります。

構成ファイルには、 interval 、 timeout 、 inventory_sourceなどのすべての統合に適用できる共通の設定があります。これらの一般的な設定の詳細については、構成フォーマットのドキュメントを参照してください。

重要

従来の設定/定義ファイルを使用している場合は、こちらのドキュメントを参照してください。

Varnish に関連する特定の設定は、構成ファイルのenvセクションを使用して定義されます。これらの設定は、Varnish インスタンスへの接続、およびその他のセキュリティ設定と機能を制御します。有効な設定のリストについては、次のセクションで説明します。

Varnish Cacheインスタンスの設定

Varnish Cache インテグレーションは、メトリクス ( M ) 情報とインベントリ ( I ) 情報の両方を収集します。それぞれのコレクションに使用できる設定を確認するには、以下のApplies To列を確認してください。

設定	説明	デフォルト	に適用されます
INSTANCE_NAME	New Relic でこのインスタンスのデータを識別するためのユーザー定義の名前。 Required 。	該当なし	M / I
PARAMS_CONFIG_FILE	`varnish.params`構成ファイルの場所。この引数を省略すると、次の場所がチェックされます。 `/etc/default/varnish/varnish.params` `/etc/sysconfig/varnish/varnish.params` 注: Varnish 構成ファイルの場所と名前は異なる場合があります。詳細については、「Varnish 構成ファイルのさまざまな場所」を参照してください。Varnish 6 以降の場合、このパラメータは必須ではないため、統合はメトリクス収集のみを目的として設定する必要があります。ワニス 6 の例を参照してください。	該当なし	私
VARNISH_NAME	カスタム`-n`フラグを使用して`varnishd`デーモンを実行するときに使用される名前。 Optional .	該当なし	M
METRICS	メトリックのみの収集を有効にするには、 `true`に設定します。	`false`
INVENTORY	インベントリのみの収集を有効にするには、 `true`に設定します。	`false`

varnish-config.ymlコマンドは次の引数を受け入れます:

これらの設定の値は、いくつかの方法で定義できます。

設定ファイルに直接値を追加します。これが最も一般的な方法です。
{{}}表記を使用して環境変数の値を置き換えます。これには、インフラストラクチャエージェントv1.14.0以降が必要です。詳細はこちらをご覧ください。
シークレット管理を使用します。これを使用して、構成ファイルにプレーンテキストで公開されるパスワードなどの機密情報を保護します。詳細については、シークレット管理を参照してください。

ラベル/カスタム属性

環境変数は、などの構成設定を制御するために使用でき、その後、インフラストラクチャエージェントに渡されます。この機能の使用方法については、「インフラストラクチャエージェントの構成」を参照してください。ラベルを使用してメトリクスをさらに装飾することができます。ラベルを使用すると、メトリクスにキー値のペア属性を追加して、メトリクスのクエリ、フィルタリング、またはグループ化に使用できます。
デフォルトのサンプル設定ファイルにはラベルの例が含まれていますが、必須ではないため、必要に応じてラベルを削除、変更、または追加することができます。

labels:
   env: production
   role: varnish

構成例

varnish-config.ymlファイル構成の例:

これは、メトリクスとインベントリを収集するための非常に基本的な構成です。

integrations:
  - name: nri-varnish
    env:
      INSTANCE_NAME: new_relic
      PARAMS_CONFIG_FILE: /etc/default/varnish/varnish.params
    interval: 15s
    labels:
      env: production
      role: varnish
    inventory_source: config/varnish

これは、Varnish 6以上の基本的な設定です。Varnish 6からはparamsファイルが非推奨となったため、メトリクスのみが収集されます。

integrations:
  - name: nri-varnish
    env:
      INSTANCE_NAME: new_relic
      METRICS: true
    interval: 15s
    labels:
      env: production
      role: varnish
    inventory_source: config/varnish

オンホスト統合構成の一般的な構造の詳細については、「構成」を参照してください。

データを見つけて使用する

New Relicでインテグレーションデータを検索するには、one.newrelic.com > All capabilities > Infrastructure > Third-party services に移動し、Varnish Cache インテグレーションリンクの 1 つを選択します。

New Relic では、Varnish Cache のデータは以下のイベントタイプに添付されます。

VarnishSample
VarnishLockSample
VarnishStorageSample
VarnishMempoolSample
VarnishBackendSample

データを検索して使用する方法の詳細については、統合データについてを参照してください。

メトリックデータ

Varnish Cache 統合は、次のメトリックデータ属性を収集します。各メトリック名には、 bans.やmain.などのカテゴリインジケータとピリオドがプレフィックスとして付けられます。

ヒント

いくつかのメトリクスは、メトリクス名から想像されるように、合計ではなくレート（1秒あたり）として計算されます。どのメトリクスがレートとして計算されるかの詳細については、 spec.csvファイルを参照してください。.

Varnishのサンプルメトリクス

これらの属性は、VarnishSampleのイベントタイプを照会することで見つけることができます。

メトリック	説明
`backend.connectionBusy`	最大接続数に達した回数。
`backend.connectionFails`	バックドへの接続に失敗した数。
`backend.connectionRecycles`	リサイクルされたバックエンドコネクションの数。
`backend.connectionRetries`	再試行されたバックエンド接続の数。
`backend.connectionReuses`	バックエンド接続の再利用数
`backend.connectionSuccess`	バックエンドとの接続に成功した数。
`backend.connectionUnHealthy`	バックエンドの状態が「不健全」であったために試行されなかったバックエンド接続の数。
`backend.fetches`	開始されたバックエンドのフェッチの合計数。
`backend.requests`	バックエンドへの接続リクエストの総数。
`bans.added`	BANリストに追加されたBANのカウンター
`bans.completed`	完了」と表示された禁止事項の数
`bans.cutoffLurkerKilled`	カットオフ（ルーラー）の禁止によって殺されたオブジェクトの数。
`bans.deleted`	BANリストから削除されたBANのカウンター
`bans.dups`	後の同一バンに置き換えられたバンの数。
`bans.fragmentationInBytes`	永続化された禁止リストが断片化されているため、余分なバイトが発生する。
`bans.lookupKilled`	オブジェクトの検索中に禁止令によって殺されたオブジェクトの数。
`bans.lookupTestsTested`	ルックアップ時にテストとオブジェクトが相互にテストされた数をカウントします。
`bans.lurkerCon`	バンラーカーがルックアップを待たされた回数。
`bans.lurkerKilled`	バンラーカーに殺されたオブジェクトの数。
`bans.lurkerTested`	BAN-LURKERがどれだけBANとオブジェクトをテストしたかのカウント。
`bans.lurkerTestsTested`	BAN-LURKERが実施したテストやオブジェクトの数をカウントします。
`bans.obj`	`obj.*`変数を使用した禁止の数。これらの禁止は、禁止に潜む者によって洗い流される可能性があります。
`bans.persistedInBytes`	永続化された禁止リストが使用するバイト数。
`bans.req`	`req.*`変数を使用する禁止の数。これらのバンは、バンラーカーによって洗浄することはできません。
`bans.tested`	ハッシュ検索の際に、いくつの禁止事項とオブジェクトが互いにテストされたかのカウント。
`cache.graceHits`	猶予のあるキャッシュヒットの数。猶予のあるキャッシュヒットは、オブジェクトの有効期限が切れているキャッシュヒットです。これらのヒットは`cache_hit`カウンターにも含まれています。
`cache.hits`	バックエンドサーバーからオブジェクトを取得せずに、クライアントに配信した回数。
`cache.misses`	クライアントに配信する前に、バックエンドからオブジェクトをフェッチした回数。
`cache.missHits`	ミス・レスポンスに対してヒット・オブジェクトが返された回数。
`cache.passHits`	パス・レスポンスでヒット・オブジェクトが返された回数。
`esi.errors`	ESI（Edge Side Includes）の解析エラー（ロック解除）。
`esi.warnings`	Edge Side Includes（ESI）のパース警告（ロック解除）を行います。
`fetch.bad`	`beresp.body`の長さ/フェッチを特定できませんでした。
`fetch.chuncked`	`beresp.body`のチャンク。
`fetch.contentLength`	content-length の`beresp.body` 。
`fetch.eof`	EOF 付きの`beresp.body` 。
`fetch.failed`	`beresp`が失敗しました。
`fetch.head`	リクエストが HEAD であるため、本文のない`beresp` 。
`fetch.noBody`	本体のない`beresp` 。
`fetch.noBody1xx`	1XX 応答のため、本体のない`beresp` 。
`fetch.noBody204`	204 応答のため、本文のない`beresp` 。
`fetch.noBody304`	304 応答のため、本体のない`beresp` 。
`fetch.noThreadFail`	`beresp`のフェッチに失敗しました。利用可能なスレッドがありません。
`hcb.inserts`	クリティカル・ビット・ツリー・ベースド・ハッシュ（HCB）の挿入数。
`hcb.lock`	ロック付きHCBルックアップの数
`hcb.noLock`	ロックのないHCBルックアップの数
`lru.limited`	より多くのストレージスペースが必要だったが、制限に達した回数。
`lru.moved`	LRUリストで行われた移動操作の数。
`lru.nuked`	新しいオブジェクトのためのスペースを確保するために、ストレージから強制的に退避させられたLRU（Lest Recently Used）オブジェクトの数。
`main.backends`	バックエンドの数
`main.bans`	禁止事項の数
`main.busyKilled`	ビジー状態のobjhdrでスリープ後にキルされたリクエストの数。
`main.busySleep`	忙しいobjhdrのスリープに送られたリクエストの数。
`main.busyWakeup`	ビジー状態のobjhdrでスリープ後に起こされたリクエストの数。
`main.expired`	期限切れのオブジェクトの数。
`main.expiredMailed`	期限切れのスレッドにメールされたオブジェクトの数。
`main.expiredReceived`	expiryスレッドが受信したオブジェクトの数。
`main.gunzip`	gunzipの操作回数。
`main.gunzipTest`	テスト用 gunzip 操作の回数。
`main.gzip`	gzip操作の回数。
`main.objectcores`	作られたobjectcore構造体の数。
`main.objectheads`	オブジェクト化された構造体の作成数
`main.objects`	作られたオブジェクト構造体の数
`main.passedRequests`	見られたパス・レッド・リクエストの総数
`main.pipeSessions`	見られたパイプセッションの総数
`main.pools`	スレッドプールの数。
`main.purgeObjects`	パージされたオブジェクトの数。
`main.purgeOperations`	実行されたパージ操作の数。
`main.reqDropped`	ドロップしたリクエストの数
`main.sessions`	見たセッションの総数
`main.sessQueueLength`	スレッドを待つセッションキューの長さ。
`main.summs`	スレッドごとの統計値がグローバルカウンタに合計された回数。
`main.syntheticResponses`	行われたシンセティックな回答の合計。
`main.threads`	スレッドの総数です。
`main.threadsCreated`	すべてのプールで作成されたスレッドの合計数。
`main.threadsDestroyed`	全プールで破壊されたスレッドの合計数。
`main.threadsFailed`	スレッドの作成に失敗した回数。
`main.threadsLimited`	より多くのスレッドが必要だったが、スレッドプールの制限に達した回数。
`main.unresurrectedObjects`	復活していないオブジェクトの数
`main.uptimeInMilliseconds`	子プロセスの稼働時間をミリ秒単位で表します。
`main.vclAvailable`	利用可能なVarnish Configuration Languages (VCL)の数。
`main.vclDiscarded`	廃棄されたVCLの数。
`main.vclFails`	VCLの故障数。
`main.vclLoaded`	ロードされたVCLの合計数
`main.vmodsLoaded`	ロードされたVarnishモジュールの数（VMOD）。
`mgt.childDied`	子プロセスがシグナルにより死亡した回数。
`mgt.childDump`	子プロセスがコア・ダンプを生成した回数。
`mgt.childExit`	子プロセスがクリーンに停止した回数。
`mgt.childPanic`	管理プロセスが子供のパニックを捉えた回数。
`mgt.childStart`	子プロセスが開始された回数。
`mgt.childStop`	子プロセスがクリーンに停止した回数。
`mgt.uptimeInMilliseconds`	管理プロセスの稼働時間（単位：ミリ秒）。
`net.400Errors`	受信したクライアントのリクエスト数（400エラーを含む）。
`net.417Errors`	受信したクライアント・リクエストの数（417件のエラーを含む
`net.httpOverflow`	HTTPヘッダーのオーバーフローの数。
`net.pipe.inInBytes`	パイプセッションでクライアントから転送された総バイト数。
`net.pipe.outInBytes`	パイプセッションでクライアントに転送された総バイト数。
`net.pipereq.headerInBytes`	パイピングされたセッションで受信したリクエストの総バイト数
`net.request.bodyInBytes`	送信されたリクエスト・ボディの総量（単位：バイト）。
`net.request.headerInBytes`	送信されたリクエストヘッダーの合計（バイト）。
`net.requests`	受信したグッド・クライアント・リクエストの数
`net.response.bodyInBytes`	送信されたレスポンスボディの合計（単位：バイト）。
`net.response.headerInBytes`	送信されたレスポンスヘッダーの合計（バイト）。
`sess.backendClose`	エラー`RESP_CLOSE`で終了したセッションの数 (バックエンド/VCL が終了を要求)。
`sess.badClose`	エラー`Error RX_BAD`で終了したセッションの数 (不正な要求/応答を受け取りました)。
`sess.bodyFailClose`	エラー`Error RX_BODY` (req.body の受信に失敗) で終了したセッションの数。
`sess.clientClose`	エラー`REM_CLOSE`で閉じられたセッションの数 (クライアントが閉じられました)。
`sess.clientReqClose`	エラー`REQ_CLOSE`で終了したセッションの数 (クライアントが終了を要求しました)。
`sess.closed`	閉鎖されたセッションの総数
`sess.closedError`	エラーで終了したセッションの合計数
`sess.dropped`	スレッドでドロップされたセッションの数
`sess.eofTxnClose`	エラー`TX_EOF` (EOF 送信) で閉じられたセッションの数。
`sess.errorTxnClose`	エラー`TX_ERROR` (エラートランザクション) で終了したセッションの数。
`sess.herd`	`timeout_linger`がトリガーされた回数。
`sess.junkClose`	エラー`RX_JUNK`で終了したセッションの数 (ジャンクデータを受信しました)。
`sess.overflowClose`	エラー`RX_OVERFLOW` (受信バッファオーバーフロー) で終了したセッションの数。
`sess.overloadClose`	エラー`OVERLOAD`で終了したセッションの数 (一部のリソースが不足しています)。
`sess.pipeOverflowClose`	エラー`PIPE_OVERFLOW` (セッションパイプオーバーフロー) で終了したセッションの数。
`sess.pipeTxnClose`	エラー`TX_PIPE`で終了したセッションの数 (パイプ処理されたトランザクション)。
`sess.queued`	スレッドにキューイングされているセッションの数。
`sess.readAhead`	Session Read Ahead。
`sess.requestHTTP10Close`	エラー`REQ_HTTP10`で終了したセッションの数 (Proto < HTTP/1.1)。
`sess.requestHTTP20Close`	エラー`REQ_HTTP20`で終了したセッションの数 (HTTP2 は受け入れられません)。
`sess.shortRangeClose`	エラー`RANGE_SHORT` (範囲のデータが不十分) で閉じられたセッションの数。
`sess.timeoutClose`	エラー`RX_TIMEOUT` (受信タイムアウト) で終了したセッションの数。
`sess.vclFailClose`	エラー`VCL_FAILURE` (VCL 障害) で終了したセッションの数。
`session.connections`	受け付けに成功したセッションの数
`session.drops`	ワーカースレッドが不足しているために静かにドロップしたセッションの数。
`session.fail`	TCP接続の受け入れに失敗した回数。
`shm.contentions`	共有メモリ(SHM)のMTXのコンテンションの数。
`shm.cycles`	バッファを通過したSHMサイクルの数
`shm.flushes`	オーバーフローによるSHMフラッシュの回数。
`shm.records`	SHMレコードの数
`shm.writes`	SHMの書込み回数
`workspace.backendOverflow`	`workspace_backend`のスペースがなくなった回数。
`workspace.clientOverflow`	`workspace_client`のスペースがなくなった回数。
`workspace.deliveryFail`	ワークスペースが不足しているため、配信に失敗しました。
`workspace.sessionOverflow`	`workspace_session`のスペースがなくなった回数。
`workspace.threadOverflow`	`workspace_thread`のスペースがなくなった回数。

Varnishロックのサンプルメトリクス

これらの属性は、 VarnishLockSampleイベントタイプを照会することで見つけることができます。

メトリック	説明
`lock.created`	作成されたロックの数。
`lock.destroyed`	破壊されたロックの数
`lock.locks`	ロック操作の回数。

Varnishストレージのサンプルメトリクス

これらの属性は、 VarnishStorageSampleイベントタイプを照会することで見つけることができます。

メトリック	説明
`storage.allocFails`	ストレージがストレージセグメントの提供に失敗した回数。
`storage.allocInBytes`	このストレージで割り当てられた総バイト数。
`storage.allocOustanding`	ストレージ割り当ての未処理数。
`storage.allocReqs`	ストレージが、ストレージセグメントの提供を求められた回数。
`storage.availableInBytes`	ストレージに残っているバイト数。
`storage.freeInBytes`	このストレージに戻ってきた総バイト数
`storage.outstandingInBytes`	ストレージから割り当てられたバイト数。

Varnish mempool サンプルメトリクス

これらの属性は、 VarnishMempoolSampleイベントタイプを照会することで見つけることができます。

メトリック	説明
`mempool.allocatedSizeInBytes`	メモリプールの割り当てサイズ（単位：バイト）。
`mempool.allocs`	メモリプールの割り当てを行います。
`mempool.frees`	メモリプールの空き数。
`mempool.live`	使用中のメモリプールの数。
`mempool.pool`	メモリプールのカウント
`mempool.ranDry`	プールが干上がった。
`mempool.recycles`	プールからの再利用
`mempool.requestSizeInBytes`	メモリプールの要求サイズ（単位：バイト）。
`mempool.surplus`	プールには多すぎます。
`mempool.timeouts`	プールからタイムアウト。
`mempool.tooSmall`	リサイクルするには小さすぎる。

Varnishバックエンドのサンプルメトリクス

これらの属性は、 VarnishBackendSampleイベントタイプを照会することで見つけることができます。

メトリック	説明
`backend.busyFetches`	バックエンドがビジー状態のため、取り込みができませんでした。
`backend.connections`	バックエンドへの同時接続数。
`backend.connectionsFailed`	失敗したバックエンド接続の数
`backend.connectionsNotAttempted`	試されなかったバックエンド接続オープンの数。
`backend.happy`	幸せな健康診断
`backend.unhealtyFetches`	バックエンドが健全でないため、取り込みが行われない
`net.backend.pipeHeaderInBytes`	パイピングされたセッションで送信された総リクエストバイト数です。
`net.backend.pipeInInBytes`	パイプセッションでバックエンドから転送された総バイト数。
`net.backend.pipeOutInBytes`	パイプセッションでバックエンドに転送された総バイト数。
`net.backend.requestBodyInBytes`	送信されたバックエンドのリクエストボディの総バイト数。
`net.backend.requestHeaderInBytes`	送信されたバックエンドリクエストヘッダの総バイト数。
`net.backend.requests`	送信されたバックエンドリクエストの数。
`net.backend.responseBodyInBytes`	受信したバックエンドのレスポンスボディの総バイト数。
`net.backend.responseHeaderInBytes`	受信したバックエンドのレスポンスヘッダの総バイト数。

在庫データ

Varnish Cache 統合は、構成パラメーターをキャプチャします。アクティブなすべてのパラメーターについてvarnish.params構成ファイルを解析します。

データは、 config/varnishソースの下にあるインベントリページで入手できます。インベントリデータの詳細については、「インベントリデータを理解する」を参照してください。

ソースコードを確認してください

この統合はオープンソースソフトウェアです。つまり、ソースコードを参照して改善を送信したり、独自のフォークを作成してビルドしたりできます。

この機械翻訳は、参考として提供されています。

Varnish Cacheのモニタリング統合

互換性と要件

クイックスタート

インストールしてアクティブ化する

Linuxのインストール

Windowsのインストール

このドキュメントはインストールの役に立ちましたか？

統合を構成する

重要

Varnish Cacheインスタンスの設定

ラベル/カスタム属性

構成例

構成例

Varnish 6+の設定

データを見つけて使用する

メトリックデータ

ヒント

Varnishのサンプルメトリクス

Varnishロックのサンプルメトリクス

Varnishストレージのサンプルメトリクス

Varnish mempool サンプルメトリクス

Varnishバックエンドのサンプルメトリクス

在庫データ

ソースコードを確認してください

この機械翻訳は、参考として提供されています。

Varnish Cacheのモニタリング統合

互換性と要件 .css-21sua1{background:none;border:none;width:0;padding:0;}

クイックスタート

インストールしてアクティブ化する

Windowsのインストール

このドキュメントはインストールの役に立ちましたか？

統合を構成する

重要

Varnish Cacheインスタンスの設定

ラベル/カスタム属性

構成例

構成例

Varnish 6+の設定

データを見つけて使用する

メトリックデータ

ヒント

Varnishのサンプルメトリクス

Varnishロックのサンプルメトリクス

Varnishストレージのサンプルメトリクス

Varnish mempool サンプルメトリクス

Varnishバックエンドのサンプルメトリクス

在庫データ

ソースコードを確認してください

互換性と要件