Boundary

概要

このチェックは、Datadog Agent を通じて Boundary を監視するものです。Boundary の最小サポートバージョンは、0.8.0 です。

セットアップ

ホストで実行されている Agent 用にこのチェックをインストールおよび構成する場合は、以下の手順に従ってください。コンテナ環境の場合は、オートディスカバリーのインテグレーションテンプレートのガイドを参照してこの手順を行ってください。

インストール

Boundary チェックは Datadog Agent パッケージに含まれています。 サーバーに追加でインストールする必要はありません。

構成

リスナー

メトリクスを収集できるようにするには、config.hcl ファイルに ops 目的のリスナーを設定する必要があります。以下はリスナーのスタンザの例です。

controller {
  name = "boundary-controller"
  database {
    url = "postgresql://<username>:<password>@10.0.0.1:5432/<database_name>"
  }
}

listener "tcp" {
  purpose = "api"
  tls_disable = true
}

listener "tcp" {
  purpose = "ops"
  tls_disable = true
}

コントローラーがシャットダウンしているとき、boundary.controller.health サービスチェックは WARNING として送信されます。このシャットダウン猶予期間を有効にするには、controller ブロックを更新して、待ち時間を定義します。

controller {
  name = "boundary-controller"
  database {
    url = "env://BOUNDARY_PG_URL"
  }
  graceful_shutdown_wait_duration = "10s"
}

Datadog Agent

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

2. Agent を再起動します。

検証

Agent の status サブコマンドを実行し、Checks セクションで boundary を探します。

収集データ

メトリクス

イベント

Boundary インテグレーションには、イベントは含まれません。

サービスのチェック

boundary.openmetrics.health
Returns CRITICAL if the Agent is unable to connect to the OpenMetrics endpoint, otherwise returns OK.
Statuses: ok, critical

boundary.controller.health
Returns CRITICAL if the Agent is unable to connect to the controller’s health endpoint, WARNING if the controller received a shutdown signal, otherwise returns OK.
Statuses: ok, warning, critical

ログの収集

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

   logs_enabled: true
   

2. Boundary のログの収集を開始するには、次のコンフィギュレーションブロックを boundary.d/conf.yaml ファイルに追加します。

   logs:
      - type: file
        source: boundary
        path: /var/log/boundary/events.ndjson
   

   path パラメーターの値を環境に合わせて変更します。使用可能なすべてのコンフィギュレーションオプションについては、boundary.d/conf.yaml ファイルのサンプルを参照してください。

トラブルシューティング

ご不明な点は、Datadog のサポートチームまでお問い合わせください。