Independiente

Para configurar esta integración para el despliegue de un solo nodo MongoDB:

Preparación de MongoDB

En un shell Mongo, crea un usuario de sólo lectura para el Datadog Agent en la base de datos admin:

# Autentícate como el usuario administrador.
use admin
db.auth("admin", "<YOUR_MONGODB_ADMIN_PASSWORD>")

# Crea el usuario para el Datadog Agent.
db.createUser({
  "user": "datadog",
  "pwd": "<UNIQUEPASSWORD>",
  "roles": [
    { role: "read", db: "admin" },
    { role: "clusterMonitor", db: "admin" },
    { role: "read", db: "local" },
    # Concede acceso de sólo lectura adicional a la base de datos de la que quieres recopilar estadísticas de recopilación/índice.
    { role: "read", db: "mydb" },
    { role: "read", db: "myanotherdb" },
    # También puedes conceder acceso de sólo lectura a todas las bases de datos.
    { role: "readAnyDatabase", db: "admin" }
  ]
})

Configuración de los Agents

Sólo necesitas un único Agent, preferiblemente ejecutándose en el mismo nodo, para recopilar todas las métricas de mongo disponibles. Consulta las siguientes opciones de configuración.

Conjunto de réplicas

Para configurar esta integración para un conjunto de réplicas MongoDB:

Preparación de MongoDB

En un shell Mongo, autentícate en el primario y crea un usuario de sólo lectura para el Datadog Agent en la base de datos admin:

# Autentícate como el usuario administrador.
use admin
db.auth("admin", "<YOUR_MONGODB_ADMIN_PASSWORD>")

# Crea el usuario para el Datadog Agent.
db.createUser({
  "user": "datadog",
  "pwd": "<UNIQUEPASSWORD>",
  "roles": [
    { role: "read", db: "admin" },
    { role: "clusterMonitor", db: "admin" },
    { role: "read", db: "local" },
    # Concede acceso de sólo lectura adicional a la base de datos de la que quieres recopilar estadísticas de recopilación/índice.
    { role: "read", db: "mydb" },
    { role: "read", db: "myanotherdb" },
    # También puedes conceder acceso de sólo lectura a todas las bases de datos.
    { role: "readAnyDatabase", db: "admin" }
  ]
})

Configuración de los Agents

Instala el Datadog Agent en cada host en el conjunto de réplicas MongoDB y configura el Agent para conectarse a la réplica en ese host (localhost). Ejecutar un Agent en cada host reduce la latencia y los tiempos de ejecución y garantiza que los datos seguirán conectados si falla un host.

Por ejemplo, en el nodo primario:

init_config:
instances:
  - hosts:
      - mongo-primary:27017

En el nodo secundario:

init_config:
instances:
  - hosts:
      - mongo-secondary:27017

En el nodo terciario:

init_config:
instances:
  - hosts:
      - mongo-tertiary:27017

Fragmentación

Para configurar esta integración para un clúster MongoDB fragmentado:

Preparación de MongoDB

Para cada fragmento de tu clúster, conéctate al primario del conjunto de réplicas y crea un usuario local de sólo lectura para el Datadog Agent en la base de datos admin:

# Autentícate como el usuario administrador.
use admin
db.auth("admin", "<YOUR_MONGODB_ADMIN_PASSWORD>")

# Crea el usuario para el Datadog Agent.
db.createUser({
  "user": "datadog",
  "pwd": "<UNIQUEPASSWORD>",
  "roles": [
    { role: "read", db: "admin" },
    { role: "clusterMonitor", db: "admin" },
    { role: "read", db: "local" }
  ]
})

A continuación, crea el mismo usuario desde un proxy mongos. Esta acción crea el usuario local en los servidores de configuración y permite la conexión directa.

Configuración de los Agents

1. Configura un Agent por cada miembro de cada fragmento.
2. Configura un Agent para cada miembro de los servidores de configuración.
3. Configura un Agent adicional para conectarse al clúster a través de un proxy mongos. Este proxy mongos puede ser uno nuevo, exclusivo para la monitorización, o un proxy mongos existente.

Nota: La monitorización de nodos de tipo árbitro no es compatible (para ver más detalles, consulta el árbitro del conjunto de réplicas MongoDB). Sin embargo, cualquier cambio de estado de un nodo de tipo árbitro es informado por el Agent conectado al primario.

Host

A fin de configurar este check para un Agent que se ejecuta en un host:

Recopilación de métricas

1. Edita el archivo mongo.d/conf.yaml en la carpeta conf.d en la raíz del directorio de configuración de tu Agent. Para conocer todas las opciones de configuración disponibles, consulta el mongo.d/conf.yaml de ejemplo.

   init_config:
   
   instances:
       ## @param hosts - list of strings - required
       ## Hosts to collect metrics from, as is appropriate for your deployment topology.
       ## E.g. for a standalone deployment, specify the hostname and port of the mongod instance.
       ## For replica sets or sharded clusters, see instructions in the sample conf.yaml.
       ## Only specify multiple hosts when connecting through mongos
       #
     - hosts:
         - <HOST>:<PORT>
   
       ## @param username - string - optional
       ## The username to use for authentication.
       #
       username: datadog
   
       ## @param password - string - optional
       ## The password to use for authentication.
       #
       password: <UNIQUEPASSWORD>
   
       ## @param database - string - optional
       ## The database to collect metrics from.
       #
       database: <DATABASE>
   
       ## @param options - mapping - optional
       ## Connection options. For a complete list, see:
       ## https://docs.mongodb.com/manual/reference/connection-string/#connections-connection-options
       #
       options:
         authSource: admin
   

2. Reinicia el Agent.

Detección automática de bases de datos

A partir del Datadog Agent v7.56, puedes habilitar la detección automática de bases de datos para recopilar automáticamente métricas de todas tus bases de datos en la instancia MongoDB. Ten en cuenta que la detección automática de bases de datos está deshabilitada por defecto. Se requiere acceso de lectura a las bases de datos detectadas automáticamente para recopilar métricas de ellas. Para habilitarlo, añade la siguiente configuración a tu archivo mongo.d/conf.yaml:

   init_config:

   instances:
       ## @param hosts - lista de cadenas - necesario
       ## Hosts de los que recopilar métricas, según la conveniencia de la topología de tu despliegue.
       ## Por ejemplo, para un despliegue independiente, especifica el nombre de host y el puerto de la instancia mongod.
       ## Para conjuntos de réplicas o clústeres fragmentados, consulta las instrucciones en el conf.yaml de ejemplo.
       ## Sólo especifica varios hosts cuando la conexión se realice a través de mongos.
       #
     - hosts:
         - <HOST>:<PORT>

       ## @param nombre de usuario - cadena - opcional
       ## Nombre de usuario para la autenticación.
       #
       nombre de usuario: datadog

       ## @param contraseña - cadena - opcional
       ## Contraseña para la autenticación.
       #
       contraseña: <UNIQUE_PASSWORD>

       ## @param opciones - asignación - opcional
       ## Opciones de conexión. Para ver una lista completa, consulta:
       ## https://docs.mongodb.com/manual/reference/connection-string/#connections-connection-options
       #
       opciones:
         authSource: administrador

       ## @param detección automática de bases de datos - asignación - opcional
       ## Habilita la detección automática de bases de datos para recopilar métricas automáticamente de todas tus bases de datos MongoDB.
       #
       detección automática de bases de datos:
         ## @param habilitado - booleano - necesario
         ## Habilita la detección automática de bases de datos.
         #
         habilitado: true

         ## @param incluir - lista de cadenas - opcional
         ## Lista de bases de datos para incluir en la detección automática. Utiliza expresiones regulares para emparejar varias bases de datos.
         ## Por ejemplo, para incluir todas las bases de datos que comienzan con "mydb", utiliza "^mydb.*".
         ## Por defecto, la inclusión está configurada en ".*" y todas las bases de datos están incluidas.
         #
         incluir:
            - "^mydb.*"

         ## @param excluir - lista de cadenas - opcional
         ## Lista de bases de datos para excluir de la detección automática. Utiliza expresiones regulares para emparejar varias bases de datos.
         ## Por ejemplo, para excluir todas las bases de datos que comienzan con "mydb", utiliza "^mydb.*"
         ## En caso de conflicto entre la lista de inclusión y la lista de exclusión, esta última tiene prioridad.
         #
         excluir:
            - "^mydb2.*"
            - "admin$"

         ## @param máximo de bases de datos - entero - opcional
         ## Número máximo de bases de datos de las que recopilar métricas. El valor por defecto es 100.
         #
         máximo de bases de datos: 100

         ## @param intervalo de actualización - entero - opcional
         ## Intervalo de actualización de la lista de bases de datos en segundos. El valor por defecto es 600 segundos.
         #
         intervalo de actualización: 600

2. Reinicia el Agent.

Recopilación de trazas

Datadog APM se integra con Mongo para ver las trazas en todo el sistema distribuido. La recopilación de trazas se encuentra habilitada de manera predeterminada en el Datadog Agent versión 6 o posterior. Para empezar a recopilar trazas:

1. Habilita la recopilación de trazas en Datadog.
2. Instrumenta la aplicación que realiza solicitudes a Mongo.

Recopilación de logs

Disponible para la versión 6.0 o posterior del Agent

1. La recopilación de logs está deshabilitada por defecto en el Datadog Agent; habilítala en tu archivo datadog.yaml:

   logs_enabled: true
   

2. Añade este bloque de configuración a tu archivo mongo.d/conf.yaml para empezar a recopilar logs de MongoDB:

   logs:
     - type: file
       path: /var/log/mongodb/mongodb.log
       service: mongo
       source: mongodb
   

   Cambia los valores de los parámetros service y path y configúralos para tu entorno. Para ver todas las opciones de configuración disponibles, consulta el mongo.yaml de ejemplo.

3. Reinicia el Agent.

Docker

Para configurar este check para un Agent que se ejecuta en un contenedor:

Recopilación de métricas

Configura plantillas de integraciones de Autodiscovery como etiquetas (labels) Docker en el contenedor de tu aplicación:

LABEL "com.datadoghq.ad.check_names"='["mongo"]'
LABEL "com.datadoghq.ad.init_configs"='[{}]'
LABEL "com.datadoghq.ad.instances"='[{"hosts": ["%%host%%:%%port%%"], "username": "datadog", "password" : "<UNIQUEPASSWORD>", "database": "<DATABASE>"}]'

Recopilación de logs

La recopilación de logs se encuentra deshabilitada de manera predeterminada en el Datadog Agent. Para habilitarla, consulta la recopilación de logs de Docker.

Luego, configura integraciones de logs como etiquetas Docker:

LABEL "com.datadoghq.ad.logs"='[{"source":"mongodb","service":"<SERVICE_NAME>"}]'

Recopilación de trazas

APM para aplicaciones en contenedores es compatible con el Agent v6 o posterior, pero requiere configuración adicional para empezar a recopilar trazas.

Variables de entorno requeridas en el contenedor del Agent:

Para ver una lista completa de las variables de entorno y la configuración disponibles, consulta Rastreo de aplicaciones Docker.

A continuación, instrumenta tu contenedor de aplicación y define DD_AGENT_HOST en el nombre de tu contenedor del Agent.

Kubernetes

Para Configurar este check para un Agent que se ejecuta en Kubernetes:

Recopilación de métricas

Configura plantillas de integraciones Autodiscovery como anotaciones de pod en tu contenedor de aplicación. Las plantillas también se pueden configurar con un archivo, un configmap o un almacén de clave-valor.

Anotaciones v1 (para el Datadog Agent v7.36 o anterior)

apiVersion: v1
kind: Pod
metadata:
  name: mongo
  annotations:
    ad.datadoghq.com/mongo.check_names: '["mongo"]'
    ad.datadoghq.com/mongo.init_configs: '[{}]'
    ad.datadoghq.com/mongo.instances: |
      [
        {
          "hosts": ["%%host%%:%%port%%"],
          "username": "datadog",
          "password": "<UNIQUEPASSWORD>",
          "database": "<DATABASE>"
        }
      ]      
spec:
  containers:
    - name: mongo

Anotaciones v2 (para el Datadog Agent v7.36 o posterior)

apiVersion: v1
kind: Pod
metadata:
  name: mongo
  annotations:
    ad.datadoghq.com/mongo.checks: |
      {
        "mongo": {
          "init_config": {},
          "instances": [
            {
              "hosts": ["%%host%%:%%port%%"],
              "username": "datadog",
              "password": "<UNIQUEPASSWORD>",
              "database": "<DATABASE>"
            }
          ]
        }
      }      
spec:
  containers:
    - name: mongo

Recopilación de logs

La recopilación de logs se encuentra deshabilitada de manera predeterminada en el Datadog Agent. Para habilitarla, consulta la recopilación de logs de Kubernetes.

Luego, configura las integraciones de logs como anotaciones de pod. Esto también se puede configurar con un archivo, un mapa de configuración o un almacén de clave-valor.

Anotaciones v1/v2

apiVersion: v1
kind: Pod
metadata:
  name: mongo
  annotations:
    ad.datadoghq.com/mongo.logs: '[{"source":"mongodb","service":"<SERVICE_NAME>"}]'
spec:
  containers:
    - name: mongo

Recopilación de trazas

APM para aplicaciones en contenedores es compatible con hosts que se ejecutan en la versión 6 o posteriores del Agent, pero requiere configuración adicional para empezar a recopilar trazas.

Variables de entorno requeridas en el contenedor del Agent:

Para ver una lista completa de las variables de entorno y la configuración disponibles, consulta Rastreo de aplicaciones Kubernetes y la configuración del DaemonSet de Kubernetes.

Luego, instrumenta tu contenedor de aplicaciones y configura DD_AGENT_HOST con el nombre del contenedor de tu Agent.

ECS

Para configurar este check para un Agent que se ejecuta en ECS:

Recopilación de métricas

Configura plantillas de integraciones de Autodiscovery como etiquetas (labels) Docker en el contenedor de tu aplicación:

{
  "containerDefinitions": [{
    "name": "mongo",
    "image": "mongo:latest",
    "dockerLabels": {
      "com.datadoghq.ad.check_names": "[\"mongo\"]",
      "com.datadoghq.ad.init_configs": "[{}]",
      "com.datadoghq.ad.instances": "[{\"hosts\": [\"%%host%%:%%port%%\"], \"username\": \"datadog\", \"password\": \"<UNIQUEPASSWORD>\", \"database\": \"<DATABASE>\"}]"
    }
  }]
}

Recopilación de logs

Disponible para la versión 6.0 o posterior del Agent

La recopilación de logs se encuentra deshabilitada de manera predeterminada en el Datadog Agent. Para habilitarla, consulta la recopilación de logs de ECS.

Luego, configura integraciones de logs como etiquetas Docker:

{
  "containerDefinitions": [{
    "name": "mongo",
    "image": "mongo:latest",
    "dockerLabels": {
      "com.datadoghq.ad.logs": "[{\"source\":\"mongodb\",\"service\":\"<SERVICE_NAME>\"}]"
    }
  }]
}

Recopilación de trazas

APM para aplicaciones en contenedores es compatible con el Agent v6 o posterior, pero requiere configuración adicional para empezar a recopilar trazas.

Variables de entorno requeridas en el contenedor del Agent:

Para ver una lista completa de las variables de entorno y la configuración disponibles, consulta Rastreo de aplicaciones Docker.

Luego, instrumenta tu contenedor de aplicaciones y configura DD_AGENT_HOST en la dirección IP privada de EC2.