• EnglishEspañol日本語한국어Português
  • Inicia sesiónComenzar ahora

Te ofrecemos esta traducción automática para facilitar la lectura.

En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.

Crea una propuesta

MongoDB monitoreo integración (legacy)

¡IMPORTANTE!

Esta integración legacy llegará al final de su vida útil en 2024: agregaremos una fecha de EOL específica cuando la sepamos. Recomendamos utilizar nuestra nueva integración MongoDB. Para obtener información sobre cómo cambiar de la integración legacy a la nueva, consulte nuestros documentos de migración.

Nuestra integración MongoDB legacy recopila y envía inventario y métricas de su clúster MongoDB a nuestra plataforma, donde puede agregar y visualizar el rendimiento métrico clave. Recopilamos datos en mongos y mongod instancia, servidores de configuración, así como en base de datos y colecciones para ayudar a identificar el rendimiento de la botella.

Compatibilidad y requisitos

Esta integración legacy es compatible con MongoDB v3 y v4. Nuestra nueva integración de MongoDB admite versiones más nuevas.

Antes de instalar esta integración legacy, asegúrese de cumplir con los siguientes requisitos:

Instalar y activar

Si desea instalar nuestra integración MongoDB legacy, siga las instrucciones para su entorno:

' '

Notas adicionales:

Configuración

Habilitando su servidor MongoDB

En el shell de MongoDB, ejecute los siguientes comandos para crear un rol listCollections y un nuevo usuario. Luego, asigne los roles clusterMonitor y listCollections al nuevo usuario. Nota: Reemplace el nombre de usuario, la contraseña y valores específicos de usuario similares.

Consulte la documentación de MongoDB para obtener detalles sobre la creación de usuarios y roles.

Sugerencia

Complete estos pasos en los mongos a monitorear. Si se van a recopilar métricas a nivel de mongod, como estadísticas de host o conjunto de réplicas, cree también el rol y el usuario en cada mongod.

  1. En el shell de MongoDB, ingrese use admin.

  2. Utilice el siguiente comando para crear el rol listCollections .

    db.createRole({
    role: "listCollections",
    privileges: [{
    resource: {db:"",collection:""},
    actions: ["listCollections"]
    }],
    roles: []
    })
  3. Utilice los siguientes comandos para crear un nuevo usuario y asignarle los roles clusterMonitor y listCollections .

    db.createUser({
    user: "username",
    pwd: "password",
    roles: [
    "clusterMonitor",
    "listCollections"
    ]
    })

¿Te ha ayudado este documento con la instalación?

Configurar la integración

Hay varias formas de configurar la integración, dependiendo de cómo se instaló:

La configuración de formato YAML de una integración es donde puede colocar las credenciales de inicio de sesión requeridas y configurar cómo se recopilan los datos. Las opciones que cambie dependen de su configuración y preferencia.

El archivo de configuración tiene configuraciones comunes aplicables a todas las integraciones, como interval, timeout, inventory_source. Para leer todo sobre estas configuraciones comunes, consulte nuestro documento Formato de configuración .

Importante

Si todavía estás usando nuestros archivos de configuración/definición legacy, consulta el formato de configuración estándar para obtener ayuda.

Las configuraciones específicas relacionadas con MongoDB se definen usando la sección env del archivo de configuración. Estas configuraciones controlan la conexión a su instancia de MongoDB, así como otras configuraciones y características de seguridad. La lista de configuraciones válidas se describe en la siguiente sección de este documento.

La integración de MongoDB se puede configurar para monitor un clúster de MongoDB completo o una instancia de MongoDB independiente. Para monitor un clúster, los argumentos host y port deben apuntar a una de las mongos instancias en su clúster. Si desea monitor una instancia independiente, asegúrese de que host y port apunten al mongod que ejecuta la base de datos.

Sugerencia

La autenticación SCRAM no es compatible.

Configuración de la instancia de MongoDB

La integración MongoDB recopila información tanto métrica como de inventario. En la siguiente tabla, consulte la columna Applies To para conocer la configuración disponible para cada colección.

Los valores para estas configuraciones se pueden definir de varias maneras:

  • Agregando el valor directamente en el archivo de configuración. Esta es la forma más común.
  • Reemplazar los valores de las variables de entorno usando la notación {{}} . Esto requiere el agente de infraestructura v1.14.0 o superior. Para obtener más información, consulte nuestra documentación sobre el paso a través o consulte el ejemplo de reemplazo.
  • Utilizando la gestión de secretos. Utilícelo para proteger información confidencial, como contraseñas que quedarían expuestas en texto sin formato en el archivo de configuración. Para obtener más información, consulte Gestión de secretos.

' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' '

Configuración

Descripción

Se aplica a

MONGODB_CLUSTER_NAME

Nombre definido por el usuario para identificar de forma única el clúster que se está monitoreando. Required.

Métrica/Inventario

HOST

Nombre de host o IP donde se está ejecutando MongoDB. El valor predeterminado es localhost.

Métrica/Inventario

PORT

Puerto en el que MongoDB está escuchando. El valor predeterminado es 27017.

Métrica/Inventario

USERNAME

Nombre de usuario para acceder al servidor MongoDB.

Métrica/Inventario

PASSWORD

Contraseña para el usuario dado.

Métrica/Inventario

AUTH_SOURCE

La base de datos contra la que autenticarse. El valor predeterminado es admin.

Métrica/Inventario

SSL

Utilice SSL cuando se comunique con el servidor MongoDB. El valor predeterminado es false.

Métrica/Inventario

SSL_CA_CERTS

Ubicación del certificado SSL en el host. Solo es necesario si SSL es true.

Métrica/Inventario

SSL_INSECURE_SKIP_VERIFY

Omita la verificación de la cadena de certificados y el nombre de host del servidor. El valor predeterminado es false.

Métrica/Inventario

PEM_KEY_FILE

Ubicación del archivo PEM que contiene la clave privada y el certificado de cliente.

Métrica/Inventario

PASSPHRASE

Frase de contraseña para descifrar el archivo PEMKeyFile .

Métrica/Inventario

CONCURRENT_COLLECTIONS

Número de entidad para recolectar métrica simultáneamente. El valor predeterminado es 50.

Métrica

FILTERS

Un mapa JSON de nombres de bases de datos a una matriz de nombres de colecciones. Si está vacío, el valor predeterminado es toda la base de datos y colecciones.

Métrica

METRICS

Establezca en true para habilitar la recopilación solo métrica. El valor predeterminado es false.

INVENTORY

Configúrelo en true para habilitar la recopilación solo de inventario. El valor predeterminado es false.

Etiquetas y atributos personalizados

Puedes decorar aún más tu métrica usando etiquetas. Las etiquetas le permiten agregar valor par principal atributo a su métrica, que luego puede usar para consultar, filtrar o agrupar su métrica.

Nuestro archivo de configuración de muestra predeterminado incluye ejemplos de etiquetas; sin embargo, como no son obligatorios, puedes eliminar, modificar o agregar nuevos de tu elección.

labels:
env: production
role: load_balancer

Configuración de ejemplo

Buscar y utilizar datos

Los datos de este servicio se informan a un dashboard de integración.

métricas se adjuntan a estos tipos de eventos:

  • MongoCollectionSample
  • MongoConfigServerSample
  • MongoDatabaseSample
  • MongodTopSample
  • MongoSample
  • MongodSample
  • MongosSample

Puede consultar estos datos para fines de resolución de problemas o para crear gráficos y paneles personalizados.

Para obtener más información sobre cómo encontrar y utilizar sus datos, consulte Comprender los datos de integración.

Datos métricos

La integración MongoDB recopila el siguiente atributo de datos métricos. Algunos nombres de métricas tienen el prefijo de un indicador de categoría y un punto, como asserts. o collection..

Se encuentran disponibles diferentes métricas dependiendo de si se está monitorizando un clúster o una instancia independiente. Para una instancia independiente, solo se recopilan MongodSample, MongoDatabaseSample, MongodTopSample y MongoCollectionSample . Para un clúster, se recopilan todos los tipos de eventos.

Datos de inventario

La integración de MongoDB captura todas las opciones de línea de comando y parámetros configurados en tiempo de ejecución de cada host en el clúster.

Los datos están disponibles en la página Inventario, en la fuente config/mongodb . Para obtener más información sobre los datos de inventario, consulte Comprender los datos de integración.

Comprueba el código fuente

Esta integración es software de código abierto. Eso significa que puedes explorar su código fuente y enviar mejoras, o crear tu propia bifurcación y compilarla.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.