Conectar o New Relic
Conecte uma conta do New Relic para trazer os hosts de infraestrutura, os serviços de APM e os monitores sintéticos dela para o Excubius, com as métricas principais (golden metrics) e os problemas abertos. Este guia mostra a configuração com privilégios mínimos no lado do New Relic, como adicionar a fonte e como enviar os problemas por webhook.
Antes de começar
- Você precisa da função Entity admin (Administrador de entidade) na entidade à qual a conta pertence, por exemplo Veredas Ltda..
- No New Relic, você pode criar um usuário ou um usuário de serviço, uma chave de API e um fluxo de trabalho na conta.
- O recurso
sources.newrelicestá ativado. Consulte Fontes.
O que o Excubius lê
O New Relic é lido por meio do NerdGraph, apenas com consultas GraphQL, nunca com mutações.
| Fase | O quê | Intervalo padrão |
|---|---|---|
| Inventário | Pesquisa de entidades na conta: hosts de infraestrutura (Windows, Linux ou macOS pela marca de sistema operacional), aplicativos de APM e monitores sintéticos, opcionalmente restringidos por uma condição de pesquisa de entidades | 15 minutos |
| Métricas | Os resumos que a mesma pesquisa retorna, sem NRQL, por isso consomem pouca cota. CPU, memória e disco dos hosts alimentam as verificações de hosts Windows e Linux; o APM e os monitores sintéticos alimentam as verificações do New Relic | 5 minutos |
| Alertas | Problemas de IA (AI issues) nos estados CREATED e ACTIVATED dos últimos 30 dias, um alerta por problema e entidade | 5 minutos em Polling; reconciliação a cada 15 minutos em Hybrid |
Preparar o New Relic
- Crie um usuário, ou use um usuário de serviço, cuja função seja read only na conta, por exemplo a função interna All product read only.
- Conectado como esse usuário, abra API keys e crie uma chave do tipo User. Copie a chave; ela começa com
NRAK-. As chaves de licença, de navegador e de ingestão não funcionam. - Anote o account ID e o datacenter, US ou EU.
Essa chave de usuário é tudo de que o Excubius precisa para fazer a sondagem. Uma fonte no modo Webhook only não precisa da chave nem do ID da conta.
Adicionar a fonte
- Abra Settings › Sources, selecione Add a source e escolha New Relic.
- Em General, digite um Name, como New Relic Veredas, e escolha a Entity.
- Em Connection, digite o Account ID, a Region e a User API key.
- Em What to read, mantenha Hosts, APM services, Synthetic monitors e Golden metrics ou desmarque o que você não quer. Sem Golden metrics, as entidades chegam sem as métricas delas.
- Se quiser, digite um Entity filter, uma condição de pesquisa de entidades do New Relic como
tags.environment = 'production'. Use-o quando uma conta abranger vários clientes. - Em Ingest mode, mantenha Hybrid (recommended).
- Se quiser, em Webhook, digite um Webhook secret que o New Relic enviará com cada webhook.
- Selecione Create source e copie a URL do webhook. Ela é exibida apenas uma vez.
Enviar problemas por webhook
No modo Hybrid ou Webhook only, configure o New Relic para enviar os problemas dele:
-
No New Relic, abra Alerts › Destinations e adicione um destino Webhook com a URL que o Excubius mostrou. Se você definiu um segredo de webhook, adicione o cabeçalho
Authorization: Bearer <secret>ouX-Webhook-Secret: <secret>. -
Crie um workflow que filtre os problemas que você quer no Excubius e notifique esse destino com este modelo de payload:
O modelo padrão do New Relic também funciona.
-
Notifique nos estados activated e closed, para que os alertas também sejam fechados no Excubius.
Testar e sincronizar
- Na página da fonte, selecione Test. Cada leitura é listada com o resultado: credenciais, conta, inventário e alertas.
- Selecione Sync now para trazer o inventário, as métricas e os alertas sem esperar.
Os hosts aparecem como recursos, correspondidos com os mesmos servidores de outras fontes. Os serviços de APM aparecem como recursos Application (APM) e os monitores como recursos Synthetic monitor, com as verificações deles. Os problemas abertos aparecem na Alert inbox, com um link para o New Relic.
Escolher o modo
| Modo | Você obtém |
|---|---|
| Hybrid | Problemas imediatamente por webhook; inventário e métricas por sondagem; uma reconciliação que fecha o que foi fechado no New Relic enquanto um webhook se perdeu |
| Polling | Tudo por sondagem. Os problemas aparecem dentro do intervalo de alertas, 5 minutos por padrão |
| Webhook only | Apenas os problemas, sem inventário nem métricas e sem nenhuma chave armazenada |