Docs Menu
Docs Home
/ /

Integración con servicios de terceros

You can integrate Atlas with third-party monitoring services to receive Atlas alerts in various external monitoring services, and to view and analyze performance metrics that Atlas collects about your cluster.

To view third-party integration settings, you must have Organization Ownero acceso al Project Owner proyecto.

Nota

Antes de ejecutar cualquier comando de Atlas CLI, debe:

  • Instalar el Atlas CLI

  • Conéctate a Atlas CLI

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

atlas integrations create DATADOG [options]

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

Para crear o actualizar una integración de Opsgenie mediante la CLI de Atlas, ejecute el siguiente comando:

atlas integrations create OPS_GENIE [options]

Para obtener más información sobre la sintaxis y los parámetros del comando, consulte la documentación de la CLI de Atlas para las integraciones de Atlas para crear OPS_GENIE.

Para crear o actualizar una integración de PagerDuty mediante la CLI de Atlas, ejecute 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 mediante la CLI de Atlas, ejecute el siguiente comando:

atlas integrations create VICTOR_OPS [options]

Para obtener más información sobre la sintaxis y los parámetros del comando, consulte la documentación de la CLI de Atlas para las integraciones de Atlas para crear VICTOR_OPS.

Para crear o actualizar una integración de webhook mediante la CLI de Atlas, ejecute el siguiente comando:

atlas integrations create WEBHOOK [options]

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

Para enumerar todas las integraciones de terceros para un proyecto mediante la CLI de Atlas, ejecute el siguiente comando:

atlas integrations list [options]

Para devolver los detalles de una integración de terceros mediante la CLI de Atlas, ejecute el siguiente comando:

atlas integrations describe <integrationType> [options]

Para obtener más información sobre la sintaxis y los parámetros de los comandos anteriores, consulte la documentación de Atlas CLI para obtener la lista de integraciones de Atlas y la descripción de las integraciones de Atlas.

Tip

Consulte: Enlaces relacionados

Para eliminar una integración de terceros mediante la CLI de Atlas, ejecute el siguiente comando:

atlas integrations delete <integrationType> [options]

Para obtener más información sobre la sintaxis y los parámetros del comando, consulte la documentación de la CLI de Atlas para eliminar 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, haga clic en Project Settings.

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

Haga clic en Configure para el servicio de terceros que desea modificar. Puede configurar una o más de las siguientes opciones:

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 tiene una cuenta Datadog existente, regístrese para obtener una.

  • Datadog API Key

  • Región 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 tarjeta adaptable de 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 16de2021 junio, New Relic ya no ofrece compatibilidad con la integración basada en plugins con MongoDB. No recomendamos registrarse para la integración basada en plugins. Para obtener más información, consulte la Declaración de fin de vida útil de los plugins de New Relic.

Configura Atlas para enviar datos métricos sobre su implementación a New Relic para su visualización a través del complemento MongoDB de New Relic. También puede usar Insights para New Relic para ejecutar análisis de los datos recopilados. Atlas envía a New Relic los mismos datos métricos que se muestran en las 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 la API de Insights

    • Clave de query de la API de Perspectivas

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

Si alguna de las claves deja de ser válida posteriormente, Atlas envía un correo electrónico al propietario del proyecto y finalmente elimina las credenciales no válidas.

OpsGenie API Key

Establece una clave API para la API de alertas de OpsGenie. Esta se usará como clave API de OpsGenie predeterminada al configurar las alertas. (Tenga en cuenta que esta integración enviará la alerta a la cuenta configurada, no al equipo).

  • Si tiene una cuenta de OpsGenie, ingrese la siguiente información:

    • Clave API de integración de OpsGenie, que OpsGenie proporciona tras crear una integración de API en un equipo de OpsGenie. No se pueden usar claves API generales de cuentas de OpsGenie para la integración de Atlas.

    • Región API (Estados Unidos o Europa)

  • Si no tiene una cuenta OpsGenie, regístrese para obtener una.

PagerDuty Service Key

Establece una clave de servicio predeterminada para las notificaciones de alerta enviadas a una cuenta de PagerDuty. Atlas introduce la clave de forma predeterminada al añadir una notificación de PagerDuty a una configuración de alertas. Si se añaden notificaciones de PagerDuty y la clave utilizada para enviarlas deja de ser válida, Atlas envía un correo electrónico al propietario del proyecto y, finalmente, elimina 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

Sets a team name, API token and a channel name for alert notifications sent to a Slack account. To configure a Slack integration with OAuth2, click Configure and then Sign in with Slack.

When you sign in, you are taken to a Slack landing page where you may select a workspace and configure permissions. After configuring Slack to connect to Atlas, your API token is automatically generated and maintained. Atlas redirects you back to the Integrations page.

After initially configuring Slack with Atlas, you can Edit or Remove the integration. When you edit the integration, Atlas displays your team name and API token, and allow you to change your channel name.

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

Le conecta con la documentación relevante de SumoLogic para configurar SumoLogic con Atlas. No necesita configurar ningún ajuste en Atlas para configurar una integración con 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

Adds a Webhook URL endpoint to which Atlas can send alert notifications for programmatic processing. Atlas sends an alert notification as an HTTP POST request. The request body contains a JSON document that uses the same format as the Atlas Administration API Alerts resource.

Atlas añade 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 acaba de abrirse.

alert.close

La alerta se resolvió.

alert.update

Una alerta abierta previamente todavía está abierta.

alert.acknowledge

La alerta fue reconocida.

alert.cancel

La alerta dejó de ser válida y fue cancelada.

alert.inform

Representa una alerta informativa, que es un evento de copia de seguridad continua en la nube, como "Elegido principal".

If you specify a key in the Webhook Secret field, Atlas adds the X-MMS-Signature request header. This header contains the Base64-encoded HMAC-SHA-1 signature of the request body. Atlas creates the signature using the provided secret.

To send alert notifications to a Webhook, select the Webhook notification option when creating or editing an alert. If you add a Webhook notification and the URL or optional key becomes invalid, Atlas sends an email to the project owner and eventually removes the Webhook settings.

IMPORTANTE: Si la configuración de su firewall lo requiere, permita el acceso desde las direcciones IP de Atlas para que Atlas pueda comunicarse con su 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 muestra un punto de integración europeo para el servicio, Atlas no lo admite. Actualmente, solo OpsGenie y DataDog ofrecen puntos de integración europeos independientes.

Volver

Métricas disponibles

En esta página