> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myrmex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Zabbix

> Conecte o Zabbix ao Myrmex pela sua API — crie um token de API e adicione a integração.

import { Note, Steps, Step, CardGroup, Card, Tip } from '@mintlify/components';

Conecte seu servidor de monitoramento **Zabbix** para que o Myrmex possa revisar hosts, problemas e métricas. O Myrmex acessa o Zabbix pela sua **API JSON-RPC** (`/api_jsonrpc.php`) através de um [Collector](/pt/documentation/agent-endpoint-security/collector-mode) na sua rede. Toda requisição é executada **ao vivo, sob demanda** — o Myrmex retorna apenas o que você pedir e não copia nem armazena nada do Zabbix do seu lado. As credenciais são resolvidas do seu lado e nunca passam pelo modelo.

## O Que o Myrmex Pode Fazer

<CardGroup cols={2}>
  <Card title="Monitorar hosts" icon="server">
    Liste hosts e sua disponibilidade para ver o que o Zabbix está observando.
  </Card>

  <Card title="Revisar problemas" icon="triangle-exclamation">
    Leia os problemas e triggers atuais para apoiar a triagem de [alertas](/pt/documentation/detection-response/alerts).
  </Card>

  <Card title="Ler métricas" icon="chart-line">
    Consulte items e seus valores mais recentes ao vivo e retorne apenas o que você pediu.
  </Card>

  <Card title="Verificar a saúde do servidor" icon="heart-pulse">
    Leia o status do Zabbix para confirmar que o servidor de monitoramento está saudável.
  </Card>
</CardGroup>

## Antes de Começar

* Um **Collector** que consiga alcançar o frontend do Zabbix por HTTPS (porta padrão `443`; implantações self-hosted costumam usar `80` ou `8080`). Veja [Modo Collector](/pt/documentation/agent-endpoint-security/collector-mode).
* Um **usuário do Zabbix** com uma função de leitura e um **token de API** (os tokens de API exigem Zabbix 5.4 ou posterior).

## Passo 1 — Crie a Credencial no Zabbix

<Steps>
  <Step title="Escolha ou crie um usuário">
    Em **Users → Users**, use ou crie uma conta com uma função somente leitura que possa ver os hosts e problemas que o Myrmex deve monitorar.
  </Step>

  <Step title="Gere um token de API">
    Vá em **Users → API tokens**, crie um token para esse usuário, defina uma expiração opcional e copie o valor (mostrado apenas uma vez). O Myrmex o envia como Bearer token para a API do Zabbix (`/api_jsonrpc.php`).
  </Step>
</Steps>

<Tip>
  Atribua uma função somente leitura para que o token possa monitorar sem alterar nada no Zabbix.
</Tip>

## Passo 2 — Adicione a Integração no Myrmex

No **Directory**, escolha **Add Integration → Zabbix** e preencha:

| Field                     | Descrição                                                                                     |
| ------------------------- | --------------------------------------------------------------------------------------------- |
| **Name**                  | Um nome único para este servidor Zabbix.                                                      |
| **Description**           | Nota opcional para identificar o servidor.                                                    |
| **API Token**             | O token de API criado no Passo 1.                                                             |
| **URL**                   | Host ou IP do frontend do Zabbix que o Collector consegue alcançar.                           |
| **Protocol**              | `https` (ou `http` para implantações apenas internas).                                        |
| **Port**                  | A porta do frontend (padrão `443`).                                                           |
| **Collector**             | O [Collector](/pt/documentation/agent-endpoint-security/collector-mode) que alcança o Zabbix. |
| **Authentication Method** | `bearer` (o token de API).                                                                    |

## Conectar

Clique em **Connect** para validar a conexão com a API e concluir. O Zabbix então aparece em **Environment → Integrations**, e você pode perguntar sobre ele no Workspace ou por meio do [agente Integration Specialist](/pt/documentation/multi-agent-system/integration-specialist-agent).

<Note>
  A API fica em `/api_jsonrpc.php` no frontend do Zabbix. Aponte a URL e a Port para o frontend que o Collector consegue alcançar, não para o banco de dados ou o processo do servidor.
</Note>
