Integre-se com serviços de terceiros
Você pode integrar o Atlas com serviços de monitoramento de terceiros para receber alertas em vários serviços de monitoramento externos e para exibir e analisar métricas de desempenho que o Atlas coleta sobre seu cluster.
Observação
Atualmente, as métricas de instâncias sem servidor não oferecem suporte a nenhum serviço de terceiros (por exemplo, o Datadog).
Acesso necessário
Para visualizar as configurações de integração de terceiros, você deve ter Organization Owner ou Project Owner acesso ao projeto.
Visualizar ou modificar configurações de terceiros.
Observação
Antes de executar comandos Atlas CLI, você deve:
Datadog
Para criar ou atualizar uma integração do Datadog utilizando o Atlas CLI, execute o seguinte comando:
atlas integrations create DATADOG [options]
Para saber mais sobre a sintaxe e os parâmetros do comando, consulte a documentação do Atlas CLI para criar atlas integrations DATADOG.
Opsgenie
Para criar ou atualizar uma integração Opsgenie usando o Atlas CLI, execute o seguinte comando:
atlas integrations create OPS_GENIE [options]
Para saber mais sobre a sintaxe e os parâmetros do comando, consulte a documentação do Atlas CLI para criar atlas integrations OPS_GENIE.
PagerDuty
Para criar ou atualizar uma integração PagerDuty usando o Atlas CLI, execute o seguinte comando:
atlas integrations create PAGER_DUTY [options]
Para saber mais sobre a sintaxe e os parâmetros do comando, consulte a documentação do Atlas CLI para as integrações do atlas create PAGER_DUTY.
VictorOps
Para criar ou atualizar uma integração VictorOps usando o Atlas CLI, execute o seguinte comando:
atlas integrations create VICTOR_OPS [options]
Para saber mais sobre a sintaxe e os parâmetros do comando, consulte a documentação do Atlas CLI para criar atlas integrations VICTOR_OPS.
Webhook
Para criar ou atualizar uma integração webhook usando o Atlas CLI, execute o seguinte comando:
atlas integrations create WEBHOOK [options]
Para saber mais sobre a sintaxe e os parâmetros do comando, consulte a documentação do Atlas CLI para criar atlas integrations WEBHOOK.
Ver integrações de terceiros
Para listar todas as integrações de terceiros para um projeto usando o Atlas CLI, execute o seguinte comando:
atlas integrations list [options]
Para gerar os detalhes de uma integração de terceiros usando o Atlas CLI, execute o seguinte comando:
atlas integrations describe <integrationType> [options]
Para saber mais sobre a sintaxe e os parâmetros do comando dos comandos anteriores, consulte a documentação do Atlas CLI para lista atlas integrations e descrever atlas integrations.
Excluir uma integração de terceiros
Para excluir uma integração de terceiros usando o Atlas CLI, execute o seguinte comando:
atlas integrations delete <integrationType> [options]
Para saber mais sobre a sintaxe e os parâmetros do comando, consulte a documentação do Atlas CLI para excluir atlas integrations.
Para modificar configurações de integração de terceiros usando a IU do Atlas:
No Atlas, acesse a página Project Integrations.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Ao lado do menu Projects, expanda o menu Options e clique em Integrations.
A página Integrações de projeto é exibida.
Configure as integrações de terceiros que você deseja ativar.
Clique em Configure para o serviço de terceiros que você deseja modificar. Você pode definir um ou mais dos seguintes:
Serviço de terceiros | Detalhes de configuração | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Datadog Settings | Você pode configurar o Atlas para enviar dados métricos sobre sua implantação para o Datadog. Você pode visualizar essas métricas em seus dashboards do Datadog. Para descobrir a lista detalhada de todas as métricas do Atlas que o Datadog acompanha, consulte a página Integração do Datadog.
| ||||||||||||
Microsoft Teams Settings | Configura o Atlas para enviar alertas sobre seu projeto para o canal Microsoft Teams. Você pode visualizar esses alertas no Cartão adaptativo exibido em seu canal. Para enviar notificações de alerta para um canal do Microsoft Teams, você deve criar um webhook de entrada do Microsoft Teams. Após criar o webhook, você pode utilizar o URL gerado automaticamente para configurar sua integração do Microsoft Teams no Atlas. Para configurar a integração, consulte Integração com o Microsoft Teams. | ||||||||||||
New Relic Settings | IMPORTANTE: a partir de quarta-feira, 16 de junho de 2021, a New Relic não tem mais compatibilidade com a integração baseada em plug-ins com o MongoDB. Não recomendamos que você se cadastre na opção de integração baseada em plug-ins. Para saber mais, veja a Declaração de fim de vida útil do plugin da New Relic. Configura o Atlas para enviar dados métricos sobre sua implantação para o New Relic para visualização através do plugin New Relic MongoDB. Você também pode usar o Insights for New Relic para executar análises sobre os dados coletados. O Atlas envia à New Relic os mesmos dados métricos exibidos nas métricas do cluster Atlas.
Se alguma das chaves se tornar inválida posteriormente, o Atlas enviará um e-mail para o proprietário do projeto e removerá as credenciais inválidas. | ||||||||||||
OpsGenie API Key | Define uma chave de API para a API OpsGenie Alert. Isso será usado como a chave padrão da API OpsGenie ao configurar alertas. (Observe que essa integração enviará o alerta para a conta configurada, não para a equipe.)
| ||||||||||||
PagerDuty Service Key | Defina uma chave padrão para as notificações de alerta enviadas à uma conta do PagerDuty. O Atlas adiciona automaticamente a chave ao configurar uma notificação do PagerDuty em uma configuração de alerta. Se você configurar notificações do PagerDuty e a chave utilizada para enviá-las se tornar inválida, o Atlas enviará um e-mail para o proprietário do projeto e, eventualmente, removerá a chave. Os usuários podem confirmar os alertas PagerDuty apenas no dashboard do PagerDuty. Todas as novas chaves do PagerDuty usam a API de eventos v2. Se você tiver uma chave de API de eventos v1, poderá continuar a usar essa chave com o Atlas. | ||||||||||||
Slack Settings | Define o nome da equipe, token da API e o nome do canal para as notificações de alerta enviadas para uma conta do Slack. Para configurar uma integração do Slack com OAuth2, clique em Configure e depois em Sign in with Slack. Ao entrar, você é direcionado para uma página de destino do Slack, onde pode selecionar um espaço de trabalho e configurar as permissões. Depois de configurar o Slack para se conectar ao Atlas, seu token de API é gerado e mantido automaticamente. O Atlas redireciona você de volta para o Integrations page. Depois de configurar o Slack com o Atlas, você pode Edit ou Remove a integração. Ao editar a integração, o Atlas mostra o nome de sua equipe e token da API, permitindo também que você modifique o nome do seu canal. IMPORTANTE: os tokens legados do Atlas foram descontinuados. Não é possível configurar uma nova integração do Slack com tokens legados ou editar quaisquer tokens legados existentes. Você pode continuar usando tokens legados se os usou para configurar uma integração com o Slack antes da descontinuação. No entanto, você deverá reconfigurar sua integração do Slack com OAuth2 se precisar editar a configuração do seu token. | ||||||||||||
SumoLogic Settings | Conecta você à documentação SumoLogic relevante para configurar o SumoLogic com o Atlas. Você não precisa definir nenhuma configuração no Atlas para configurar uma integração SumoLogic. | ||||||||||||
VictorOps Settings | Define uma chave de API e uma chave de roteamento para notificações de alerta enviadas para uma conta Splunk On-Call (antiga VictorOps). O Atlas usa essas informações como configurações padrão ao configurar alertas.
| ||||||||||||
Webhook Settings | Adiciona um endpoint Webhook URL para o qual o Atlas pode enviar notificações de alerta para processamento programático. O Atlas envia uma notificação de alerta como uma solicitação HTTP POST. O corpo da solicitação contém um documento JSON que usa o mesmo formato do recurso O Atlas insere o cabeçalho de solicitação
Se você especificar uma chave no campo Webhook Secret, o Atlas adicionará o cabeçalho de solicitação Para enviar notificações de alerta para um Webhook, selecione a opção de notificação Webhook ao criar ou editar um alerta. Se você adicionar uma notificação de Webhook e o URL ou chave opcional se tornar inválida, o Atlas enviará um e-mail para o proprietário do projeto e removerá as configurações do Webhook. IMPORTANTE: se a configuração do firewall exigir isso, permita o acesso dos endereços IP do Atlas para que o Atlas possa se comunicar com o webhook. | ||||||||||||
Prometheus Settings | Configure o Atlas para enviar dados métricos sobre sua implantação para sua instância do Prometheus. Para saber mais, consulte Integrar com o Prometheus. |