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

## **API Token**

Para integrar a Elven Platform com o Zabbix, 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%2FKKD21DJyQGRDZ2xm4nNZ%2Fizi01.png?alt=media&#x26;token=46fbfa02-1685-4cc5-b652-1e3fa89f4939" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FEYiifVNWLkJiJv1aqwb8%2Fizi02.png?alt=media&#x26;token=931ddfb2-329b-4547-b660-0485971d29ca" alt=""><figcaption></figcaption></figure>

## **Criando o External Services para Incident Zabbix**&#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%2FL2pSLtWAtVPRX9rOWSd2%2Fizi03.png?alt=media&#x26;token=0832b8a6-6ba1-4110-85fe-2b8bacd03058" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2Fa7tWmxBx1l2DEG3k8DNv%2Fizix.png?alt=media&#x26;token=bc0c1a2c-9e9e-45c4-abc4-5848b28dfe44" alt=""><figcaption></figcaption></figure>

## **Configurando Webhooks no Zabbix**

A integração entre o Zabbix e a Elven Platform foi pensada para simplificar sua gestão de incidentes, centralizando os alertas em um único lugar. Ao conectar essas ferramentas, você garante uma operação mais eficiente e ágil, com informações precisas sempre à mão.

### **Configurando o Media Type no Zabbix**

A primeira etapa da integração é criar um canal de comunicação entre as plataformas. No **Zabbix**, esse canal é chamado de **Media Type**, e ele será responsável por transmitir os alertas para a **Elven Platform**.&#x20;

Para configurá-lo, acesse o **menu lateral do Zabbix**, clique em **Alerts** e selecione **Media types**. Dentro dessa tela, localize o botão **Import**, no canto superior direito, e clique nele.&#x20;

Você precisará importar um arquivo de configuração específico para a sua versão do Zabbix. Para facilitar, você pode baixá-lo diretamente no link abaixo:

{% file src="<https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F9kVHjxSVSok704q9Hd5q%2FElvenPlatform-V5.x-V6.x.zip?alt=media&token=7934c771-ab9b-4bac-8009-f3a0709f7da2>" %}

Durante a importação, é fundamental marcar a opção **Create new**, garantindo que o Media Type seja adicionado corretamente sem sobrescrever nenhuma outra configuração. Uma vez que a importação for concluída, o **Elven Platform** aparecerá na lista de **Media Types disponíveis**. Esse será o canal pelo qual o Zabbix enviará alertas para a **Elven Platform**.&#x20;

Com todas as etapas concluídas, sua integração está quase pronta. Quando o Zabbix detectar um problema, um alerta será automaticamente enviado para a aba **Incidents** da Elven Platform. Resolva o problema no Zabbix, e o incidente será marcado como **Resolved** na plataformaima

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FdPGrAwQezKUEysIj2f4i%2Fizi05.png?alt=media&#x26;token=2307d973-79fd-4dc1-bea1-a22ca5cfbf67" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F8q1TSNTDK23SXW3kH83L%2Fizi06.png?alt=media&#x26;token=7d77ab78-e98e-4a5f-92f1-977e3fe4a1e5" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FdYlM9vPsyhm0VfgkWBP1%2Fizi07.png?alt=media&#x26;token=2660fdf1-e42b-4499-aa52-bbcc238c1945" alt=""><figcaption></figcaption></figure>

### **Personalizando o Media Type**&#x20;

Agora que o canal de comunicação está criado, precisamos personalizá-lo para que as notificações sejam direcionadas corretamente.&#x20;

Para isso, clique em **One Platform** e preencha os seguintes campos:&#x20;

* **ID da Organização** (elven\_platform\_organization), que identifica sua organização na **Elven Platform**.&#x20;
* **URL da API** (elven\_platform\_url), fornecida durante a configuração inicial da integração.&#x20;

É importante lembrar que o **ID da Organização** está presente no corpo da URL e é essencial para a configuração correta. Se houver dúvidas, o **suporte da Elven Platform** pode ajudar.&#x20;

Depois de preencher as informações corretamente, clique em **Update** para **salvar as alterações**.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FTvtWcLZRfMYmKbGmgy6l%2Fizi08.png?alt=media&#x26;token=dc0d9580-a184-4eeb-a450-2ef51ff54c5d" alt=""><figcaption></figcaption></figure>

Os outros parâmetros definem as informações enviadas para a Elven Platform sempre que um evento acontece. Quando um evento ocorre no **Zabbix**, ele envia dados essenciais para a **Elven Platform**. A **alert\_message** detalha o alerta, enquanto a **alert\_subject** resume o ocorrido. O **event\_id** facilita o rastreamento, e o **event\_value** indica se o evento está **Alarmed** ou **Resolved**. O **severity** define a criticidade, e as **tags** ajudam na organização. Esses parâmetros garantem uma integração eficiente e personalizável.

Sabendo disso, no **Zabbix**, podemos adicionar **tags personalizadas** às **triggers** para organizar e categorizar alertas de forma estratégica. Basta acessar a seção **Hosts**, ir até **Triggers** e selecionar a aba **Tags**. Isso facilita a triagem dos alertas, melhora a integração com a **Elven Platform** e permite uma resposta mais rápida a **incidentes**. Com essa abordagem, o **monitoramento** se torna mais eficiente e a **gestão de incidentes** muito mais ágil e organizada.

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FZUMgqz4yPs8ZGNmokvaL%2Fizi09.png?alt=media&#x26;token=669d0ca1-bc09-4e2b-8373-0c9a2743f149" alt=""><figcaption></figcaption></figure>

### **Definindo Quem Receberá os Alertas**&#x20;

Com o canal de comunicação configurado, o próximo passo é determinar **quem será notificado** quando um alerta for gerado.&#x20;

No **menu lateral do Zabbix**, vá até **Alerts**, clique em **Actions** e selecione **Trigger Actions**. Dentro dessa seção, clique em **Create action** para criar uma nova regra de notificação.&#x20;

Escolha um nome descritivo para essa ação, como **Monitoramento Crítico de Serviços**, para facilitar a identificação. Em seguida, vá até a aba **Operations** e defina os **grupos de usuários e usuários individuais** para **Operations e Recovery operations.**  Estes deverão receber os alertas. No nosso caso, selecionamos o usuário **Admin**, mas essa escolha depende da estrutura da sua equipe e organização.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FnObXIT7E4PXVcDT4GkDQ%2Fizi10.png?alt=media&#x26;token=414f5c45-e95f-4d3f-bab3-40faee5ff4c8" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FTA3aiF9kZKoBOsVG2y6K%2Fizi11.png?alt=media&#x26;token=7a86687c-ea21-4690-9a72-2274d5c88187" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2Ff0jbQJG58DwBgYCZPMeU%2Fizi12.png?alt=media&#x26;token=b265b26f-0639-4880-852a-bba3dbbe5a1a" alt=""><figcaption></figcaption></figure>

### **Configurando o Usuário para Receber Notificações**&#x20;

Agora que a regra de notificação foi criada, precisamos garantir que o usuário configurado no **Zabbix** receba os alertas corretamente.&#x20;

Acesse o **menu lateral do Zabbix**, clique em **Users** e depois **Users** novamente, dentro da lista de usuários, selecione **Admin**. Em seguida, vá até a aba **Media** e clique em **Add** para adicionar um novo canal de notificação.&#x20;

Na tela de configuração, escolha **Elven Platform** como o **Type** e, no campo **Send to**, insira um nome de referência, como **Elven Platform**. Vale lembrar que, no caso de um Webhook, essa referência serve apenas para organização, já que a URL real do serviço já foi definida no **Media Type**.&#x20;

Depois de preencher tudo corretamente, clique em **Update** para **salvar as alterações**.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FIEBJVu4dvr8uwbUOnsay%2Fizi13.png?alt=media&#x26;token=1f3d7c24-3c11-48da-b5e5-8e9e8725d15a" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2Fz9HkYZltjK50U0unjw6x%2Fizi14.png?alt=media&#x26;token=aa299531-8073-4d07-add9-c825086aae31" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FpKX4BhSY9Qkf6PINKF34%2Fizi15.png?alt=media&#x26;token=8b0842fb-ea43-41a5-b42d-33af9ffe0b1d" alt=""><figcaption></figcaption></figure>

### **Testando e Garantindo o Funcionamento da Integração**

Quando o problema for resolvido no Zabbix, a **Elven Platform** também registrará essa resolução, marcando o incidente como **Resolved**.

Dessa forma, você garante um **monitoramento eficiente, com alertas em tempo real e uma gestão de incidentes mais ágil**. Se precisar de suporte em qualquer etapa, o time da **Elven Platform** está à disposição para ajudar.

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:** Uma chave exclusiva que autentica e autoriza a comunicação entre a Elven Platform e o Zabbix, garantindo uma troca de informações segura.&#x20;

**External Services Monitoring:** Um recurso da Elven Platform que permite integrar serviços externos, como o Zabbix, para monitoramento centralizado e envio de alertas.&#x20;

**Organization Settings:** Área na Elven Platform onde as configurações relacionadas à organização são gerenciadas, incluindo a criação de tokens de API.&#x20;

**Responders:** Pessoas ou equipes designadas para receber notificações e agir em resposta aos incidentes reportados pela integração.&#x20;

**Media Type:** Um componente no Zabbix usado para configurar os canais de comunicação, permitindo que alertas sejam enviados para destinos externos, como a Elven Platform.&#x20;

**Elven Platform:** O Media Type específico no Zabbix configurado para integrar e enviar notificações para a Elven Platform.&#x20;

**ID da Organização:** Identificador único fornecido pelo suporte da Elven Platform para associar o Media Type à organização correta durante a integração.&#x20;

**URL da API:** Endereço fornecido pela Elven Platform para direcionar os alertas enviados pelo Zabbix, conectando-o ao endpoint apropriado.&#x20;

**Trigger Actions:** Ações configuradas no Zabbix para monitorar eventos específicos (como problemas em hosts ou serviços) e enviar alertas baseados nessas condições.&#x20;

**Conditions:** Critérios definidos no Zabbix que determinam quando uma Trigger Action será ativada, como a ocorrência de um problema em um host ou grupo de hosts.&#x20;

**Operations:** Configuração no Zabbix que define o que deve acontecer quando uma Trigger Action é ativada, como o envio de notificações para usuários ou grupos.&#x20;

**Recovery Operations:** Ações configuradas para notificar sobre a resolução de problemas detectados no Zabbix.&#x20;

**Triggers:** Regras no Zabbix usadas para detectar condições específicas em hosts ou serviços monitorados, como falhas ou valores fora dos limites normais.&#x20;

**Severidade:** Níveis atribuídos aos incidentes detectados pelo Zabbix, que ajudam a categorizar e priorizar os alertas na Elven Platform:&#x20;

**Informational**: Informações gerais ou eventos de baixo impacto.&#x20;

**Low**: Problemas de baixa prioridade que requerem atenção eventual.&#x20;

**Moderate**: Incidentes de impacto médio.&#x20;

**High**: Problemas críticos que exigem ação imediata.&#x20;

**Critical**: Eventos de alto impacto que necessitam de resposta urgente.&#x20;

**Import:** Funcionalidade no Zabbix que permite importar configurações, como o Media Type, para facilitar a integração com ferramentas externas.&#x20;