ホスト

ホストで実行中の Agent に対してこのチェックを構成するには

メトリクスの収集

1. Consul メトリクスの収集を開始するには、conf.d/ フォルダーにある consul.d/conf.yaml ファイルを編集してください。エージェントの設定ディレクトリ のルートにあります。すべての設定オプションについては、サンプル consul.d/conf.yaml を参照してください。

   init_config:
   
   instances:
     ## @param url - string - required
     ## Where your Consul HTTP server lives,
     ## point the URL at the leader to get metrics about your Consul cluster.
     ## Use HTTPS instead of HTTP if your Consul setup is configured to do so.
     #
     - url: http://localhost:8500
   

2. Restart the Agent.

OpenMetrics

オプションで、use_prometheus_endpoint コンフィギュレーションオプションを有効にして、Consul Prometheus エンドポイントから追加のメトリクスセットを取得できます。

注: DogStatsD または Prometheus メソッドを使用し、同じインスタンスに両方を有効化しないようご注意ください。

1. Prometheus エンドポイントへメトリクスを公開するよう Consul を構成します。メインの Consul 構成ファイルのトップレベル telemetry キー配下に prometheus_retention_time を設定してください。

   {
     ...
     "telemetry": {
       "prometheus_retention_time": "360h"
     },
     ...
   }
   

2. Prometheus エンドポイントを使用するには、Agent 構成ディレクトリ 直下の conf.d/ フォルダーにある consul.d/conf.yaml を編集します。

   instances:
       - url: <EXAMPLE>
         use_prometheus_endpoint: true
   

3. Restart the Agent.

DogStatsD

Prometheus エンドポイントの代わりに、DogStatsD を使用して同じ追加メトリクスを Agent へ送信するよう Consul を構成できます。

1. Consul のメインのコンフィギュレーションファイルで、最上位レベルの telemetry キーの下にネストした dogstatsd_addr を追加することで、DogStatsD メトリクスを送信するよう Consul を構成します。

   {
     ...
     "telemetry": {
       "dogstatsd_addr": "127.0.0.1:8125"
     },
     ...
   }
   

2. メトリクスに正しいタグを付与するため、Datadog Agent メイン構成ファイル datadog.yaml を更新し、以下の設定を追加してください。

   # dogstatsd_mapper_cache_size: 1000  # default to 1000
   dogstatsd_mapper_profiles:
     - name: consul
       prefix: "consul."
       mappings:
         - match: 'consul\.http\.([a-zA-Z]+)\.(.*)'
           match_type: "regex"
           name: "consul.http.request"
           tags:
             method: "$1"
             path: "$2"
         - match: 'consul\.raft\.replication\.appendEntries\.logs\.([0-9a-f-]+)'
           match_type: "regex"
           name: "consul.raft.replication.appendEntries.logs"
           tags:
             peer_id: "$1"
         - match: 'consul\.raft\.replication\.appendEntries\.rpc\.([0-9a-f-]+)'
           match_type: "regex"
           name: "consul.raft.replication.appendEntries.rpc"
           tags:
             peer_id: "$1"
         - match: 'consul\.raft\.replication\.heartbeat\.([0-9a-f-]+)'
           match_type: "regex"
           name: "consul.raft.replication.heartbeat"
           tags:
             peer_id: "$1"
   

3. Restart the Agent.

ログ収集

Agent バージョン 6.0 以降で利用可能

1. Datadog Agent で、ログの収集はデフォルトで無効になっています。以下のように、datadog.yaml ファイルでこれを有効にします。

   logs_enabled: true
   

2. consul.yaml ファイルでこのコンフィギュレーションブロックを編集して、Consul ログを収集します。

   logs:
     - type: file
       path: /var/log/consul_server.log
       source: consul
       service: myservice
   

   path パラメーターと service パラメーターの値を変更し、環境に合わせて構成してください。 利用可能なすべての設定オプションについては、サンプル consul.d/conf.yaml を参照してください。

3. Restart the Agent.

コンテナ化

コンテナ化環境の場合は、パラメータの適用方法について 自動検出 インテグレーション テンプレート を参照してください。

メトリクスの収集

ログ収集

Agent バージョン 6.0 以降で利用可能

Datadog Agent ではログ収集はデフォルトで無効になっています。有効にするには、Kubernetes のログ収集 を参照してください。