> 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-zabbix-na-elven-platform.md). # 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="" %} ## **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**. * Na aba API, clique no botão **+** para criar um novo API Token.
## **Acessando External Service Incident Zabbix** * Navegue até o menu principal e clique em **Services Hub**. * Em **External Services Monitoring**, selecione o item **Incident Zabbix**.
## **Criando o External Services para Incident Zabbix** 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.
Em seguida, localize o **API Token** que você gerou anteriormente e selecione-o para configurar a integração com o Zabbix.
## **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**. 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. 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="/files/mZS6lRW8NYfNDwrxwsaw" %} 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**. 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
### **Personalizando o Media Type** Agora que o canal de comunicação está criado, precisamos personalizá-lo para que as notificações sejam direcionadas corretamente. Para isso, clique em **One Platform** e preencha os seguintes campos: * **ID da Organização** (elven\_platform\_organization), que identifica sua organização na **Elven Platform**. * **URL da API** (elven\_platform\_url), fornecida durante a configuração inicial da integração. É 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. Depois de preencher as informações corretamente, clique em **Update** para **salvar as alterações**.
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.
### **Definindo Quem Receberá os Alertas** Com o canal de comunicação configurado, o próximo passo é determinar **quem será notificado** quando um alerta for gerado. 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. 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.
### **Configurando o Usuário para Receber Notificações** Agora que a regra de notificação foi criada, precisamos garantir que o usuário configurado no **Zabbix** receba os alertas corretamente. 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. 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**. Depois de preencher tudo corretamente, clique em **Update** para **salvar as alterações**.
### **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. **External Services Monitoring:** Um recurso da Elven Platform que permite integrar serviços externos, como o Zabbix, para monitoramento centralizado e envio de alertas. **Organization Settings:** Área na Elven Platform onde as configurações relacionadas à organização são gerenciadas, incluindo a criação de tokens de API. **Responders:** Pessoas ou equipes designadas para receber notificações e agir em resposta aos incidentes reportados pela integração. **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. **Elven Platform:** O Media Type específico no Zabbix configurado para integrar e enviar notificações para a Elven Platform. **ID da Organização:** Identificador único fornecido pelo suporte da Elven Platform para associar o Media Type à organização correta durante a integração. **URL da API:** Endereço fornecido pela Elven Platform para direcionar os alertas enviados pelo Zabbix, conectando-o ao endpoint apropriado. **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. **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. **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. **Recovery Operations:** Ações configuradas para notificar sobre a resolução de problemas detectados no Zabbix. **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. **Severidade:** Níveis atribuídos aos incidentes detectados pelo Zabbix, que ajudam a categorizar e priorizar os alertas na Elven Platform: **Informational**: Informações gerais ou eventos de baixo impacto. **Low**: Problemas de baixa prioridade que requerem atenção eventual. **Moderate**: Incidentes de impacto médio. **High**: Problemas críticos que exigem ação imediata. **Critical**: Eventos de alto impacto que necessitam de resposta urgente. **Import:** Funcionalidade no Zabbix que permite importar configurações, como o Media Type, para facilitar a integração com ferramentas externas. --- # 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-zabbix-na-elven-platform.md?ask=&goal= ``` `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.