ホスト

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

1. vault のパフォーマンスデータの収集を開始するには、Agent のコンフィギュレーションディレクトリのルートにある conf.d/ フォルダーの vault.d/conf.yaml ファイルを編集します。使用可能なすべてのコンフィギュレーションオプションの詳細については、サンプル vault.d/conf.yaml を参照してください。

   トークンなしでインテグレーションを実行するためのコンフィギュレーション (vault コンフィギュレーション unauthenticated_metrics_access が true に設定されている場合):

   init_config:
   
   instances:
       ## @param api_url - string - required
       ## URL of the Vault to query.
       #
     - api_url: http://localhost:8200/v1
   
       ## @param no_token - boolean - optional - default: false
       ## Attempt metric collection without a token.
       #
       no_token: true
   

   クライアントトークンとのインテグレーションを実行するためのコンフィギュレーション:

   init_config:
   
   instances:
       ## @param api_url - string - required
       ## URL of the Vault to query.
       #
     - api_url: http://localhost:8200/v1
   
       ## @param client_token - string - optional
       ## Client token necessary to collect metrics.
       #
       client_token: <CLIENT_TOKEN>
   
       ## @param client_token_path - string - optional
       ## Path to a file containing the client token. Overrides `client_token`.
       ## The token will be re-read after every authorization error.
       #
       # client_token_path: <CLIENT_TOKEN_PATH>
   

2. Agent を再起動します。

コンテナ化

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

Vault の認証コンフィギュレーションに応じて、INSTANCE_CONFIG をカスタマイズする必要があります。上記のホストセクションの例を参照してください。

ログの収集

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

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

   logs_enabled: true
   

2. Vault を構成し、監査とサーバーログを有効にします。

   • 監査ログは、適切なポリシーを持つ特権ユーザーが有効にする必要があります。詳細は、監査デバイスの有効化を参照してください。

     vault audit enable file file_path=/vault/vault-audit.log
     

   • サーバーログがファイルに必ず書き込まれるようにしてください。Vault systemd 起動スクリプトで静的サーバーログを構成することができます。 以下のスクリプトは、/var/log/vault.logへログを出力します。

     ...
     [Service]
     ...
     ExecStart=/bin/sh -c '/home/vagrant/bin/vault server -config=/home/vagrant/vault_nano/config/vault -log-level="trace" > /var/log/vault.log
     ...
     

3. 次の構成ブロックを vault.d/conf.yaml ファイルに追加し、Vault ログの収集を始めます。

   logs:
     - type: file
       path: /vault/vault-audit.log
       source: vault
       service: "<SERVICE_NAME>"
     - type: file
       path: /var/log/vault.log
       source: vault
       service: "<SERVICE_NAME>"