当社の HashiCorp Consul オンホスト統合は、 Consul データセンター環境からインベントリとメトリクスを収集して New Relic に送信し、そこで環境の健全性を確認できます。データセンターとエージェント/ノード レベルの両方でデータを収集します。
ヒント
Hashicorp Cloud Platform Consul 統合もあることに注意してください。
統合をインストールし、収集するデータを確認するために読んでください。
互換性と要件
私たちの統合は、HashiCorpConsul1.0以降と互換性があります。
統合をインストールする前に、次の要件を満たしていることを確認してください。
ConsulがKubernetesまたはAmazonECSで実行されていない場合は、Consulを実行しているホストにインフラストラクチャエージェントをインストールする必要があります。さもないと:
ACLを使用する場合、領事館統合の資格情報には、
agent:read
、node:read
、およびservice:read
のポリシーが必要です。
クイックスタート
領事館の環境をすばやく計測し、ガイド付きインストールでテレメトリデータを送信します。ガイド付きインストールでは、環境に合わせてカスタマイズされたCLIコマンドを作成し、NewRelicCLIとインフラストラクチャエージェントをダウンロードしてインストールします。
始める準備はできましたか?これらのボタンのいずれかをクリックして試してください。
ガイド付きインストールでは、インフラストラクチャエージェントを使用してHashiCorpConsul統合をセットアップします。それだけでなく、環境で実行されている他のアプリケーションとログソースを検出し、どのアプリケーションをインストルメントする必要があるかを推奨します。
ガイド付きインストールは、ほとんどのセットアップで機能します。ただし、ニーズに合わない場合は、領事館環境の監視を開始するために、以下の他の方法を見つけることができます。
インストールしてアクティブ化する
HashiCorp Consul統合をインストールするには、ご使用の環境の指示に従ってください。
''
その他の注意事項:
- 高度:統合はtarball形式でも利用可能であり、パッケージマネージャーの外部にインストールできます。
- オンホスト統合は自動的に更新されません。最良の結果を得るには、統合パッケージとインフラストラクチャエージェントを定期的に更新してください。
このドキュメントはインストールで役立ちましたか。
構成
統合を構成する
インストール方法に応じて、統合を構成する方法はいくつかあります。
- Kubernetes経由で有効になっている場合: Kubernetesで実行されているサービスの監視をご覧ください。
- Amazon ECSを介して有効になっている場合: ECSで実行されている監視サービスを参照してください。
- ホストにインストールされている場合:統合のYAML構成ファイル
consul-config.yml
の構成を編集します。
統合のYAML形式の構成では、必要なログイン資格情報を配置し、データの収集方法を構成できます。どのオプションを変更するかは、セットアップと設定によって異なります。
構成ファイルには、 interval
、 timeout
、 inventory_source
などのすべての統合に適用できる共通の設定があります。これらの一般的な設定についてすべて読むには、 構成フォーマットのドキュメントを参照してください。
重要
従来の構成/定義ファイルをまだ使用している場合は、このドキュメントを参照してください。
領事に関連する特定の設定は、構成ファイルのenv
セクションを使用して定義されます。これらの設定は、Consulインスタンスへの接続、およびその他のセキュリティ設定と機能を制御します。有効な設定のリストについては、このドキュメントの次のセクションで説明します。
領事インスタンスの設定
領事館の統合により、メトリック( M )とインベントリ( I )の両方の情報が収集されます。表で、各コレクションで使用可能な設定の[適用先]列を使用します。
'' '' '' '' '' '' '' '' '' '' ''
設定 | 説明 | デフォルト | に適用されます |
---|---|---|---|
ホスト名 | Consulが実行されているホスト名またはIP。 | ローカルホスト | M / I |
ポート | 領事が聞いている港。 | 8500 | M / I |
トークン | トークン認証が有効になっている場合は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 |
扇形に広がります | trueの場合、Consulクラスター内の他のすべてのノードからメトリックを収集しようとします。 | true | M |
CHECK_LEADERSHIP | 領事サーバーのリーダーシップを確認してください。これは、クライアントモードの領事で無効にする必要があります。 | true | M |
タイムアウト | 各領事クライアントの呼び出しのタイムアウト。 | 30代 | M / I |
METRICS | メトリックのみの収集を有効にするには、 | false | |
在庫 | インベントリのみの収集を有効にするには、 | false |
これらの設定の値は、いくつかの方法で定義できます。
- 設定ファイルに直接値を追加します。これが最も一般的な方法です。
{{}}
表記を使用して環境変数の値を置き換えます。これには、インフラストラクチャエージェントv1.14.0以降が必要です。詳細については、 こちらをご覧になるか、以下の例をご覧ください。- シークレット管理を使用します。これを使用して、構成ファイルにプレーンテキストで公開されるパスワードなどの機密情報を保護します。詳細については、シークレット管理を参照してください。
ラベル/カスタム属性
ラベルを使用して、メトリックをさらに装飾できます。ラベルを使用すると、キーと値のペアの属性をメトリックに追加できます。これを使用して、メトリックをクエリ、フィルタリング、またはグループ化できます。
デフォルトのサンプル構成ファイルには、ラベルの例が含まれています。ただし、必須ではないため、選択した新しいものを削除、変更、または追加できます。
labels: env: production role: load_balancer
構成例
データを見つけて使用する
このサービスからのデータは、 統合ダッシュボードに報告されます。
メトリックは、これらのイベントタイプに関連付けられています。
ConsulDatacenterSample
ConsulAgentSample
トラブルシューティングの目的で、またはカスタムチャートとダッシュボードを作成するために、このデータをクエリできます。
データを検索して使用する方法の詳細については、統合データについてを参照してください。
メトリックデータ
HashiCorp Consul統合は、次のメトリックデータ属性を収集します。
データセンターのサンプルメトリクスを領事
これらの属性は、 ConsulDatacenterSample
イベントタイプに関連付けられています。
メトリック | 説明 |
---|---|
| 登録されているノードのうち、サービスステータスが |
| 登録されているノードのうち、サービスステータスが |
| ノードの数。 |
| 登録されているノードのうち、サービスステータスが |
| 領事クラスターに登録されているノードの数。 |
| ゴシッププロトコル中にプローブしているときに、エージェントが別のエージェントを失敗したと疑う回数。 |
| 発生したラフトトランザクションの数。 |
| リーダーのいかだログに新しいエントリをコミットするのにかかる平均時間。 |
|
|
| リーダーのいかだログに新しいエントリをコミットするのにかかる最大時間。 |
| リーダーのいかだログに新しいエントリをコミットするのにかかる時間の中央値。 |
| リーダーがログエントリをディスクに書き込むのにかかる平均時間。 |
|
|
| リーダーがログエントリをディスクに書き込むのにかかる最大時間。 |
| リーダーがログエントリをディスクに書き込むのにかかる時間の中央値。 |
| リーダーがフォロワーとのリースを最後に確認できてからの平均経過時間。 |
|
|
| リーダーがフォロワーとのリースを最後に確認できてからの最大経過時間。 |
| リーダーがフォロワーとのリースを最後に確認できてから経過した時間の中央値。 |
| 開始されたリーダー選挙の数。 |
| 完了したリーダー選挙の数。 |
| エージェントがデッドとマークされてからすぐに回復する回数。 |
領事代理人のサンプル指標
これらの属性は、 ConsulAgentSample
イベントタイプに関連付けられています。
メトリック | 説明 |
---|---|
| ACLキャッシュがヒットします。 |
| ACLキャッシュがありません。 |
|
|
| KVストアの更新を完了するのにかかる平均時間。 |
| KVストアの更新を完了するのにかかる最大時間。 |
| KVストアの更新を完了するのにかかる時間の中央値。 |
| ピアセット内のピアの数。 |
| 許可された失効しきい値内で提供されたクエリ。 |
| トランザクション操作の適用にかかる平均時間。 |
| トランザクション操作の適用にかかる最大時間。 |
| トランザクション操作の適用にかかる時間の中央値。 |
|
|
| 失敗したRPC要求の測定。 |
| エージェントがConsulサーバーにロードしている量の測定。 |
| レートが制限されるRPCリクエストの測定。 |
| このノードから他のすべてのノードまでの最大遅延。 |
| このノードから他のすべてのノードまでの遅延の中央値。 |
| このノードから他のすべてのノードまでの最小遅延。 |
| このノードから他のすべてのノードへのP25遅延。 |
| このノードから他のすべてのノードへのP75遅延。 |
| このノードから他のすべてのノードへのP90遅延。 |
| このノードから他のすべてのノードへのP95遅延。 |
| このノードから他のすべてのノードへのP99レイテンシ。 |
| 割り当てられたヒープオブジェクトの累積数。 |
| 領事プロセスによって割り当てられた現在のバイト。 |
| 解放されたヒープオブジェクトの累積数。 |
| 完了したGCサイクルの数。 |
| 領事が開始してから、GCの累積ナノ秒は世界を停止します。 |
| 実行中のgoルーチンの数。 |
| ヒープに割り当てられたオブジェクトの数 |
| goランタイムによって予約された仮想アドレス空間の合計サイズ。 |
在庫データ
HashiCorp Consul統合は、ConsulAgentノードの構成パラメーターと現在の設定をキャプチャします。/v1/agent/self
RESTAPIエンドポイントの結果を収集します。その応答から{ Config
}セクションとDebugConfig
セクションを引き出します。
ヒント
注: Config
およびDebugConfig
内のネストされたセクションは収集されません。
データは、 config/consulソースの下の[ インベントリ]ページで入手できます。インベントリデータの詳細については、 統合データについてを参照してください。
ソースコードを確認してください
この統合はオープン ソース ソフトウェアです。つまり、ソース コードを参照して改善を送信したり、独自のフォークを作成してビルドしたりできます。