> For the complete documentation index, see [llms.txt](https://docs.elven.works/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.elven.works/elven-platform/elven-incident/external-services/guia-configuracao-do-external-service-alert-new-relic-na-elven-platform.md).

# Guia Configuração do External Service Alert 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. 

{% embed url="<https://demo.elven.works/demo/cmd3gxuse031v130i7dgufu4t>" %}

## **API Token**

Para integrar a 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**. &#x20;
* Na aba API, clique no botão **+** para criar um novo API Token.&#x20;

<figure><img src="/files/WnXB3BLCVNVZZnXCbNkA" alt=""><figcaption></figcaption></figure>

## **Acessando External Service Alert New Relic**

* Navegue até o menu principal e clique em **Services Hub**. &#x20;
* Em **External Services Monitoring**, selecione o item **Alert New Relic**.&#x20;

<figure><img src="/files/2kQK5K7okCUbyEw4Eidl" alt=""><figcaption></figcaption></figure>

## **Criando o External Services para Alert 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.

<figure><img src="/files/vfJuBtZOlg01PJ2y4Ftc" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/lhhDUmTtg9v3JtOEjXt1" alt=""><figcaption></figcaption></figure>

## **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 alertas de acordo com suas necessidades, garantindo um monitoramento eficiente e personalizado. Dê um nome para sua política.&#x20;

<figure><img src="/files/HDK4eQDxAMv05SvY0wgK" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/F3ChEKnlIB1sWmhaTlf9" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/8V55OWmRYiSWFnCLlNLl" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/gzILMHElEiuT2fswseyP" alt=""><figcaption></figcaption></figure>

Ao criar uma nova política, opte por **One Issue per condition and signal**, garantindo que cada condição gere um alerta único. Finalize clicando em **Create policy without notifications**, simplificando a configuração inicial.&#x20;

<figure><img src="/files/2OQ6SRSI8C1U0MSXqo9a" alt=""><figcaption></figcaption></figure>

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 Alert Integration”.

<figure><img src="/files/PhnGkY10KJCg2jfM7WRW" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/owmEkryF3X63QuDGVw9R" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/YsSTJ7kTbke9AdjkRIkd" alt=""><figcaption></figcaption></figure>

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 os alertas sejam enviados 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.&#x20;

<figure><img src="/files/6KPKVHKRkPlVpXEXKSib" alt=""><figcaption></figcaption></figure>

Agora, insira o payload disponibilizado aqui na documentação para realizar um teste. Assim, você receberá um alerta de teste na **Elven Platform** e poderá verificar se tudo está funcionando corretamente.&#x20;

**Payload** **para teste**:

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

**Importante:** Leve em conta que o payload acima irá abrir um incidente na Elven Platform para efeito de testes, mas ainda assim ele permanecerá aberto na mesma até que seja marcado como resolvido. No dia a dia, você deve considerar que o atributo "**issueState**", além do valor "**open**", também pode ter os valores "**acknowledged**" e "**closed**", para respectivamente marcar o issue como reconhecido e fechado na Elven Platform.

Se o teste for bem-sucedido, basta substituir esse payload pelo que foi fornecido diretamente pela **Elven Platform**. Dessa forma, seus alertas estarão configurados corretamente e prontas para uso!

<figure><img src="/files/kiIABvpxTLqsMnPvlREo" alt=""><figcaption></figcaption></figure>

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.

## **Configurações adicionais de segurança e performance**

* **Whitelist de IPs:** A comunicação via API pode ser configurada para permitir **apenas IPs autorizados**. Para ativar ou modificar essa configuração, entre em contato com o **suporte da Elven Platform**.
* **Rate Limiting:** O tempo padrão para limitação de requisições é **5 minutos**, mas pode ser ajustado conforme a necessidade. Para alterações, entre em contato com o **suporte da Elven Platform**.

Essas configurações garantem maior segurança e controle sobre o tráfego de dados entre os sistemas integrados.

## **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.&#x20;

**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.&#x20;

**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.&#x20;

**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.&#x20;

**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.&#x20;

**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.&#x20;

**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.&#x20;

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

**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.&#x20;

**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.&#x20;

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

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

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.elven.works/elven-platform/elven-incident/external-services/guia-configuracao-do-external-service-alert-new-relic-na-elven-platform.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.