概要

このチェックは、Datadog Agent を通じて VoltDB を監視します。

セットアップ

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

注: このチェックは、クラスター当たり 1 つの Agent に構成される必要があります。複数ホストに及ぶクラスターを監視する場合は、各ホストに 1 つの Agent をインストールします。ただし、メトリクスが重複してしまうため、1 つ以上のホストで VoltDB インテグレーションを有効にしないでください。

インストール

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

構成

1. VoltDB deployment.xml ファイルを編集し、datadog-agent ユーザーを追加します。注: 特別なロールは必要ないため、組み込みの user ロールを割り当てます。

   <users>
       <!-- ... -->
       <user name="datadog-agent" password="<PASSWORD>" roles="user" />
   </users>
   

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

   init_config:
   
   instances:
     - url: http://localhost:8080
       username: datadog-agent
       password: "<PASSWORD>"
   

3. Agent を再起動します。

TLS サポート

TLS/SSL がクライアントの HTTP ポートで有効になっている場合:

1. CA 証明書ファイルを PEM フォーマットでエクスポートします。

   keytool -exportcert -file /path/to/voltdb-ca.pem -keystore <KEYSTORE> -storepass <PASSWORD> -alias voltdb -rfc
   

2. 証明書を PEM フォーマットでエクスポート:

   openssl pkcs12 -nodes -in <KEYSTORE> -out /path/to/voltdb.pem -password pass:<PASSWORD>
   

   結果のファイルには、暗号化されていない 秘密キーと証明書が含まれています。

   -----BEGIN PRIVATE KEY-----
   <Private key contents...>
   -----END PRIVATE KEY-----
   -----BEGIN CERTIFICATE-----
   <Certificate contents...>
   -----END CERTIFICATE-----
   

3. インスタンスのコンフィギュレーションで、url を TLS が有効になっているクライアントのエンドポイントに指定し、tls_cert および tls_ca_cert のオプションを設定します。例:

   instances:
   - # ...
     url: https://localhost:8443
     tls_cert: /path/to/voltdb.pem
     tls_ca_cert: /path/to/voltdb-ca.pem
   

4. Agent を再起動します。

ログ収集

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

   logs_enabled: true
   

2. VoltDB のログの収集を開始するには、次の構成ブロックを voltdb.d/conf.yaml ファイルに追加します。

   logs:
     - type: file
       path: /var/log/voltdb.log
       source: voltdb
   

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

3. Agent を再起動します。

Kubernetes 環境のログを有効にするには、Kubernetes ログ収集を参照してください。

検証

Agent のステータスサブコマンドを実行し、Checks セクションで voltdb を検索します。

収集データ

メトリクス

イベント

このチェックには、イベントは含まれません。

サービスチェック

voltdb.can_connect
Returns CRITICAL if the Agent is unable to reach the configured VoltDB client URL, OK otherwise.
Statuses: ok, critical

トラブルシューティング

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

その他の参考資料