MongoDB のモニター

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

• Unix の対応OS
• Windows の対応OS
• Linux の対応OS

このセンサーは、以下のバージョンの MongoDB および MongoDB Atlas に対応しています：

• MongoDB 3.2.x
• MongoDB 3.4.x
• MongoDB 3.6.x
• MongoDB 4.0.x
• MongoDB および MongoDB Atlas 4.2.x
• MongoDB および MongoDB Atlas 4.4.x
• MongoDB および MongoDB Atlas 5.0.x
• MongoDB および MongoDB Atlas 6.0.x
• MongoDB および MongoDB Atlas 7.0.x
• MongoDB および MongoDB Atlas 8.0.4

以下の表は、最新のサポート対象バージョンとサポート方針を示しています：

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

Instana この技術では、以下の言語およびランタイムにおいてクライアントサイドのトレース機能をサポートしています：

• Java
• Go
• Node.js
• PHP
• Python
• .NET Framework
• .Net Core
• Ruby

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

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 管理コンソールを通じてのみ、すべてのロールが割り当てられたユーザーを作成してください。

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

   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
     host: '' # Optional: Explicit hostname or fully qualified domain name (FQDN) for MongoDB connection (for example, 'mongodb.example.com'). If not specified, the first hostname from the MongoDB bindIp configuration is used.

   注： 一般的なメトリクスの間隔のデフォルト値は 1 秒、レプリカセットの間隔は 30 秒です。 seconds.Thesource は、ユーザーが定義されているデータベースまたは認証ソースを指します。 詳細については、 MongoDB のドキュメントを参照してください。
   注：Instana を使用して MongoDB クラスタまたはスタンドアロンインスタンスを監視する場合は、特定の IP アドレス --bind_ip を設定するか、設定しない場合はデフォルト値の 127.0.0.1 を使用するようにしてください。 パラメータ bind_ip_all は使用しないでください。

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'