CIRCUITO
CARIOCA TI · DOCUMENTAÇÃO
♙
Grafana · NOC / ISP

Integração Zabbix

O plugin alexanderzobnin-zabbix-app suporta métricas, alerting, annotations, variables, Problems e Direct DB Connection.

grafana://NOC / ISP
$ platform: Grafana
$ topic: Integração Zabbix
$ mode: production
$ method: evidence-first_
Escopo técnico

Integração Zabbix

O plugin alexanderzobnin-zabbix-app suporta métricas, alerting, annotations, variables, Problems e Direct DB Connection.

01 · NOC / ISP

Ponto técnico 1

Plugin: O plugin alexanderzobnin-zabbix-app suporta métricas, alerting, annotations, variables, Problems e Direct DB Connection.

02 · NOC / ISP

Ponto técnico 2

API: Use URL completa da API e usuário/token com leitura somente dos grupos e hosts necessários.

03 · NOC / ISP

Ponto técnico 3

History/trends: Entenda retenção e quando o plugin consulta history ou trends; janelas longas dependem do dado preservado.

04 · NOC / ISP

Ponto técnico 4

Direct DB: Pode consultar history/trends diretamente via MySQL/PostgreSQL/InfluxDB já configurado no Grafana, reduzindo carga/transferência pela API em janelas amplas.

05 · NOC / ISP

Ponto técnico 5

NOC/ISP: Padronize variáveis Operadora, POP, Host, Interface e Circuito para diferenciar falha isolada, regional e de fornecedor.

06 · NOC / ISP

Ponto técnico 6

Diagnóstico: Save & test → API/token → query simples → history/trends → Direct DB → SQL read-only → timeout → Query Inspector.

Aplicação em produção

Procedimento de engenharia

Escopo e impacto

Defina serviço, owner, estado esperado e impacto antes de alterar o monitoramento.

Evidência primeiro

Valide fonte, caminho, credenciais, baseline e timestamps antes de alterar thresholds.

Mudança controlada

Altere uma variável por vez e mantenha um caminho de rollback.

Comandos / fluxo de referência

Fluxo recomendado:
Grafana -> Zabbix API -> hosts/items/problems
Grafana -> SQL read-only -> history/trends (Direct DB)

consolidateBy(max) | groupBy(1h, max)
Manutenção

Rotina operacional recomendada

  • Revise estados críticos, lacunas de coleta e falhas de entrega a cada turno.
  • Revise alertas ruidosos, objetos lentos, credenciais e erros recorrentes semanalmente.
  • Revise versões, backup/restore, permissões e capacidade periodicamente.
Troubleshooting por evidências

Sintoma → escopo → camada → evidência → hipótese → validação

Capture logs, timestamps, saídas e topologia antes da ação corretiva sempre que possível.
Laboratório guiado

Construa, quebre, diagnostique e recupere

  1. Registre um baseline saudável.
  2. Induza uma falha controlada relacionada ao tema.
  3. Identifique a camada com falha antes de reiniciar componentes.
  4. Corrija a causa identificada e valide a recuperação.
Checklist de produção

Pronto para produção?

Responsabilidade

Objetivo, escopo e owner estão definidos.

Segurança

Credenciais e integrações seguem menor privilégio.

Validação

Falha e recuperação foram testadas e documentadas.

Versão e referências

Documentação sensível à versão

Referência editorial revisada para Grafana 13.2. Recursos, APIs, breaking changes, plugins e comportamento de HA devem ser reconfirmados na documentação da versão efetivamente instalada.