> 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-incident-dynatrace-na-elven-platform.md).

# 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="/files/XDsGwHSCHv1HkSDtbKgQ" 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="/files/HkoYu3RLyt7q907MEPDU" 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="/files/crasM4XH4ljn23ndlghs" 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="/files/Vt6hVgskxEb5W3Wo4hT6" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/KjsokZSO447mvcDZsbFI" 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="/files/8tCTJvEaDbcHwQ2e4IAk" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/rRuAIEjxCzYig2OeQBmb" 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="/files/Yv47fd7ig0WWpTPxkOHr" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/XDngXXww5SdRBAW0YAML" 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;


---

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