Consul

ホスト

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

メトリクスの収集

1. Consul のメトリクスの収集を開始するには、Agent のコンフィギュレーションディレクトリのルートにある 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. Agent を再起動します。

OpenMetrics

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

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

1. Consul を構成し、Prometheus のエンドポイントにメトリクスを公開します。prometheus_retention_time を、メインの Consul コンフィギュレーションファイルの最上位レベルの telemetry キーにネストするよう設定します。

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

2. Prometheus エンドポイントの使用を開始するには、Agent のコンフィギュレーションディレクトリのルートにある conf.d/ フォルダーで consul.d/conf.yaml ファイルを編集します。

   instances:
       - url: <EXAMPLE>
         use_prometheus_endpoint: true
   

3. 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. 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. Agent を再起動します。

コンテナ化

コンテナ環境の場合は、オートディスカバリーのインテグレーションテンプレートのガイドを参照して、次のパラメーターを適用してください。

メトリクスの収集

ログの収集

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

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