# Guia Configuração do External Service Alert 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 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/cmd3gzvh9037jy80ihmuumdmb>" %}

## **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%2FSolBGMuD8yUUK12crwh8%2Fextda01.png?alt=media&#x26;token=bc435afb-afa5-4577-a1c7-e4ad9626d025" alt=""><figcaption></figcaption></figure>

## **Acessando External Service Alert Dynatrace**

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

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FYP1iw0WeHffW5ueBsG2M%2Fextda02.png?alt=media&#x26;token=83ec2f74-c854-44f9-9189-e0462936823a" alt=""><figcaption></figcaption></figure>

## **Criando o External Services para Alert Dynatrace** &#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%2FBUNwPhjffVGbMGNOwrjl%2Fextda03.png?alt=media&#x26;token=818cabcd-2707-4782-8207-dc85cd066e9a" 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%2F5KUefxIlJ5pstO1wE3ff%2Fextda04.png?alt=media&#x26;token=8cd179f3-84be-4196-be77-f3e2a8d77ea4" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F4D6BBSlFrtOWO3KH0tPh%2Fextda05.png?alt=media&#x26;token=f8c7110a-354e-4875-82d2-8a6cf0800a73" 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%2FYVlr3iAqdAFoV0jSE1tk%2Fextda06.png?alt=media&#x26;token=e6f3efc0-a53c-47b4-85af-ff9323e0caa1" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2Fd1zbcFyGfd8O9gRGIGmd%2Fextda07.png?alt=media&#x26;token=4679f97d-b3cb-4d1d-86b4-a97bdb96876b" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F4nbjd6lghESj2S8TEl17%2Fextda08.png?alt=media&#x26;token=529d0d65-1642-4c51-8b52-4e0013d6845b" 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.&#x20;

```
{

  "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%2F0PXhyElUUroTKgaYLZ15%2Fextda09.png?alt=media&#x26;token=3642dd0d-8b72-49bf-9277-aea17614cb0b" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FLTlWL5KMlhkVVQzaXJcC%2Fextda10.png?alt=media&#x26;token=07a07245-2111-458b-b083-b6b72d9a7407" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FMqhVnUVC53t9BrSZ8yPb%2Fextda11.png?alt=media&#x26;token=86a49110-88c4-4e3e-a293-7903cb96bb8c" 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 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;

<br>

<br>

<br>