HashiCorp Consul の監視

Consul センサーが現在の環境と互換性があるかどうかを確認するには、以下のサポート情報セクションをご確認ください：

Instana エージェントは、実行中の Consul エージェントを自動的に検出して、デフォルト設定がオーバーライドされている場合にはコマンド・ライン引数 -client および -http-port を解析します。 エージェントは、Consul に接続するために必要となるほとんどの構成値を認識できます。

Instana エージェントは、エージェントの HTTP API を通じて Consul にアクセスします。 vanilla Consul インストール済み環境では、資格情報を使用せずに、このインターフェースにアクセスできます。 この場合、Instana Consul センサーに特別な構成は必要ありません。

一方で、Consul HTTP アクセス・ポリシー acl_default_policy を deny に設定している場合は、Instana エージェントにトークンを提供する必要があります。 これを行うには、エージェントの構成ファイル <agent_install_dir>/etc/instana/configuration.yamlでそれらを構成します。

まず、 ACLガイドに記載されている手順に従って、 Consul に対して以下のACL設定を行い、読み取り権限を持つアクセストークンを作成する必要があります：

• Consul 1.6.1 より前のバージョン:

  agent "" {
    policy = "read"
  }
  health "" {
    policy = "read"
  }
   

• Consul 1.6.1 以降のバージョン:

  agent_prefix "" {
    policy = "read"
  }
  health "" {
    policy = "read"
  }
   

次のステップでは、Instana エージェント <agent_install_dir>/etc/instana/configuration.yamlで token を構成する必要があります。 以下に、Consul のモニタリングで設定できるすべての構成値を示します。

com.instana.plugin.consul:
  enabled: true
  client: ''
  httpPort: 8500
  token: ''
  poll_rate: 5
 

• enabled: Consul センサーを有効/無効にします。デフォルトは enabled です。
• client: エージェントのホスト名。デフォルトでは、センサーは、-client パラメーターを解析するか、localhost を使用します。
• httpPort: エージェントの HTTP ポート。デフォルトでは、センサーは、-http-port パラメーターを解析するか、8500 を使用します。
• token: acl_default_policy が deny に設定されている場合に Consul エンドポイントにアクセスするための「トークン」。
• poll_rate: 秒単位で時間を指定します。 デフォルトは、5 秒です。 有効な値の範囲は1～3600秒です。

httpPort の構成値は整数値でなければなりません。そうでない場合は、無視されます。つまり、数値に解析できない場合は、標準ポートが使用されます。

メトリクスを表示するには、 Instana のユーザーインターフェースのサイドバーで 「Infrastructure」 を選択し、監視対象の特定のホストをクリックします。すると、収集されたすべてのメトリクスと監視対象のプロセスが表示されたホストダッシュボードが表示されます。