# Guia Configuração do External Service Incident Grafana 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 **Grafana** com a **Elven Platform**, permitindo o recebimento de notificações de incidentes 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/cmd3h069204nv3l0i8sh55jso>" %}

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

Para integrar a Elven Platform com o Grafana, 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.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FuQYVkwWVxlrgloVsXeq5%2Fgrafi01.png?alt=media&#x26;token=f7a7cd95-91c3-403c-89e1-1d79db56d6dd" alt=""><figcaption></figcaption></figure>

## **Acessando External Service Incident Grafana**&#x20;

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

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F9PT5Ufq2S2jBuAwLqVMy%2Fgrafi02.png?alt=media&#x26;token=7ce5f480-035b-4779-8955-5e24990594ac" alt=""><figcaption></figcaption></figure>

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

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%2FrpFHM8rbmugKgwHRJirk%2Fgrafi03.png?alt=media&#x26;token=6e682be5-75e3-411b-a86a-c6fa2a1a55b7" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FeZIXE3q24ceK8gDKwAAU%2Fgrafi04.png?alt=media&#x26;token=b544bb40-0a45-4470-93f1-df7e609e76ad" alt=""><figcaption></figcaption></figure>

## **Configurando Webhooks no Grafana**&#x20;

Conectar o Grafana à Elven Platform é um processo simples e intuitivo, especialmente com o suporte dedicado às versões 8 e 10 do Grafana. Para começar, acesse o menu à esquerda no Grafana e clique em **Contact Point**, onde você encontrará a opção **Add Contact Point**. No formulário, defina um nome para o ponto de contato, como “Elven Platform”, para facilitar sua identificação na plataforma. Escolha a integração do tipo **Webhook**, que permite o envio de notificações de incidentes em tempo real. No campo **URL**, insira a URL gerada na Elven Platform, certificando-se de selecionar a URL correspondente à versão do Grafana que você está utilizando — seja ela 8 ou 10. Essa compatibilidade garante que as ferramentas se integrem perfeitamente, mantendo um fluxo consistente de notificações.&#x20;

Ao realizar o teste, lembre-se de criar uma **label** chamada **`severity`**. O valor dessa label deve representar a severidade do evento, utilizando uma das categorias predefinidas pela **Elven Platform**:

* **critical**
* **high**
* **moderate**
* **low**
* **informational**

Com essa integração, você transforma a gestão de incidentes, centralizando todas as informações críticas diretamente na Elven Platform. Além de ser fácil de configurar, o suporte às diferentes versões do Grafana assegura que nenhum detalhe técnico será um obstáculo, proporcionando uma experiência adaptada às suas necessidades. Sua equipe estará sempre conectada e pronta para agir, garantindo agilidade e segurança no monitoramento e na resolução de problemas.&#x20;

#### **No Grafana, no menu à esquerda, vá em contact point e clique em Add contact point:**

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FcmDRdvP8Vdke4uiTYnub%2Fgrafi05.png?alt=media&#x26;token=1b110f86-77b0-4d93-aa98-b91e631ce42f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2Fep8D9eNlgGgb7ZumGCeh%2Fgrafi06.png?alt=media&#x26;token=8cb44c30-ed6c-47bc-99bd-66cb23f4b3f2" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FngiXp59EW0b6MpJEA9wi%2Fgrafi07.png?alt=media&#x26;token=59ba7cd7-726e-448c-b185-3afb4821ab0d" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FdlRJannLEsbL7wY9WZcE%2Fgrafi08.png?alt=media&#x26;token=e67a37f8-e95a-438a-ab3d-de2e80d05eee" 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**

**API Token:** Chave única gerada na Elven Platform para permitir a autenticação e troca de informações segura entre a plataforma e ferramentas externas como Grafana.&#x20;

**External Services Monitoring:** Área da Elven Platform que lista os serviços externos integrados, permitindo monitorar status, responder a incidentes e configurar notificações.&#x20;

**Contact Point:** Recurso do Grafana usado para configurar pontos de contato para alertas, como Webhooks, garantindo o envio de notificações em tempo real.&#x20;

**Webhook:** Método de comunicação entre sistemas que envia notificações automaticamente a uma URL específica, conectando o Grafana à Elven Platform.&#x20;

**URL:** Endereço gerado pela Elven Platform que deve ser usado ao configurar um Webhook no Grafana. É específico para a versão utilizada do Grafana (8 ou 10).&#x20;

**Responders:** Pessoas ou equipes definidas na configuração de um serviço externo que receberão notificações sobre incidentes detectados.&#x20;

**Alert Grafana:** Serviço específico do **External Services Monitoring** na Elven Platform para configurar a integração com alertas do Grafana.&#x20;

**Status de Alarme:** Classificação visual no **External Services Monitoring Center**, que destaca serviços em estado de alerta para priorizar ações.&#x20;

**Versão do Grafana:** Versão específica do Grafana (como 8 ou 10) que define a URL correspondente para configuração do Webhook.&#x20;

**Gestão de Incidentes:** Processo de monitorar, analisar e responder a eventos críticos para minimizar impactos em sistemas e serviços.&#x20;

**Notificações em Tempo Real:** Mensagens enviadas imediatamente após um incidente ser detectado, permitindo ações rápidas para resolver problemas.&#x20;

**External Service Name:** Nome atribuído a um serviço externo durante a configuração na Elven Platform para facilitar sua identificação e organização.&#x20;

**Fluxo Consistente de Notificações:** Garantia de que alertas gerados no Grafana cheguem à Elven Platform sem interrupções, otimizando a gestão de incidentes.&#x20;

<br>