• EnglishEspañol日本語한국어Português
  • ログイン今すぐ開始

この機械翻訳は参考用に提供されます。

英語版と翻訳版に矛盾がある場合は、英語版が優先されます。詳細については、 を参照してください。

問題を作成する

HashiCorp領事館の監視統合

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

ヒント

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

互換性と要件

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

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

クイックスタート

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

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

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

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

インストール

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

''

統合を更新する

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

インストール後のタスク

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

統合を構成する

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

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

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

重要

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

Consul 構成オプション

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

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

設定

説明

デフォルト

に適用されます

ホスト名

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

メトリックのみの収集を有効にするには、 trueに設定します。

false

在庫

インベントリのみの収集を有効にするには、 trueに設定します。

false

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

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

ラベル

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

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

labels:
env: production
role: load_balancer

構成例

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

このインテグレーションからのデータは、one.newrelic.com > Infrastructure > Third-party services > Apacheから入手できます。

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

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

メトリックデータ

HashiCorp 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セクションを引き出します。

ヒント

ConfigおよびDebugConfig内のネストされたセクションは収集されません。

データは、 config/consulソースの下の[ インベントリ]ページで入手できます。インベントリデータの詳細については、 統合データについてを参照してください。

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

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

Copyright © 2024 New Relic株式会社。

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.