# 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="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FMEMdI2jL0nk8wfeW18ln%2Fisentryi01.png?alt=media&#x26;token=5ebe906c-689b-47cd-b804-376d80fe65a9" 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="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FaHnNlj8YXpG7Iu9c9aPR%2Fisentryi02.png?alt=media&#x26;token=4e2868db-cccc-4087-8917-32dc34a3bb2e" 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="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FtT4oUW0BlPWUQtgCNkyN%2Fisentryi03.png?alt=media&#x26;token=c1751085-95b5-4373-96cc-a6d242eabe7d" 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="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F576MZZH3XTnSwsHjJJFo%2Fisentryi04.png?alt=media&#x26;token=39dabf9e-0773-44d0-812d-7be1b91403d6" 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="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FOShj6IdBdwjXiEgkgY15%2Fisentryi05.png?alt=media&#x26;token=6eecda82-6c12-43b6-bcac-8aab19c91d1f" alt=""><figcaption></figcaption></figure></div>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FVB9DBuXI469iHwkIv9Jh%2Fisentryi06.png?alt=media&#x26;token=9083a8c8-85c1-43f5-9a3d-899a3f76ba72" 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="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FEX9HjG7zhtAFIJUsGUG6%2Fisentryi07.png?alt=media&#x26;token=b043bc96-6e73-4c0b-99be-cd4e697ef412" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FXCaCVaA6HnpZfBesjk3g%2Fisentryi08.png?alt=media&#x26;token=a610964b-b602-49bf-8da7-780391332946" 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="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FBZ0LMSBUweZm8biBeeTG%2Fisentryi09.png?alt=media&#x26;token=6649cb94-1ce0-4f0e-aa23-b6cef939196c" 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;