概要
このチェックは、Datadog Agent を通じて VoltDB を監視します。
セットアップ
ホストで実行されている Agent 用にこのチェックをインストールおよび構成する場合は、以下の手順に従ってください。コンテナ環境の場合は、オートディスカバリーのインテグレーションテンプレートのガイドを参照してこの手順を行ってください。
注: このチェックは、クラスター当たり 1 つの Agent に構成される必要があります。複数ホストに及ぶクラスターを監視する場合は、各ホストに 1 つの Agent をインストールします。ただし、メトリクスが重複してしまうため、1 つ以上のホストで VoltDB インテグレーションを有効にしないでください。
インストール
VoltDB チェックは Datadog Agent パッケージに含まれています。
サーバーに追加でインストールする必要はありません。
構成
VoltDB deployment.xml
ファイルを編集し、datadog-agent
ユーザーを追加します。注: 特別なロールは必要ないため、組み込みの user
ロールを割り当てます。
<users>
<!-- ... -->
<user name="datadog-agent" password="<PASSWORD>" roles="user" />
</users>
VoltDB のパフォーマンスデータの収集を開始するには、Agent のコンフィギュレーションディレクトリのルートにある conf.d/
フォルダーの voltdb.d/conf.yaml
ファイルを編集します。使用可能なすべてのコンフィギュレーションオプションについては、サンプル voltdb.d/conf.yaml を参照してください。
init_config:
instances:
- url: http://localhost:8080
username: datadog-agent
password: "<PASSWORD>"
Agent を再起動します。
TLS サポート
TLS/SSL がクライアントの HTTP ポートで有効になっている場合:
CA 証明書ファイルを PEM フォーマットでエクスポートします。
keytool -exportcert -file /path/to/voltdb-ca.pem -keystore <KEYSTORE> -storepass <PASSWORD> -alias voltdb -rfc
証明書を 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-----
インスタンスのコンフィギュレーションで、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
Agent を再起動します。
ログ収集
Datadog Agent で、ログの収集はデフォルトで無効になっています。以下のように、datadog.yaml
ファイルでこれを有効にします。
VoltDB のログの収集を開始するには、次の構成ブロックを voltdb.d/conf.yaml
ファイルに追加します。
logs:
- type: file
path: /var/log/voltdb.log
source: voltdb
path
の値を環境に合わせて変更します。使用可能なすべてのコンフィギュレーションオプションについては、voltdb.d/conf.yaml
ファイルのサンプルを参照してください。
- Agent を再起動します。
Kubernetes 環境のログを有効にするには、Kubernetes ログ収集を参照してください。
検証
Agent のステータスサブコマンドを実行し、Checks セクションで voltdb
を検索します。
収集データ
メトリクス
イベント
このチェックには、イベントは含まれません。
サービスチェック
トラブルシューティング
ご不明な点は、Datadog のサポートチームまでお問合せください。
その他の参考資料