# Guia Criação de External Service Incident DataDog da 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 podemos fazer a integração do Datadog com a **Elven Platform**. Assim, aqui na **Elven Platform** podemos receber alertas ou eventos sobre incidentes, o que nos permite monitorar e analisar suas aplicações e serviços sob a perspectiva da Gestão de Incidentes da plataforma, usando as melhores práticas e metodologias do mercado, tudo em um só lugar.

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

## **API Token**&#x20;

Para integrar a Elven Platform com Datadog, 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.

## **Acessando o External Services Datadog**

* Navegue até o menu principal e clique em **Monitoring.** &#x20;
* No submenu, selecione item **External Services**.&#x20;
* Clique no botão **+ External Services.**&#x20;
* Selecione a opção, **Incident Datadog**.

## **Criando o External Services para Datadog**

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

Em seguida, localize o **API Token** que você gerou anteriormente e selecione-o para configurar a integração com o Datadog. 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;

## **Configurando o WebHooks no Datadog**

Para configurar um webhooks no Datadog, comece acessando o menu **Integrations** no painel lateral esquerdo. Utilize a barra de pesquisa para localizar  **webhooks** e clique no cartão que aparecer. Isso o levará para a página de configuração de webhooks.&#x20;

Em seguida, clique no botão **New** para criar um novo webhook. Preencha os campos necessários: insira um **nome** que identifique o webhook, adicione a URL de destino para onde os eventos serão enviados e configure o payload conforme necessário. Para finalizar, clique em **Save** e sua configuração estará pronta. \
&#x20;\
**Dica:** A URL e payload são fornecidos na página de configuração de seu External Service Datadog.

## **Glossário de Termos Técnicos**&#x20;

**External Services Center:** Módulo da Elven Platform responsável por configurar integrações com serviços externos, como Datadog.&#x20;

**Datadog:** Ferramenta de monitoramento e análise de desempenho de sistemas, usada para rastrear métricas, logs e alertas.&#x20;

**Gestão de Incidentes:** Práticas e metodologias aplicadas para identificar, monitorar e resolver incidentes de maneira eficiente.&#x20;

**API Token:** Código gerado na Elven Platform para autenticar e garantir uma conexão segura entre plataformas.&#x20;

**Organization Settings:** Área de configurações organizacionais na Elven Platform, onde é possível gerenciar tokens de API e outras configurações.&#x20;

**Incident Datadog:** Tipo de integração na Elven Platform que permite receber notificações e eventos do Datadog.&#x20;

**External Service Name:** Nome dado a um serviço externo configurado na Elven Platform para identificá-lo no sistema.&#x20;

**Responders:** Pessoas ou equipes designadas a receber notificações e agir sobre os incidentes reportados.&#x20;

**Webhooks:** Mecanismo de comunicação que envia informações de um sistema para outro em tempo real por meio de URLs.&#x20;

**Payload:** Estrutura de dados usada no webhook para definir o conteúdo e o formato das informações enviadas.&#x20;

**URL de Destino:** Endereço fornecido pela Elven Platform para onde o Datadog envia notificações de eventos através de webhooks.&#x20;

**Terms and Conditions:** Contrato de termos de uso que deve ser aceito durante o processo de configuração na Elven Platform.&#x20;

<br>
