Guia Configuração do External Service Incident New Relic na Elven Platform  

O External Services Center da Elven Platform é a ponte que conecta você às melhores ferramentas do mercado para monitorar, gerenciar e resolver incidentes de forma simples e eficiente. Nele, é possível integrar o New Relic com a Elven Platform, permitindo o recebimento de alertas e eventos relacionados a incidentes diretamente na plataforma. Isso possibilita monitorar e analisar suas aplicações e serviços sob a perspectiva da Gestão de Incidentes, utilizando as melhores práticas e metodologias do mercado, tudo em um único lugar. 

API Token 

Para integrar o Elven Platform com o New Relic, precisamos criar um API Token. Essa chave única é indispensável para que as duas plataformas se conectem com segurança, garantindo a troca de informações confiável e autenticada. Basta acessar o Organization Settings da Elven Platform, navegar até a seção de API e gerar.

Criando um API Token 

  • No menu superior na parte de configuração de seu usuário, clique em Organization. Settings.  
  • Na aba API, clique no botão + para criar um novo API Token. 

Acessando External Service Alert New Relic 

  • Navegue até o menu principal e clique em Services Hub.  
  • Em External Services Monitoring, selecione o item Incident New Relic

Criando o External Services para Incident New Relic  

Criando o External Services para Incident New Relic  

No formulário, comece preenchendo o campo External Service Name, que será o nome do serviço externo, e defina os Responders, ou seja, as pessoas ou equipes que receberão notificações relacionadas a este serviço. Após isso, clique em CREATE para prosseguir. Essa ação criará o registro inicial do seu serviço externo.

Em seguida, localize o API Token que você gerou anteriormente e selecione-o para configurar a integração com o New Relic.

Configurando Webhooks no New Relic  

Integrar o New Relic com a Elven Platform é um processo fácil e prático, pensado para otimizar o monitoramento e a gestão de incidentes. O primeiro passo é criar uma nova política de alertas no New Relic. Para isso, navegue até o menu Alerts, localizado à esquerda, e selecione a seção Alert Policies. Em seguida, clique no botão Create Alert Conditions para avançar no processo. Caso uma tela de informações seja exibida, simplesmente feche-a para prosseguir. Assim que a nova tela for aberta, localize o botão + New Alert Policy e clique nele. Esse é o ponto de partida para configurar uma política de notificação de incidentes de acordo com suas necessidades, garantindo um monitoramento eficiente e personalizado. Dê um nome para sua política. 

 Ao criar uma nova política, opte por One Issue per condition and signal, garantindo que cada condição gere uma notificação de incidente única. Finalize clicando em Create policy without notifications, simplificando a configuração inicial. 

Em seguida, vá até o menu Workflows no painel à esquerda e clique em + Add a workflow, localizado no canto superior direito. Dê um nome ao workflow, algo que facilite sua identificação futura, e vincule-o à política criada na etapa anterior. Na seção Notify, escolha Webhook e clique em + Add a destination. Insira um nome descritivo no campo Webhook name, algo que represente bem a função desse ponto de contato, como “Elven Incident Integration”.

Agora, insira as informações fornecidas pela Elven Platform. No campo Endpoint URL, preencha com a URL gerada ao criar o External Service New Relic na Elven Platform e clique em Save destination. Essa integração garante que as notificações de incidentes sejam enviadas diretamente à plataforma, centralizando informações críticas e agilizando a resposta a incidentes. É uma solução que alia simplicidade e eficiência, permitindo que você mantenha o foco na resolução de problemas e na melhoria contínua de seus serviços. 

Agora, insira o payload disponibilizado aqui na documentação para realizar um teste. Assim, você receberá uma notificação de Incidente de teste na Elven Platform e poderá verificar se tudo está funcionando corretamente. 

Payload para Teste:


{
"issueId": {{json issueId}},
"issueTitle": {{json issueTitle}},
"issueDescription": "{{accumulations.conditionDescription.[0] }}",
"issueState": "open",
"issueTime": "{{ createdAt }}",
"severity": {{ json priority }}

}

Se o teste for bem-sucedido, basta substituir esse payload pelo que foi fornecido diretamente pela Elven Platform. Dessa forma, suas notificações de incidentes estarão configuradas corretamente e prontos para uso! 

Assim que configurado, o serviço aparecerá no External Services Monitoring Center, classificado por status, facilitando o monitoramento de incidentes com prioridade para aqueles em estado de alarme. 

Glossário de Termos Técnicos 

API Token: Uma chave única gerada para estabelecer a comunicação segura entre a Elven Platform e outras ferramentas, como o New Relic. Garante a troca de informações autenticada e confiável. 

Alerts (New Relic): Menu no painel do New Relic onde são criadas e gerenciadas políticas de alerta, permitindo configurar condições específicas que geram notificações baseadas em eventos monitorados. 

Alert Conditions e Policies (New Relic): Seção dentro de Alerts onde é possível criar novas políticas de alerta e definir condições específicas para a geração de incidentes e notificações. 

One Issue per condition and signal: Configuração que garante que cada condição de alerta no New Relic seja tratada como um evento único, evitando duplicações desnecessárias. 

Create policy without notifications: Opção para criar uma política de alertas sem configurar notificações iniciais, simplificando o processo de integração e permitindo ajustes posteriores. 

Workflows (New Relic): Menu do New Relic onde os fluxos de trabalho são criados para automatizar ações, como o envio de notificações baseadas nas políticas de alerta definidas. 

Webhook: Um ponto de integração que permite o envio de alertas e eventos em tempo real para sistemas externos, como a Elven Platform. Funciona como um canal de comunicação direta. 

Webhook name: Nome de identificação dado ao Webhook no New Relic para facilitar sua localização e entendimento em futuras configurações. 

Endpoint URL: Endereço gerado na Elven Platform ao criar o External Service para o New Relic. É usado para configurar o Webhook no New Relic e estabelecer a comunicação entre as duas plataformas. 

External Services Center (Elven Platform): Seção da Elven Platform que permite a integração com ferramentas externas, centralizando alertas e eventos para facilitar a gestão de incidentes. 

Services Hub (Elven Platform): Menu principal da Elven Platform onde estão listados e configurados os serviços externos integrados, como o New Relic. 

External Service Name: Nome dado ao serviço externo configurado na Elven Platform, utilizado para identificar facilmente a integração configurada. 

Responders: Usuários ou equipes definidos na Elven Platform para receberem notificações e gerenciarem incidentes relacionados ao serviço configurado. 

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *

Nesta página
Rolar para cima