HashiCorp領事館の監視統合

HashiCorp Consulオンホストインテグレーションは、 Consul データセンター環境からインベントリとメトリックを収集してNew Relicに送信し、そこで環境の健全性を確認できます。データセンターレベルとエージェント/ノードレベルの両方でデータを収集します。

ヒント

HashiCorp Cloud Platform Consul 統合もあることに注意してください。

互換性と要件

インストレーション前に、以下の要件を満たしていることを確認してください。

私たちの統合は HashiCorp Consul 1.0 以降と互換性があります。
ACL を使用している場合、Consul 統合の認証情報にはポリシーagent:read 、 node:read 、およびservice:readが必要です。

クイックスタート

Consul 環境を迅速に計測し、ガイド付きインストールでテレメトリデータを送信します。ガイド付きインストールでは、インフラストラクチャエージェントと CLI を使用して HashiCorp 統合をセットアップし、環境内で実行されている他のアプリケーションとログソースを検出して、どのアプリケーションを計測する必要があるかを推奨します。

ガイド付きインストールは、ほとんどの設定と連動します。ただし、ご希望に添えない場合は、以下の他のインストールオプションがあります。

始める準備はできていますか？使用するデータセンターの地域に応じて、該当するボタンをクリックします。インストールが完了したら、本ドキュメントに戻って設定オプションを確認してください。

ガイド付きインストール（米国オプション）

ガイド付きインストール（EUオプション）

インストール

HashiCorp Consul統合をインストールするには、ご使用の環境の指示に従ってください。

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

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

統合を更新する

このインテグレーションは、自動更新しません。最善の結果を得るため、インテグレーションパッケージの更新とInfrastructureエージェントの更新を定期的に実施してください。

インストール後のタスク

インストールが完了したら、設定オプションを設定できます。インテグレーションを機能させるには、設定がいくつか必要ですが、オプションの設定もあります。

統合を構成する

ECSまたはKubernetesインテグレーションからこのインテグレーションを有効にした場合は、以下のドキュメントを参照してください。

標準オンホストインストールの場合、このインテグレーションにはYAML設定ファイル、apache-config.ymlが付属しています。この設定では、必要なログインクレデンシャルやデータの収集方法を設定できます。どのオプションを変更するかは、設定とプリファレンスにより異なります。コピーおよび編集できるサンプル設定ファイルapache-config.yml.sampleが付属しています。

Consul に関連する特定の設定は、構成ファイルのenvセクションを使用して定義されます。これらの設定は、Consul インスタンスへの接続だけでなく、他のセキュリティ設定や機能も制御します。

重要

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

Consul 構成オプション

Consul の統合は、メトリクスとインベントリ情報の両方を収集します。この表は、各構成オプションの適用対象を示しています。

'' '' '' '' '' '' '' '' '' '' ''

設定	説明	デフォルト	に適用されます
HOSTNAME	Consulが実行されているホスト名またはIP。	ローカルホスト	M / I
PORT	領事が聞いている港。	8500	M / I
TOKEN	トークン認証が有効になっている場合はACLトークン。	該当なし	M / I
ENABLE_SSL	SSLを使用して接続します。	false	M / I
CA_BUNDLE_FILE	代替認証局バンドルファイル。	該当なし	M / I
CA_BUNDLE_DIR	代替認証局バンドルディレクトリ。	該当なし	M / I
TRUST_SERVER_CERTIFICATE	trueに設定すると、サーバー証明書はSSLに対して検証されません。	false	M / I
FAN_OUT	trueの場合、Consulクラスター内の他のすべてのノードからメトリックを収集しようとします。	true	M
CHECK_LEADERSHIP	領事サーバーのリーダーシップを確認してください。これは、クライアントモードの領事で無効にする必要があります。	true	M
TIMEOUT	各領事クライアントの呼び出しのタイムアウト。	30代	M / I
METRICS	メトリックのみの収集を有効にするには、 `true`に設定します。	false
INVENTORY	インベントリのみの収集を有効にするには、 `true`に設定します。	false

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

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

ラベル

さらに、メトリクスにラベルを付けることもできます。ラベルを使用すると、属性（キーや値のペア）をメトリクスに追加して、メトリクスのクエリを挙げ、フィルターをかけ、グループ化を行うことができます。

デフォルトのサンプル設定ファイルにはラベルの例が含まれていますが、必須ではないため、選択したラベルを削除、変更、お好きな設定を新規追加することができます。

labels:
   env: production
   role: load_balancer

構成例

これは、ローカルホストからメトリックとインベントリを収集するために使用される基本構成です。

integrations:
  - name: nri-consul
    env:
      HOSTNAME: localhost
      PORT: 8500
    interval: 15s
    labels:
      environment: production
    inventory_source: config/consul

この構成では、タイムアウトを使用して30秒ごとにメトリックを収集し、60秒ごとにインベントリを収集します。

integrations:
  - name: nri-consul
    env:
      METRICS: true
      HOSTNAME: localhost
      PORT: 8500
      TIMEOUT: 10s
    interval: 15s
    labels:
      environment: production

  - name: nri-consul
    env:
      INVENTORY: true
      HOSTNAME: localhost
      PORT: 8500
      TIMEOUT: 10s
    interval: 60s
    labels:
      environment: production
    inventory_source: config/consul

この構成では、環境変数CONSUL_HOSTを使用して、統合のHOSTNAME設定を設定しています。

integrations:
  - name: nri-consul
    env:
      METRICS: "true"
      HOSTNAME: {{CONSUL_HOST}}
      PORT: 8500
    interval: 15s
    labels:
      env: production
      role: load_balancer

この構成では、ACLトークンを使用して接続し、接続されている他の領事ノードからメトリックを収集していません（FAN_OUT：false）：

integrations:
  - name: nri-consul
    env:
      METRICS: "true"
      HOSTNAME: localhost
      PORT: 8500
      TOKEN: my_token
      FAN_OUT: false
    interval: 15s
    labels:
      env: production
      role: load_balancer

この構成では、同じ統合から複数のConsulサーバーを監視しています。最初のインスタンス（ HOSTNAME: 1st_consul_host ）の場合はメトリックとインベントリを収集し、2番目のインスタンス（ HOSTNAME: 2nd_consul_host ）の場合はメトリックのみを収集します。

integrations:
  - name: nri-consul
    env:
      METRICS: "true"
      HOSTNAME: 1st_consul_host
      PORT: 8500
    interval: 15s
    labels:
      env: production
      role: load_balancer
  - name: nri-consul
    env:
      INVENTORY: "true"
      HOSTNAME: 1st_consul_host
      PORT: 8500
    interval: 60s
    labels:
      env: production
      role: load_balancer
    inventory_source: config/consul

  - name: nri-consul
    env:
      METRICS: "true"
      HOSTNAME: 2nd_consul_host
      PORT: 8500
    interval: 15s
    labels:
      env: production
      role: load_balancer

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

この統合からのデータは、 one.newrelic.com > Infrastructure > Third-party services > Apacheにアクセスすると見つかります。

Apache データは、 ConsulDatacenterSampleおよびConsulAgentSampleイベントタイプに関連付けられます。トラブルシューティングの目的でこのデータをクエリしたり、カスタムグラフやダッシュボードを作成したりできます。

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

メトリックデータ

HashiCorp Consul 統合は、次のメトリックデータ属性を収集します。

Consul データセンターサンプルメトリックス

これらの属性は、 ConsulDatacenterSampleイベントタイプに関連付けられています。

メトリック	説明
`consul.catalog.nodes_critical`	登録されているノードのうち、サービスステータスが`critical`のノードの数。
`consul.catalog.nodes_passing`	登録されているノードのうち、サービスステータスが`passing`のノードの数。
`consul.catalog.nodes_up`	ノードの数。
`consul.catalog.nodes_warning`	登録されているノードのうち、サービスステータスが`warning`のノードの数。
`consul.catalog.total_nodes`	領事クラスターに登録されているノードの数。
`consul.memberlist.msg.suspect`	ゴシッププロトコル中にプローブしているときに、エージェントが別のエージェントを失敗したと疑う回数。
`consul.raft.apply`	発生したラフトトランザクションの数。
`consul.raft.commitTime.avg`	リーダーのいかだログに新しいエントリをコミットするのにかかる平均時間。
`consul.raft.commitTime.count`	`raft.commitTime`のサンプル数。
`consul.raft.commitTime.max`	リーダーのいかだログに新しいエントリをコミットするのにかかる最大時間。
`consul.raft.commitTime.median`	リーダーのいかだログに新しいエントリをコミットするのにかかる時間の中央値。
`consul.raft.leader.dispatchLog.avg`	リーダーがログエントリをディスクに書き込むのにかかる平均時間。
`consul.raft.leader.dispatchLog.count`	`raft.leader.dispatchLog`のサンプル数。
`consul.raft.leader.dispatchLog.max`	リーダーがログエントリをディスクに書き込むのにかかる最大時間。
`consul.raft.leader.dispatchLog.median`	リーダーがログエントリをディスクに書き込むのにかかる時間の中央値。
`consul.raft.leader.lastContact.avg`	リーダーがフォロワーとのリースを最後に確認できてからの平均経過時間。
`consul.raft.leader.lastContact.count`	`raft.leader.lastContact`のサンプル数。
`consul.raft.leader.lastContact.max`	リーダーがフォロワーとのリースを最後に確認できてからの最大経過時間。
`consul.raft.leader.lastContact.median`	リーダーがフォロワーとのリースを最後に確認できてから経過した時間の中央値。
`consul.raft.state.candidate`	開始されたリーダー選挙の数。
`consul.raft.state.leader`	完了したリーダー選挙の数。
`consul.serf.member.flap`	エージェントがデッドとマークされてからすぐに回復する回数。

領事代理人のサンプル指標

これらの属性は、 ConsulAgentSampleイベントタイプに関連付けられています。

メトリック	説明
`agent.aclCacheHit`	ACLキャッシュがヒットします。
`agent.aclCacheMiss`	ACLキャッシュがありません。
`agent.kvStores`	`kvs.apply`のサンプル数。
`agent.kvStoresAvgInMilliseconds`	KVストアの更新を完了するのにかかる平均時間。
`agent.kvStoresMaxInMilliseconds`	KVストアの更新を完了するのにかかる最大時間。
`agent.kvStoresMedianInMilliseconds`	KVストアの更新を完了するのにかかる時間の中央値。
`agent.peers`	ピアセット内のピアの数。
`agent.staleQueries`	許可された失効しきい値内で提供されたクエリ。
`agent.txnAvgInMilliseconds`	トランザクション操作の適用にかかる平均時間。
`agent.txnMaxInMilliseconds`	トランザクション操作の適用にかかる最大時間。
`agent.txnMedianInMilliseconds`	トランザクション操作の適用にかかる時間の中央値。
`agent.txns`	`txn.apply`のサンプル数。
`client.rpcFailed`	失敗したRPC要求の測定。
`client.rpcLoad`	エージェントがConsulサーバーにロードしている量の測定。
`client.rpcRateLimited`	レートが制限されるRPCリクエストの測定。
`net.agent.maxLatencyInMilliseconds`	このノードから他のすべてのノードまでの最大遅延。
`net.agent.medianLatencyInMilliseconds`	このノードから他のすべてのノードまでの遅延の中央値。
`net.agent.minLatencyInMilliseconds`	このノードから他のすべてのノードまでの最小遅延。
`net.agent.p25LatencyInMilliseconds`	このノードから他のすべてのノードへのP25遅延。
`net.agent.p75LatencyInMilliseconds`	このノードから他のすべてのノードへのP75遅延。
`net.agent.p90LatencyInMilliseconds`	このノードから他のすべてのノードへのP90遅延。
`net.agent.p95LatencyInMilliseconds`	このノードから他のすべてのノードへのP95遅延。
`net.agent.p99LatencyInMilliseconds`	このノードから他のすべてのノードへのP99レイテンシ。
`runtime.allocations`	割り当てられたヒープオブジェクトの累積数。
`runtime.allocationsInBytes`	領事プロセスによって割り当てられた現在のバイト。
`runtime.frees`	解放されたヒープオブジェクトの累積数。
`runtime.gcCycles`	完了したGCサイクルの数。
`runtime.gcPauseInMilliseconds`	領事が開始してから、GCの累積ナノ秒は世界を停止します。
`runtime.goroutines`	実行中のgoルーチンの数。
`runtime.heapObjects`	ヒープに割り当てられたオブジェクトの数
`runtime.virtualAddressSpaceInBytes`	goランタイムによって予約された仮想アドレス空間の合計サイズ。

在庫データ

HashiCorp Consul統合は、ConsulAgentノードの構成パラメーターと現在の設定をキャプチャします。/v1/agent/self RESTAPIエンドポイントの結果を収集します。その応答から{ Config }セクションとDebugConfigセクションを引き出します。

ヒント

Note: ConfigとDebugConfig内のネストされたセクションは収集されません。

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

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

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

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

ヒント

互換性と要件

クイックスタート

インストール

ECS

Kubernetes

Linux

ウィンドウズ

統合を更新する

インストール後のタスク

統合を構成する

重要

Consul 構成オプション

ラベル

構成例

基本構成

メトリック/在庫間隔が異なる基本構成

環境変数の置換

指標-トークンのみでファンアウトなし

マルチインスタンスモニタリング

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

メトリックデータ

Consul データセンターサンプルメトリックス

領事代理人のサンプル指標

在庫データ

ヒント

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

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

HashiCorp領事館の監視統合

ヒント

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

クイックスタート

インストール

Kubernetes

Linux

ウィンドウズ

統合を更新する

インストール後のタスク

統合を構成する

重要

Consul 構成オプション

ラベル

構成例

基本構成

メトリック/在庫間隔が異なる基本構成

環境変数の置換

指標-トークンのみでファンアウトなし

マルチインスタンスモニタリング

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

メトリックデータ

Consul データセンター サンプル メトリックス

領事代理人のサンプル指標

在庫データ

ヒント

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

互換性と要件

Consul データセンターサンプルメトリックス