概要
このインテグレーションはメンテナンスモードで、Python 2 でのみ動作します。
v7.37 以降の Agent には含まれていませんが、:6 のバグフィックスリリースには引き続き含まれます。
このチェックは、以下を含む TokuMX メトリクスを収集します。
- Opcounters
- レプリケーションラグ
- キャッシュテーブル使用率とストレージサイズ。
セットアップ
インストール
TokuMX チェックは Datadog Agent パッケージに含まれています。サーバーに追加でインストールする必要はありません。
構成
TokuMX の準備
次のコマンドを使用して、Python MongoDB モジュールを MongoDB サーバーにインストールします。
sudo pip install --upgrade "pymongo<3.0"
次のコマンドを使用して、モジュールがインストールされていることを確認できます。
python -c "import pymongo" 2>&1 | grep ImportError && \
echo -e "\033[0;31mpymongo python module - Missing\033[0m" || \
echo -e "\033[0;32mpymongo python module - OK\033[0m"
Mongo シェルを起動し、admin
データベースに Datadog Agent 用の読み取り専用ユーザーを作成します。
# Authenticate as the admin user.
use admin
db.auth("admin", "<YOUR_TOKUMX_ADMIN_PASSWORD>")
# Add a user for Datadog Agent
db.addUser("datadog", "<UNIQUEPASSWORD>", true)
次のコマンドを使用して、ユーザーが作成されたことを確認します (Mongo シェルではありません)。
python -c 'from pymongo import Connection; print Connection().admin.authenticate("datadog", "<UNIQUEPASSWORD>")' | \
grep True && \
echo -e "\033[0;32mdatadog user - OK\033[0m" || \
echo -e "\033[0;31mdatadog user - Missing\033[0m"
MongoDB でのユーザーの作成と管理の詳細については、MongoDB Security のドキュメントを参照してください。
ホスト
ホストで実行中の Agent に対してこのチェックを構成するには
Agent の構成ディレクトリのルートにある conf.d/
フォルダーの tokumx.d/conf.yaml
ファイルを編集します。
使用可能なすべてのコンフィギュレーションオプションについては、サンプル tokumx.d/conf.yaml を参照してください。
init_config:
instances:
- server: "mongodb://<USER>:<PASSWORD>@localhost:27017"
Agent を再起動すると、Datadog への TokuMX メトリクスの送信が開始されます。
コンテナ化
コンテナ環境の場合は、オートディスカバリーのインテグレーションテンプレートのガイドを参照して、次のパラメーターを適用してください。
パラメーター | 値 |
---|
<INTEGRATION_NAME> | tokumx |
<INIT_CONFIG> | 空白または {} |
<INSTANCE_CONFIG> | {"server": "mongodb://<ユーザー>:<パスワード>@%%host%%:27017"} |
検証
Agent の status
サブコマンドを実行し、Checks セクションで tokumx
を探します。
収集データ
メトリクス
イベント
レプリケーション状態の変化:
このチェックは、TokuMX ノードでレプリケーション状態が変化するたびにイベントを送信します。
サービスチェック
tokumx.can_connect
Agent が監視対象の TokuMX インスタンスに接続できない場合は、CRITICAL
を返します。それ以外の場合は、OK
を返します。
Statuses: ok, クリティカル
トラブルシューティング
ご不明な点は、Datadog のサポートチームまでお問合せください。
その他の参考資料