# Guia Configuração do External Service Alert 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/cmd3gykr104hg3l0i5ibswbaa>" %}

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

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

* 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%2F95LQXZ3hM7OD6CGjJwPH%2Fisentrya01.png?alt=media&#x26;token=312102ff-794e-4712-b3ac-db00724f92d8" alt=""><figcaption></figcaption></figure>

## **Acessando External Service Alert Sentry**&#x20;

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

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F7F42EZ9IqnqNW9yySwTT%2Fisentrya02.png?alt=media&#x26;token=c5211e3d-41ce-485d-bf04-1d4a963def5b" alt=""><figcaption></figcaption></figure>

## **Criando o External Services para Alert Sentry**&#x20;

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%2FX15XxKI4kqGAfI2PtX5a%2Fisentrya03.png?alt=media&#x26;token=bd92655b-9b6f-4bca-bc74-326ef99599c9" 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%2FNajhlGyxsRQgSj4Yzep3%2Fisentrya04.png?alt=media&#x26;token=50fd6212-1799-4736-9644-fd6fec33c017" 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%2FUI1cacLuGCaFN2TbQZxD%2Fisentrya05.png?alt=media&#x26;token=a73fc9a0-c371-45c9-8daf-fc38628a8a7e" 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%2FP4MIScm4QXWPAmK6luJQ%2Fisentrya06.png?alt=media&#x26;token=d83c3e42-8fbc-4e9d-aaad-3ce2d550968b" 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%2F4QY8rjEFXvg0pRXvzWVP%2Fisentrya07.png?alt=media&#x26;token=a9380059-197a-476e-bc62-df71c9ac448c" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FiSMVUiqmrgWRe64ocTwn%2Fisentrya08.png?alt=media&#x26;token=bc1c29b1-07eb-4115-a6ff-3846bbc2587d" 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%2F6NDgoNEoKAIT3NelqRn6%2Fisentrya09.png?alt=media&#x26;token=188b767b-cf59-494c-9392-c92fd397c43b" 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;

**External Services Monitoring Center:** Seção na Elven Platform que exibe o status e detalhes dos serviços externos integrados, facilitando o acompanhamento de incidentes.&#x20;

<br>