监视 MongoDB

该传感器支持与 Instana 主机代理相同的操作系统。 有关详细信息，请参阅各主机代理的 “支持的操作系统 ”部分，例如：

• Unix 支持的操作系统
• Windows 支持的操作系统
• Linux 支持的操作系统

该传感器支持以下 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

无须执行任何操作。 在configuration.yaml文件中不提供任何配置的情况下，会自动监视已禁用认证的 MongoDB。

要监视 MongoDB，您需要创建具有以下最低角色的用户：

• read - 在 admin 数据库上
• clusterMonitoer - 在 admin 数据库上
• read - 在 local 数据库上

在 mongo shell 中，为 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.The source 指的是定义该用户的数据库或身份验证源。 如需更多信息，请参阅 MongoDB 文档。
   注意： 当您使用 Instana 监控 MongoDB 集群或独立实例时，请配置 --bind_ip 具体的 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'