MongoDB のモニター

MongoDB センサーは、Instana エージェントのインストール後、自動的に展開され、インストールされます。

サポート情報

MongoDB センサーが現在のセットアップと互換性があることを確認するには、以下のサポート情報セクションをチェックしてください:

サポート対象のオペレーティング・システム

このセンサーは、Instanaホストエージェントと同じオペレーティングシステムをサポートします。 詳細は、各ホストエージェントの「 サポート対象オペレーティングシステム」 セクションを参照してください。例:

注: OSのサポートは、技術と監視方法によって異なります。 リモート監視において、Instanaエージェントは、対象技術のオペレーティングシステムに関係なく、Instanaがサポートするあらゆるオペレーティングシステム上で実行可能です。 ネイティブ監視では、Instanaエージェントと対象テクノロジーの両方が同じオペレーティングシステムをサポートしている必要があります。

対応バージョンとサポートポリシー

このセンサーは、 MongoDB および MongoDB Atlas の以下のバージョンをサポートしています:

  • MongoDB 3.2.x
  • MongoDB 3.4.x
  • MongoDB 3.6.x
  • MongoDB 4.0.x
  • MongoDB および MongoDB アトラス 4.2.x
  • MongoDB および MongoDB アトラス 4.4.x
  • MongoDB および MongoDB アトラス 5.0.x
  • MongoDB および MongoDB アトラス 6.0.x
  • MongoDB および MongoDB アトラス 7.0.x
  • MongoDB および MongoDB アトラス 8.0.4

以下の表は、最新のサポートバージョンとサポートポリシーを示しています:

テクノロジー サポート・ポリシー 最新技術バージョン サポートされる最新バージョン
MongoDB 45 日間 8.2.2 8.2.2
MongoDB Atlas 45 日間 8.2.2 8.2.2

サポートポリシーの詳細については、 「センサーのサポート戦略」 を参照してください。

構成

MongoDB 認証を無効にした場合

アクションは不要です。 認証が無効になっている MongoDB のモニターは、 configuration.yaml ファイルに構成を指定しなくても自動的に行われます。

MongoDB 認証を有効にした場合

MongoDBをモニターするには、以下の最小限の役割を持つユーザーを作成する必要があります。

  • read - admin データベース上
  • clusterMonitoer - admin データベース上
  • read - local データベース上

mongo シェルで、 admin データベース内に Instana エージェントのユーザーを作成します。

  1. admin ユーザーとして認証します。
    use admin
    db.auth("admin", "YOUR_MONGODB_ADMIN_PASSWORD")
     
  2. MongoDB 3.x 以降のバージョンの場合は、 createUser コマンドを実行します。
    db.createUser({
      "user":"stan",
      "pwd": "UNIQUEPASSWORD",
      "roles" : [
        {role: 'read', db: 'admin' },
        {role: 'clusterMonitor', db: 'admin'},
        {role: 'read', db: 'local' }
      ]
    })
     

  • MongoDB Atlas を使用している場合、ユーザー (割り当てられたすべての役割を持つ) は、MongoDB Atlas 管理コンソールを介してのみ作成できます。

    ユーザーが作成された後、エージェント構成ファイルでそのユーザーを構成できます。

    com.instana.plugin.mongodb:
      user: 'stan'
      source: 'admin'
      password: 'UNIQUEPASSWORD'
      poll_rate:
       general_metrics: 1 # general MongoDB metrics (connections, ops, etc.)
       replicaset_metrics: 30 # replica set state metrics
     
注: 一般的なメトリクス・インターバルのデフォルト値は1秒、レプリカセット・インターバルは30秒です。
  • sourceは、ユーザーが定義されているデータベースまたは認証ソースを参照します。 詳細は MongoDB のドキュメントを参照。
注: MongoDB クラスタまたはスタンドアロンを Instana で監視する場合は、 --bind_ip を特定の IP アドレスで設定するか、デフォルト値 127.0.0.1 に設定しないでください。 bind_ip_all

MongoDB Atlas サポート

Instana エージェントは、さまざまなプロジェクトおよび組織に存在する MongoDB Atlas クラスターのリモート・モニターをサポートします。 Instana エージェントが MongoDB Atlas 組織をモニターできるようにするには、 <agent_install_dir>/etc/instana/configuration.yamlで構成する必要があります。

com.instana.plugin.mongodb:
  user: 'stan'
  source: 'admin'
  password: 'UNIQUEPASSWORD'
  poll_rate:
    general_metrics: 1 # general MongoDB metrics (connections, ops, etc.)
    replicaset_metrics: 30 # replica set state metrics
  atlas:
    - publicKey: 'your public key'
      privateKey: 'your private key'
    - publicKey: 'your public key'
      privateKey: 'your private key'
 
注: 一般的なメトリクス・インターバルのデフォルト値は1秒、レプリカセット・インターバルは30秒です。

  • 公開鍵と秘密鍵で構成される API 鍵は、MongoDB Atlas 組織レベルで定義する必要があります。 最低限必要な組織権限は Organization Read Only です。
  • MongoDB Atlas を使用している場合、割り当てられたすべての役割を持つユーザーは、MongoDB Atlas 管理コンソールを介してのみ作成できます。

SSL/TLS サポート

Instana エージェントを MongoDB サーバーに安全に接続するには、 <agent_install_dir>/etc/instana/configuration.yamlで構成する必要があります。

com.instana.plugin.mongodb:
  ...
  sslTrustStore: '/path/to/truststore.jks'
  sslTrustStorePassword: 'mongoTsPassword'
  sslKeyStore: '/path/to/sslKeyStoreFile.jks'
  sslKeyStorePassword: 'mongoKsPassword'
 

SSL/TLS サポート機能を有効にするには、鍵が Java 鍵ストアの形式 (JKS) でなければなりません。 keytoolは、これらのキーを作成するために使用することができます。

この機能により、Instana エージェントが SSL/TLS を使用して MongoDB サーバーに接続できるようになります。 接続後、資格情報 (ユーザー/パスワード) が auth-database へのアクセスに使用されます。

メトリック収集

メトリクスを表示するには、Instana ユーザーインターフェイスのサイドバーでインフラストラクチャを選択し、特定の監視ホストをクリックします。

構成データ

  • バージョン
  • ポート
  • ストレージ・エンジン
  • データベース

パフォーマンス・メトリック

データベース・アクティビティー

メトリック 説明
読み取り 読み取られた文書の数
挿入済み 挿入された文書の数
アップロード済み アップロードされた文書の数
削除済み 削除された文書の数

操作カウンタ

メトリック 説明
Update mongodインスタンスが最後に起動してから受け取った更新操作の総数。
挿入 mongodインスタンスが最後に起動してから受け取ったインサート操作の総数。
照会 mongodインスタンスが最後に起動した後に受け取ったクエリの総数。
削除 mongodインスタンスが最後に起動してからの削除操作の総数。
getMore mongodインスタンスが最後に起動してからの getMore 操作の総数。

メモリー

メトリック 説明
仮想 これには、MongoDB プロセス全体の仮想メモリーが含まれます。 ジャーナリングをオンにした場合、これは通常、マップされたメモリーのサイズの 2 倍になります。
マップ済み これは、データベースをメモリーにマップするために MongoDB の進行で使用される仮想メモリーの量です。 これは通常、データベースのサイズです。

クライアント

メトリック 説明
接続数 MongoDB サーバーに接続している現在のアクティブクライアント数。
ActiveClients 作家 書き込み操作を行うアクティブなクライアント接続の数。
ActiveClients 読者 読み取り操作を行うアクティブなクライアント接続の数。

データベース (データベースごと)

メトリック 説明
データベースのサイズ データベース・サイズ

レプリカ・セット (存在する場合)

メトリック 説明
適用操作数 内部適用操作の数
適用バッチ 内部適用バッチの数
合計適用バッチ (ミリ秒) 適用バッチの期間 (ミリ秒)
バッファー・カウント バッファーの数
バッファー・サイズ バッファーのサイズ
ネットワーク操作 ネットワーク操作数
ネットワーク・バイト数 ネットワーク操作のサイズ
文書プリロード 文書プリロード操作の数
合計文書プリロード (ミリ秒) 文書プリロードの期間 (ミリ秒)
Idx プリロード Idx プリロード操作の数
合計 Idx プリロード (ミリ秒) Idx プリロードの期間 (ミリ秒)
レプリケーション・ラグ 1 次上の書き込み操作と 2 次へのコピーとの間の遅延 (ミリ秒)

Atlas クラスター (存在する場合)

メトリック 説明
読み取り 読み取られた文書の数
挿入済み 挿入された文書の数
アップロード済み アップロードされた文書の数
削除済み 削除された文書の数
接続数 現在接続されているクライアントの数
ネットワーク操作 ネットワーク操作数
ネットワーク・バイト数 ネットワーク操作のサイズ

正常性シグニチャー

センサーごとに、着信メトリックに対して継続的に評価され、ユーザーへの影響に応じて問題またはインシデントを提起するために使用される正常性シグニチャーのキュレーション済み知識ベースがあります。

組み込みイベントはエンティティのヘルスシグネチャの失敗に基づいて問題やインシデントをトリガーし、 カスタムイベントは任意のエンティティの個々のメトリックのしきい値に基づいて問題やインシデントをトリガーします。

MongoDB センサーの内蔵イベントについては、 内蔵イベントリファレンスを参照。