# Guia Configuração do External Service Incident Dynatrace 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 **Dynatrace** com a **Elven Platform**, permitindo o recebimento de notificações 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/cmd3gzlx10335y80i0yngw5x8>" %}

## **API Token**

Para integrar a Elven Platform com Dynatrace, 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%2FEgeh2oDJaz3f8Pm92Uu8%2Fextdi01.png?alt=media&#x26;token=03b5983d-bb23-4bd7-8a53-fdd853dde940" alt=""><figcaption></figcaption></figure>

## **Acessando External Service Incident Dynatrace**

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

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F9QauG92zYwFHgaP8TBWj%2Fextdi02.png?alt=media&#x26;token=b5f080a8-f0dd-449a-a6e2-572740bf40e1" alt=""><figcaption></figcaption></figure>

## **Criando o External Services para Incident Dynatrace**

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%2FKKzjwvRqh4JAxuxTr20e%2Fextdi03.png?alt=media&#x26;token=3cab321b-d241-4bf4-9c01-358e60c6ceb1" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FUujFTirqjf0FDyWGPnd8%2Fextdi04.png?alt=media&#x26;token=6b9a4229-85f1-4479-b01c-b126785b5907" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FJh10j8VFd0Jjzwy8nqcz%2Fextdi05.png?alt=media&#x26;token=7b78be13-98b4-4c66-b5f1-10a09c1ffe7e" alt=""><figcaption></figcaption></figure>

## **Configurando Webhooks no Dynatrace**&#x20;

Para configurar um webhook no **Dynatrace** e integrá-lo à **Elven Platform**, o processo é simples e direto. Comece acessando o painel lateral esquerdo do Dynatrace, navegando em **Apps** > **Manage > Settings Classic**. Lá, vá até a seção **Integration** e escolha a opção **Problem Notification**.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FSxpjv0rTBA0SZIzj1upv%2Fextdi06.png?alt=media&#x26;token=e5875967-72c1-4144-ba76-598d985bd734" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FjrUbeQ0j2MTVLLrLGEIM%2Fextdi07.png?alt=media&#x26;token=c9028ffd-7404-443e-8be1-56a849b20766" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FwYjHzAq2NFeGCDpIVWSB%2Fextdi08.png?alt=media&#x26;token=e4d12e6e-5f39-41f4-8417-539d6801d8d2" alt=""><figcaption></figcaption></figure>

Na próxima etapa, clique em **Add Notification** para criar sua nova notificação. Escolha o tipo de notificação como **Custom Integration** e dê um nome amigável no campo **Display Name** para facilitar a identificação. No campo **Webhook URL**, insira a URL que você obteve ao configurar o serviço externo no **External Service Dynatrace**.&#x20;

Lembre-se de ativar a opção **Call Webhook if problem is Closed**, garantindo que você será notificado tanto na abertura quanto no fechamento de problemas. Adicione também um cabeçalho HTTP configurando o nome como User-Agent e o valor como 1PCustomAuth/1.0.&#x20;

No campo de **Custom Payload**, você deve colar o conteúdo fornecido pela  **Elven Platform**. Esse payload é essencial para a integração e deve incluir os níveis de severidade, que vão de critical a informational, passando por high, moderate e low.

```
{

  "title": "{ProblemTitle}",

  "description": "{ProblemDetailsText}",

  "external_aggregate_key": "{Pid}",

  "action": "{State}",

  "severity": ""

}
```

O campo “severity” deverá ser preenchido com os seguintes valores:

* critical
* high
* moderate
* low
* informational

Por fim, selecione o **Alerting Profile** que corresponde aos tipos de incidentes que deseja monitorar e clique em **Save Changes**.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FQtBNhgR3ZIePhyMnzA8I%2Fextdi09.png?alt=media&#x26;token=48bf8bf4-906d-4795-9173-55488176468c" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FmQyFZW0TmrjHJTefKpmG%2Fextdi10.png?alt=media&#x26;token=300ec7c1-10c4-4abc-8cb1-967a5aff3b32" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FyguJP0QmSq8Tqylt0DJE%2Fextdi11.png?alt=media&#x26;token=b16e10ff-0c4b-4b14-b8b4-3b465d2bf4c0" 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.&#x20;

## **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 permitir a integração segura entre plataformas, garantindo troca de informações autenticada. Na Elven Platform, ela é criada em **Organization Settings**, na seção **API**.&#x20;

**External Service Name:** Nome designado ao serviço externo durante sua configuração na Elven Platform, utilizado para identificação e organização.&#x20;

**Responders:** Pessoas ou equipes definidas como responsáveis por receber notificações e atuar na resolução de incidentes relacionados ao serviço integrado.&#x20;

**Webhook:** Um método para enviar notificações ou eventos em tempo real de uma aplicação para outra. No Dynatrace, o webhook é configurado com uma **Webhook URL** fornecida pela Elven Platform para garantir a integração.&#x20;

**Webhook URL:** URL fornecida pela Elven Platform usada no Dynatrace para direcionar notificações e eventos à plataforma integrada.&#x20;

**Custom Integration:** Tipo de notificação configurada no Dynatrace para criar uma integração personalizada, permitindo especificar detalhes como payload e cabeçalhos HTTP.&#x20;

**Problem Notification:** Funcionalidade do Dynatrace que permite configurar notificações baseadas em eventos ou incidentes monitorados pela ferramenta.&#x20;

**Custom Payload:** Conteúdo enviado pelo Dynatrace via webhook que inclui detalhes do incidente, como nível de severidade. O formato do payload é definido pela equipe da Elven Platform.&#x20;

**Severity:** Nível de gravidade do incidente registrado no Dynatrace, classificado como:&#x20;

**Critical**: Problema crítico que requer atenção imediata.&#x20;

**High**: Problema de alta prioridade.&#x20;

**Moderate**: Problema moderado que pode impactar parcialmente o sistema.&#x20;

**Low**: Problema de baixa prioridade.&#x20;

**Informational**: Informações sem impacto direto no sistema.&#x20;

**Alerting Profile:** Perfil configurado no Dynatrace para definir quais tipos de incidentes ou alertas devem ser monitorados e notificados.&#x20;

**User-Agent:** Cabeçalho HTTP usado para identificar o cliente que faz uma requisição à API, configurado como 1PCustomAuth/1.0 no webhook do Dynatrace.&#x20;

**Integration:** Seção no menu de configurações do Dynatrace onde é possível gerenciar integrações, como notificações de problemas (Problem Notification).&#x20;

**Add Notification:** Opção no Dynatrace para criar uma nova notificação personalizada, usada para configurar o envio de eventos para a Elven Platform.&#x20;