Supported OS Linux Windows Mac OS

インテグレーションバージョン3.2.1

概要

このインテグレーションはメンテナンスモードで、Python 2 でのみ動作します。 v7.37 以降の Agent には含まれていませんが、:6 のバグフィックスリリースには引き続き含まれます。

このチェックは、以下を含む TokuMX メトリクスを収集します。

  • Opcounters
  • レプリケーションラグ
  • キャッシュテーブル使用率とストレージサイズ。

セットアップ

インストール

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

構成

TokuMX の準備

  1. 次のコマンドを使用して、Python MongoDB モジュールを MongoDB サーバーにインストールします。

    sudo pip install --upgrade "pymongo<3.0"
    
  2. 次のコマンドを使用して、モジュールがインストールされていることを確認できます。

    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"
    
  3. 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)
    
  4. 次のコマンドを使用して、ユーザーが作成されたことを確認します (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 に対してこのチェックを構成するには

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

    init_config:
    
    instances:
      - server: "mongodb://<USER>:<PASSWORD>@localhost:27017"
    
  2. 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 のサポートチームまでお問合せください。

その他の参考資料

PREVIEWING: may/embedded-workflows