概要
このチェックでは、Datadog Agent を通じて FoundationDB を監視します。FoundationDB クラスターが健全であることを確認するほか、多数のメトリクスを収集し、オプションで FoundationDB トランザクションログも収集します。
セットアップ
チェックとメトリクスはどちらも FoundationDB クラスター全体に適用され、1 つのホストにのみインストールする必要があります。このホストは FoundationDB を実行しているホストである必要はなく、アクセス可能なホストであれば問題ありません。
インストール
FoundationDB チェックは Datadog Agent パッケージに含まれていますが、FoundationDB クライアントがインストールされている必要があります。
構成
ホスト
ホストで実行中の Agent に対してこのチェックを構成するには
メトリクスの収集
FoundationDB メトリクスの収集を開始するには、Agent の構成ディレクトリのルートにある conf.d/
フォルダ内の foundationdb.d/conf.yaml
ファイルを編集します。
使用可能なすべての構成オプションの詳細については、サンプル foundationdb.d/conf.yaml を参照してください。
チェックするクラスターは、デフォルトの場所にあるクラスターファイルを検索することで決定されます。クラスターファイルが他の場所にある場合は、
cluster_file
プロパティを設定します。チェックインスタンスごとに監視できるクラスターは 1 つだけです。
クラスターが TLS を使用するように構成されている場合、構成にさらなるプロパティを設定する必要があります。これらのプロパティは、
そのようなクラスターに接続するために fdbcli
に与えられる TLS 関連のオプションの名前に従います。
Agent を再起動します。
ログ収集
FoundationDB はデフォルトで XML ログを書き込みますが、Datadog インテグレーションは JSON ログを想定しています。そのため、FoundationDB に構成変更を行う必要があります。
foundationdb.conf
ファイルを探します。fdbserver
セクションで、
キー trace_format
を追加または変更して、値を json
にします。
また、logdir
をメモしておきます。
[fdbserver]
...
logdir = /var/log/foundationdb
trace_format = json
FoundationDB サーバーを再起動し、変更を有効にします。
logdir
にあるログが JSON で書き込まれていることを確認します。
datadog.yaml
ファイルでログ収集が有効になっていることを確認します。
foundationdb.d/conf.yaml
ファイルで、logs
セクションのコメントを解除し、
パスを FoundationDB の構成ファイルにあるものに設定し、
*.json
を追加します。
logs:
- type: file
path: /var/log/foundationdb/*.json
service: foundationdb
source: foundationdb
Datadog Agent が、ディレクトリの一覧表示とそのファイルの読み取りに必要な権限を
持っていることを確認します。
Datadog Agent を再起動します。
コンテナ化
コンテナ環境の場合は、オートディスカバリーのインテグレーションテンプレートのガイドを参照して、次のパラメーターを適用してください。
メトリクスの収集
パラメーター | 値 |
---|
<INTEGRATION_NAME> | foundationdb |
<INIT_CONFIG> | 空白または {} |
<INSTANCE_CONFIG> | {} |
ログ収集
Datadog Agent で、ログの収集はデフォルトで無効になっています。有効にする方法については、Kubernetes ログ収集を参照してください。
パラメーター | 値 |
---|
<LOG_CONFIG> | {"source": "foundationdb", "service": "<SERVICE_NAME>"} |
検証
Agent の status サブコマンドを実行し、Checks セクションで foundationdb
を探します。
収集データ
メトリクス
イベント
FoundationDB チェックには、イベントは含まれません。
トラブルシューティング
ご不明な点は、Datadog のサポートチームまでお問い合わせください。