Pular para o conteúdo principal
Versão: 0.4 · atual

Conectar o New Relic

Guia de instruçõesRevisado em 11 de outubro de 2026
Aplica-se a:Excubius 0.4Funções: Administrador de entidade
PlanosFree · Core · Pro · EnterpriseImplantaçãoAuto-hospedado

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.newrelic está ativado. Consulte Fontes.

O que o Excubius lê​

O New Relic é lido por meio do NerdGraph, apenas com consultas GraphQL, nunca com mutações.

FaseO quêIntervalo padrão
InventárioPesquisa 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 entidades15 minutos
MétricasOs 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 Relic5 minutos
AlertasProblemas de IA (AI issues) nos estados CREATED e ACTIVATED dos últimos 30 dias, um alerta por problema e entidade5 minutos em Polling; reconciliação a cada 15 minutos em Hybrid

Preparar o New Relic​

  1. 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.
  2. 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.
  3. 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​

  1. Abra Settings › Sources, selecione Add a source e escolha New Relic.
  2. Em General, digite um Name, como New Relic Veredas, e escolha a Entity.
  3. Em Connection, digite o Account ID, a Region e a User API key.
  4. 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.
  5. 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.
  6. Em Ingest mode, mantenha Hybrid (recommended).
  7. Se quiser, em Webhook, digite um Webhook secret que o New Relic enviará com cada webhook.
  8. 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:

  1. 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> ou X-Webhook-Secret: <secret>.

  2. Crie um workflow que filtre os problemas que você quer no Excubius e notifique esse destino com este modelo de payload:

    {
    "issueId": {{ json issueId }},
    "state": {{ json state }},
    "priority": {{ json priority }},
    "title": {{ json annotations.title.[0] }},
    "issuePageUrl": {{ json issuePageUrl }},
    "triggerEvent": {{ json triggerEvent }},
    "createdAt": {{ createdAt }},
    "updatedAt": {{ updatedAt }},
    "conditionNames": {{ json accumulations.conditionName }},
    "policyNames": {{ json accumulations.policyName }},
    "entityGuids": {{ json entitiesData.ids }},
    "entityNames": {{ json entitiesData.names }}
    }

    O modelo padrão do New Relic também funciona.

  3. Notifique nos estados activated e closed, para que os alertas também sejam fechados no Excubius.

Testar e sincronizar​

  1. Na página da fonte, selecione Test. Cada leitura é listada com o resultado: credenciais, conta, inventário e alertas.
  2. 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​

ModoVocê obtém
HybridProblemas 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
PollingTudo por sondagem. Os problemas aparecem dentro do intervalo de alertas, 5 minutos por padrão
Webhook onlyApenas os problemas, sem inventário nem métricas e sem nenhuma chave armazenada