> 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-criacao-de-external-service-incident-datadog-da-elven-platform.md).

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


---

# 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-criacao-de-external-service-incident-datadog-da-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.
