API do New Relic: NerdGraph, métricas e alertas com agentes de IA
O New Relic é uma plataforma de observabilidade, e o NerdGraph é sua API GraphQL principal para consultar dados com NRQL, gerenciar alertas, dashboards e entidades. Há também APIs de ingestão para métricas, eventos e logs. O acesso é por chave de API de usuário ou de ingestão.
Os grandes recursos da API, em português claro.
Consultar e configurar quase tudo da conta em uma única API.
Rodar consultas sobre métricas, eventos, logs e traces.
Gerenciar políticas, condições e incidentes.
Consultar serviços, hosts e sua saúde.
Criar e ler painéis.
Enviar métricas, eventos e logs pelas APIs de dados.
Como se acessa a API do New Relic.
- Com credencial da sua empresaChave de API de usuário (User key) para o NerdGraph e chave de ingestão (License key) para envio de dados.
- Documentação oficialdocs.newrelic.com/docs/apis
- Consultas pesadas consomem limites; o agente usa janelas de tempo curtas.
- Mudanças em alertas com aprovação.
- Logs podem conter dados pessoais.
- api new relic
- new relic nerdgraph
- new relic api nrql
- new relic api key
- integração new relic
- new relic graphql api
O que um agente do iTeam faz com a API do New Relic.
Quando um alerta abre, o agente roda NRQL nas métricas e logs e posta o diagnóstico no Slack.
O time pergunta a latência de um serviço e o agente responde com a consulta usada.
Toda semana o agente resume incidentes, SLOs e serviços mais instáveis.
O agente aponta condições que disparam demais e propõe ajuste.
Da credencial ao agente trabalhando, com aprovação.
Gerar a chave de usuário
No New Relic, crie uma User key para um usuário de integração com papel de leitura.
Cadastrar a credencial no cofre do iTeam
A credencial do New Relic fica no cofre do iTeam, fora de prompts e planilhas. Cada agente recebe só as ações de que precisa (rodar NRQL, ler incidentes), e o que grava dados passa por aprovação.
Testar com aprovação humana
Antes de liberar, rode uma consulta NRQL simples. Nas primeiras semanas, as ações de escrita ficam com aprovação e tudo fica na auditoria.
Dúvidas sobre a API do New Relic.
A API do New Relic é gratuita?
As APIs estão disponíveis em todos os planos; o custo do New Relic é por dados ingeridos e usuários.
Preciso programar para usar a API do New Relic com o iTeam?
Não necessariamente. A ferramenta HTTP do iTeam aprende os endpoints da API do New Relic pela documentação, e o time de implantação configura credenciais, permissões e o processo. Sua equipe valida o resultado.
O New Relic tem MCP?
O New Relic oferece servidor MCP. O iTeam pode usar MCP ou o NerdGraph, conforme o controle desejado.
Qual a diferença entre User key e License key no New Relic?
A User key autentica as consultas do NerdGraph, que lê dados e gerencia alertas e dashboards. A License key serve para enviar dados de ingestão, como métricas e logs. Para um agente que só diagnostica, a User key de leitura é a que importa.
O que é o NerdGraph e o que um agente consegue fazer com ele?
O NerdGraph é a API GraphQL do New Relic: por ela o agente roda consultas NRQL, lista entidades e alertas e lê dashboards. Um caso típico é perguntar o que aconteceu com a taxa de erro de um serviço na última hora e receber a resposta resumida.
Como o agente de IA escreve uma consulta NRQL sem sobrecarregar a conta?
Com janelas de tempo curtas, filtros por serviço e limite de linhas, pois consultas pesadas consomem os limites da conta. O agente deve começar por uma janela pequena e só ampliar quando necessário, em vez de varrer dias de dados de uma vez.
Posso deixar o agente alterar alertas do New Relic?
A API permite, mas alterar condição de alerta muda quando a equipe é acionada, então a mudança deve ter aprovação. Faça o agente apontar que um alerta está ruidoso e propor o ajuste, e o responsável pelo serviço decidir.
Onde estão os dados de logs no New Relic e há risco de dados pessoais?
Logs chegam pela API de ingestão e podem conter dados pessoais, como e-mails em mensagens de erro. Configure o mascaramento na origem e limite o acesso do agente a logs de serviços necessários, para que respostas de diagnóstico não exponham clientes.
O New Relic tem ambiente de teste para validar o agente?
Não confirmei um sandbox dedicado do New Relic. Uma alternativa é usar uma conta separada, em plano gratuito, ou apenas ler uma conta de desenvolvimento com poucos serviços. Confira na documentação oficial em docs.newrelic.com as opções do seu plano.
A API do New Relic serve para quem não é desenvolvedor?
A consulta é técnica, em GraphQL e NRQL, mas o agente traduz a pergunta em português para a consulta e devolve o resultado em texto. Quem cuida de operações pergunta o que quer saber, e o desenvolvedor só precisa configurar a chave e o acesso.
Quando não vale a pena um agente de IA em cima do New Relic?
Se a empresa tem poucos serviços e já resolve incidentes olhando um dashboard, o ganho é pequeno. Vale mais quando há muitas entidades e alertas, e o time perde tempo cruzando painéis para entender a causa de uma degradação.
