Make the MongoDB docs better! We value your opinion. Share your feedback for a chance to win $100.
MongoDB Branding Shape
Click here >
Docs Menu

Integrar con servicios de terceros

Puedes integrar Atlas con servicios de supervisión de terceros para recibir alertas de Atlas en varios servicios externos de supervisión, así como ver y analizar métricas de rendimiento que Atlas recopila sobre tu clúster.

Para ver los ajustes de integración de terceros, debes tener Organization Owner o Project Owner acceso al proyecto.

Nota

Antes de ejecutar cualquier comando de Atlas CLI, debe:

Para crear o actualizar una integración de Datadog usando la Atlas CLI, ejecuta el siguiente comando:

atlas integrations create DATADOG [options]

Para obtener más información sobre la sintaxis del comando y los parámetros, consulte la documentación de Atlas CLI para atlas integrations create DATADOG.

Para crear o actualizar una integración de Opsgenie con Atlas CLI, ejecuta el siguiente comando:

atlas integrations create OPS_GENIE [options]

Para obtener más información sobre la sintaxis del comando y los parámetros, consulte la documentación de Atlas CLI sobre atlas integrations create OPS_GENIE.

Para crear o actualizar una integración de PagerDuty utilizando el Atlas CLI, ejecutar el siguiente comando:

atlas integrations create PAGER_DUTY [options]

Para obtener más información sobre la sintaxis del comando y los parámetros, consulta la documentación del Atlas CLI para atlas integrations create PAGER_DUTY.

Para crear o actualizar una integración de VictorOps usando el Atlas CLI, ejecute el siguiente comando:

atlas integrations create VICTOR_OPS [options]

Para obtener más información sobre la sintaxis de comandos y los parámetros, consulta la documentación de Atlas CLI para atlas integrations create VICTOR_OPS.

Para crear o actualizar una integración de webhook usando el CLI de Atlas, ejecuta el siguiente comando:

atlas integrations create WEBHOOK [options]

Para obtener más información sobre la sintaxis del comando y los parámetros, consulte la documentación de Atlas CLI para atlas integrations create WEBHOOK.

Para enumerar todas las integraciones de terceros para un proyecto utilizando Atlas CLI, ejecuta el siguiente comando:

atlas integrations list [options]

Para devolver los detalles de una integración de un tercero utilizando la Atlas CLI, ejecutar el siguiente comando:

atlas integrations describe <integrationType> [options]

Para aprender más sobre la sintaxis y los parámetros de los comandos anteriores, consulta la documentación de Atlas CLI para atlas integrations list y atlas integrations describe.

Tip

Consulte: Enlaces relacionados

Para borrar una integración de terceras partes mediante Atlas CLI, ejecute el siguiente comando:

atlas integrations delete <integrationType> [options]

Para obtener más información sobre la sintaxis de comando y los parámetros, consulta la documentación de Atlas CLI para borrar integraciones de atlas.

Para modificar la configuración de integración de terceros mediante la Interfaz de Usuario de Atlas:

1
  1. Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.

  2. Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.

  3. En la barra lateral, haz clic en el icono junto a Project Overview.

La página Configuración del proyecto se muestra.

2

Haz clic en la pestaña Integrations.

La página de Integraciones del proyecto se muestra.

3

Haz clic en Configure para el servicio de terceros que deseas modificar. Puede establecer uno o más de los siguientes:

Servicio de terceros
Detalles de configuración

Datadog Settings

Configura Atlas para enviar datos de métricas sobre tu implementación a Datadog. Puedes ver estas métricas en tus tableros de Datadog. Para descubrir la lista detallada de todas las métricas de Atlas que Datadog rastrea, consulta la página de Integración de Datadog.

  • Si tienes una cuenta de Datadog, utiliza Datadog para empezar a rastrear tus datos de métricas en Atlas.

  • Si no tienes una cuenta actual de Datadog, regístrate en una.

  • Datadog API Key

  • Región de la API

    Atlas admite las siguientes regiones de Datadog en la interfaz de usuario de Atlas:

    • US1

    • US3

    • US5

    • EU1

    • AP1

    Datadog utiliza US1 por defecto.

    Para aprender más sobre las regiones de Datadog, se puede consultar Sitios de Datadog.

Microsoft Teams Settings

Configura Atlas para enviar alertas sobre tu proyecto a tu canal de Microsoft Teams. Puedes ver estas alertas en la Adaptive Card que se muestra en tu canal.

Para enviar notificaciones de alerta a un canal de Microsoft Teams, se debe crear un webhook entrante de Microsoft Teams. Después de crear el webhook, se puede usar la URL generada automáticamente para configurar la integración de Microsoft Teams en Atlas.

Para configurar la integración, se puede consultar Integrarse con Microsoft Teams.

New Relic Settings

IMPORTANTE: A partir del miércoles, 16de junio de 2021, New Relic ya no admite la integración basada en complementos con MongoDB. No recomendamos registrarse a la integración basada en complementos. Para más detalles, consulta la instrucción de fin de vida del plugin New Relic.

Configura Atlas para enviar datos de métricas sobre la implementación a New Relic. para su visualización a través del plugin New Relic MongoDB. También se pueden usar perspectivas para New Relic para ejecutar análisis sobre los datos recopilados. Atlas envía a New Relic los mismos datos métricos que se muestran en Métricas del clúster de Atlas.

  • Si tienes una cuenta de New Relic, ingresa la siguiente información:

    • ID de cuenta

    • Clave de licencia

    • Clave de inserción de Insights API

    • Clave de query de la API de Perspectivas

  • Si no tienes una cuenta de New Relic, regístrate para obtener una.

Si alguna de las claves posteriormente se vuelve inválida, Atlas envía un correo electrónico al propietario del Proyecto y, finalmente, remueve las credenciales inválidas.

OpsGenie API Key

Establece una clave de API para API de alerta OpsGenie. Se usará como clave de API de OpsGenie por defecto al configurar las alertas. (Se debe tener en cuenta que esta integración enviará la alerta a la cuenta configurada, no al equipo).

  • Si tienes una cuenta de OpsGenie, ingresa la siguiente información:

    • Clave API de integración de OpsGenie, que OpsGenie proporciona después de que usted cree una integración de API bajo un equipo de OpsGenie. No puedes usar las claves API generales de cuentas OpsGenie para la integración con Atlas.

    • Región de API (Estados Unidos o Europa)

  • Si no tienes una cuenta de OpsGenie, regístrate para obtener una.

PagerDuty Service Key

Establece una clave de servicio por defecto para las notificaciones de alertas enviadas a una cuenta de PagerDuty. Atlas ingresa la clave por defecto cuando agregas una notificación de PagerDuty a una configuración de alerta. Si agregas notificaciones de PagerDuty y la clave utilizada para enviar las notificaciones se vuelve inválida, Atlas envía un correo electrónico al propietario del proyecto y, eventualmente, remueve la clave.

Los usuarios pueden reconocer las alertas de PagerDuty únicamente desde el tablero de PagerDuty.

Todas las nuevas claves de PagerDuty utilizan su API de Eventos v2.

Si se tiene una clave de la API de eventos v1, se puede seguir utilizando con Atlas.

Slack Settings

Establece un nombre de equipo, un token de API y un nombre de canal para enviar notificaciones de alerta a una cuenta de Slack. Para configurar una integración de Slack con OAuth2, haga clic en Configure y luego en Sign in with Slack.

Cuando inicies sesión, se te llevará a una página de bienvenida de Slack donde podrás seleccionar un espacio de trabajo y configurar los permisos. Después de configurar Slack para conectarse a Atlas, el token de API se genera y mantiene automáticamente. Atlas te redirige de nuevo al Integrations page.

Después de configurar inicialmente Slack con Atlas, puedes Edit o Remove la integración. Cuando editas la integración, Atlas muestra el nombre de tu equipo y el token API, y te permite cambiar el nombre de tu canal.

IMPORTANTE: Atlas discontinuó los tokens heredados. No se puede configurar una nueva integración de Slack con tokens heredados ni editar ningún token heredado existente. Puedes seguir usando tokens heredados si los has usado para configurar una integración de Slack antes de la desaprobación. Sin embargo, debes reconfigurar tu integración de Slack con OAuth2 si necesitas editar la configuración de tu token.

SumoLogic Settings

Te conecta con la documentación relevante de SumoLogic para configurar SumoLogic con Atlas. No necesitas configurar ninguna configuración dentro de Atlas para configurar una integración de SumoLogic.

VictorOps Settings

Establece una clave API y una clave de enrutamiento para las notificaciones de alerta enviadas a una cuenta de Splunk On-Call (anteriormente VictorOps). Atlas utiliza esta información como la configuración por defecto al configurar alertas.

Webhook Settings

Agrega un endpoint Webhook URL al que Atlas puede enviar notificaciones de alertas para su procesamiento programático. Atlas envía una notificación de alerta como solicitud HTTP publicación. El cuerpo de la solicitud contiene un documento JSON que utiliza el mismo formato que el recurso Alerts de la API de administración de Atlas.

Atlas agrega un encabezado de solicitud llamado X-MMS-Event para distinguir entre varios estados de alerta. Los valores posibles para este encabezado son:

alert.open

La alerta se acaba de abrir.

alert.close

La alerta se resolvió.

alert.update

Una alerta previamente abierta aún está abierta.

alert.acknowledge

La alerta fue reconocida.

alert.cancel

La alerta se volvió inválida y fue cancelada.

alert.inform

Representa una alerta informativa, que es un evento de respaldo continuo en la nube, como "Principal elegido".

Si especifica una clave en el campo Webhook Secret, Atlas agrega la cabecera de solicitud X-MMS-Signature. Este encabezado contiene la firma64 HMAC-SHA-codificada en Base1 del cuerpo de la solicitud. Atlas crea la firma utilizando el secreto proporcionado.

Para enviar notificaciones de alerta a un Webhook, seleccionar la opción de notificación de Webhook al crear o editar una alerta. Si se agrega una notificación de Webhook y la URL o la clave opcional deja de ser válida, Atlas envía un correo electrónico al propietario del proyecto y remueve la configuración del Webhook.

IMPORTANTE: Si la configuración de tu firewall lo requiere, permite el acceso desde direcciones IP de Atlas para que Atlas pueda comunicarse con tu webhook.

Prometheus Settings

Configura Atlas para enviar datos métricos sobre tu implementación a tu instancia de Prometheus . Para obtener más información, consulta Integración con Prometheus.

Nota

Si esta tabla no mostró un punto de integración europeo para el servicio, Atlas no lo admite. Actualmente, solo OpsGenie y DataDog ofrecen integraciones europeas separadas.