Surveillance de MongoDB

Le capteur prend en charge les mêmes systèmes d'exploitation que les agents hôtes d' Instana. Pour plus de détails, consultez la section « Systèmes d'exploitation pris en charge » de chaque agent hôte, par exemple :

• Systèmes d'exploitation pris en charge par l' Unix
• Systèmes d'exploitation pris en charge par l' Windows
• Systèmes d'exploitation pris en charge par l' Linux

Le capteur prend en charge les versions suivantes d' MongoDB et d' MongoDB Atlas :

• MongoDB 3.2.x
• MongoDB 3.4.x
• MongoDB 3.6.x
• MongoDB 4.0.x
• MongoDB et MongoDB Atlas 4.2.x
• MongoDB et MongoDB Atlas 4.4.x
• MongoDB et MongoDB Atlas 5.0.x
• MongoDB et MongoDB Atlas 6.0.x
• MongoDB et MongoDB Atlas 7.0.x
• MongoDB et MongoDB Atlas 8.0.4

Le tableau suivant présente la dernière version prise en charge et la politique d'assistance :

Pour plus d'informations sur la politique d'assistance, consultez la section « Stratégie d'assistance pour les capteurs ».

Instana prend en charge le traçage côté client pour cette technologie dans les langages et environnements d'exécution suivants :

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

Aucune action n'est requise. La surveillance d' MongoDB, lorsque l'authentification est désactivée, s'effectue automatiquement sans qu'il soit nécessaire de définir de paramètres dans le configuration.yaml fichier.

Pour surveiller MongoDB,, vous devez créer un utilisateur disposant au minimum des rôles suivants :

• read - dans admin la base de données
• clusterMonitoer - dans admin la base de données
• read - dans local la base de données

Dans un shell MongoDB, créez un utilisateur pour l'agent d' Instana dans la admin base de données :

1. Se connecter en tant admin qu'utilisateur :

   use admin
   db.auth("admin", "YOUR_MONGODB_ADMIN_PASSWORD")
    

2. Pour MongoDB 3.x et versions ultérieures, exécutez la commande createUser :

   db.createUser({
     "user":"stan",
     "pwd": "UNIQUEPASSWORD",
     "roles" : [
       {role: 'read', db: 'admin' },
       {role: 'clusterMonitor', db: 'admin'},
       {role: 'read', db: 'local' }
     ]
   })
    

   Remarque : si vous utilisez MongoDB Atlas, créez l'utilisateur avec tous les rôles attribués uniquement via la console d'administration MongoDB Atlas.

3. Une fois l'utilisateur créé, vous pouvez le configurer dans le fichier de configuration de l'agent :

   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.

   Remarque : la valeur par défaut de l'intervalle pour les métriques générales est de 1 seconde, et celle pour le jeu de répliques est de 30 s seconds.Thesource fait référence à la base de données ou à la source d'authentification dans laquelle l'utilisateur est défini. Pour plus d'informations, consultez la documentation de l' MongoDB.
   Remarque : lorsque vous surveillez un cluster MongoDB ou une instance autonome à l'aide d' Instana, configurez-le --bind_ip avec des adresses IP spécifiques ou ne définissez aucune valeur pour utiliser la valeur par défaut 127.0.0.1. N'utilisez pas le bind_ip_all paramètre.

L'agent « Instana » permet la surveillance à distance des clusters d' MongoDB Atlas s au sein de différents projets et organisations. Pour que l'agent d' Instana s puisse surveiller vos organisations MongoDB Atlas, il doit être configuré ici <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'