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

# Guia Configuração do External Service Incident Sentry 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 **Sentry** 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/cmd3h1wjm03kfy80i2cwdb8pc>" %}

## **API Token**

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

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

## **Acessando External Service Incident Sentry**

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

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

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

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/z4Am2f8hZaaxduIyOXPo" alt=""><figcaption></figcaption></figure>

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

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

## **Configurando Webhooks no Sentry**

Integrar o Sentry à Elven Platform é um processo intuitivo que permite centralizar a gestão de incidentes em um único lugar, proporcionando maior agilidade e controle. Vamos explicar como realizar essa configuração de forma clara e prática.&#x20;

Tudo começa acessando o painel do Sentry. Clique em **Settings** e, logo em seguida, em **Integrations**. Nessa área, você encontrará todas as opções de integração disponíveis. Para facilitar, digite “Webhook” na barra de busca e localize rapidamente a integração que vamos configurar.&#x20;

<div align="left"><figure><img src="/files/5pgAwZmxRq4RvUsYEslT" alt=""><figcaption></figcaption></figure></div>

<figure><img src="/files/6tPb6Ya9yTCcURACkvmH" alt=""><figcaption></figcaption></figure>

Com a integração de **Webhooks** selecionada, clique em **Add Project** e selecione seu **projeto**. Se você ainda não tiver um configurado, será necessário fazer isso antes. Insira a **URL** que foi gerada quando você configurou o **External Service Sentry** na **Elven Platform**. Essa **URL** é fundamental para estabelecer a conexão entre as duas plataformas.Após preencher o campo **Callback URLs**, lembre-se de clicar em **Save Changes** para garantir que as alterações sejam aplicadas.

Depois disso, ative a integração clicando em **Enable Plugin**.

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

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

Agora, é hora de testar! O Sentry oferece a funcionalidade **Test Plugin**, que simula o envio de um alerta para verificar se a comunicação está funcionando corretamente. Quando tudo estiver configurado corretamente, você verá um incidente criado automaticamente na Elven Platform. Isso confirma que a integração foi bem-sucedida e que os alertas estão sendo transmitidos como esperado.&#x20;

<figure><img src="/files/tK9bLw8yOrpwlKglIez0" 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**

**Sentry:** Plataforma de monitoramento e rastreamento de erros, utilizada para identificar e gerenciar problemas em aplicações.&#x20;

**API Token:** Chave de autenticação gerada na Elven Platform para permitir uma comunicação segura e confiável com ferramentas externas. \
**Organization Settings** \
Seção da Elven Platform onde é possível configurar opções organizacionais, como gerar API Tokens para integrações.&#x20;

**External Service Name:** Nome dado a um serviço externo durante sua configuração, usado para identificá-lo na Elven Platform.&#x20;

**Responders:** Pessoas ou equipes designadas para receber notificações de incidentes gerados por um serviço externo.&#x20;

**WebHook:** Mecanismo de integração que permite o envio de dados em tempo real entre duas plataformas. No contexto desta integração, é usado para enviar alertas do Sentry para a Elven Platform.&#x20;

**Callback URL:** URL fornecida pela Elven Platform durante a configuração do External Service, usada no Sentry para estabelecer a comunicação entre as plataformas.&#x20;

**Save Changes:** Botão no painel do Sentry que salva as alterações realizadas na configuração da integração.&#x20;

**Enable Plugin:** Opção no Sentry que ativa o plugin de integração após as configurações serem salvas.&#x20;

**Test Plugin:** Funcionalidade do Sentry que permite testar a integração configurada, simulando o envio de um alerta.&#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-sentry-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.