# 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. 

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

## **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="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FanGInReh6kUmIrkLIk45%2Fextnewri01.png?alt=media&#x26;token=c2da12ae-21bc-4b22-bc52-3051c7431ca8" alt=""><figcaption></figcaption></figure>

## **Acessando External Service Incident New Relic**

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

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FoiQWQav9sUMuP6eGsZ5q%2Fextnewri02.png?alt=media&#x26;token=1c9f575a-fb14-48f9-ad68-434698459323" alt=""><figcaption></figcaption></figure>

## **Criando o External Services para Incident New Relic**&#x20;

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="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FZlx6MkH05f4d9kG6etGn%2Fextnewri03.png?alt=media&#x26;token=b0756596-97d5-445d-b2ca-12d4bc66295c" 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="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FsjYy8CcQDsO2y1vrYjTR%2Fextnewri04.png?alt=media&#x26;token=62b35cdc-e205-46bb-9a68-3a3bde453364" alt=""><figcaption></figcaption></figure>

## **Configurando Webhooks no New Relic**&#x20;

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

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FhV0WKBkWIVjiRgd9eWKk%2Fextnewri05.jpeg?alt=media&#x26;token=08150c16-4361-4462-9a8b-ded82e2508c0" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FM117nKseytekfpVFHB5D%2Fextnewri06.jpeg?alt=media&#x26;token=9847ff84-09e4-40c6-9ea3-2d54395996ca" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F16k5Tk9jROZcadcOml0p%2Fextnewri07.jpeg?alt=media&#x26;token=2f2f1621-14f2-4754-b55f-f16060e9ba3e" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2Fe1DAmxWDYOZ6Vdjs2ktr%2Fextnewri08.jpeg?alt=media&#x26;token=13c2e72d-b1d8-415f-8266-4caad6af1fff" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FB8Njbuo7qhphuWbV8Gr2%2Fextnewri09.jpeg?alt=media&#x26;token=e207e969-792d-4fa6-b255-4f39fc8e07a4" 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 Incident Integration”.

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FmFaKCPMgdTlPJqbDizki%2Fextnewri10.jpeg?alt=media&#x26;token=427f60f5-484b-4d83-be3d-2e6fde3e962d" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2Fs4wFzdvG2HvN5ZQUIMD5%2Fextnewri11.jpeg?alt=media&#x26;token=8639ef1e-30c6-48fc-a7b6-f8b36342701f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FaZEDJxRUjln7JMTzupHd%2Fextnewri12.jpeg?alt=media&#x26;token=0e464f4b-7bc1-4f6c-b64e-70e5bef5ab2a" 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 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.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FyAjKsrHPsqb0cXneyRvU%2Fextnewri13.jpeg?alt=media&#x26;token=033df510-bc98-47ae-bfbe-b97efb3770b5" alt=""><figcaption></figcaption></figure>

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.&#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, suas notificações de incidentes estarão configuradas corretamente e prontas para uso!&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F6Dk3pIzhigVYlucTa27Y%2Fextnewri14.jpeg?alt=media&#x26;token=05d03d0c-7b4d-4ca3-85ac-11965e7ddea3" 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.&#x20;