CIRCUITO
CARIOCA TI · DOCUMENTAÇÃO
♙
Zabbix · Observabilidade

Observabilidade

Conecte métricas, logs, eventos, topologia, Services e contexto operacional para acelerar investigação e causa provável.

zabbix://observabilidade
$ branch: 7.4
$ topic: Observabilidade
$ mode: production
$ method: evidence-first_
Metrics Quantificam estado e tendência.
Logs Explicam detalhes e contexto textual.
Events Marcam mudanças relevantes.
Topology Mostra relações e dependências.
Services Traduz falha técnica em impacto.
01 · Fundamento

Monitoramento e observabilidade não são sinônimos

Monitoramento tradicional parte de perguntas previamente conhecidas: está UP? CPU está alta? interface caiu? Observabilidade busca permitir investigação quando a pergunta ainda não está clara, conectando sinais diferentes para inferir comportamento interno a partir de evidências externas.

02 · Zabbix como plataforma

O Zabbix pode participar de uma arquitetura de observabilidade

Zabbix coleta métricas, logs, estados, eventos, disponibilidade, APIs e dados sintéticos. Também organiza tags, dependências, Services e dashboards. Ele não precisa ser tratado apenas como ferramenta de threshold; pode ser a camada que relaciona sintomas, contexto e impacto.

03 · Métricas

Métrica mostra forma, tendência e magnitude

Latência, perda, CPU, memória, filas, erros, potência óptica e tráfego permitem perceber mudança quantitativa. Métricas são especialmente fortes para baseline, tendência, capacidade e correlação temporal.

04 · Logs

Logs explicam o que a métrica não consegue dizer

Uma métrica pode mostrar aumento de erros; o log pode revelar timeout de banco, falha de autenticação ou exceção específica. No Zabbix, itens de log podem capturar eventos textuais, aplicar regex e gerar triggers sobre padrões relevantes.

05 · Eventos

Evento marca transição significativa

Nem todo valor precisa virar incidente. Eventos representam mudanças detectadas pelas regras: trigger em PROBLEM, recovery, discovery, internal events e Services. A qualidade da observabilidade depende de eventos bem modelados e com contexto suficiente.

06 · Topologia

Relação entre componentes reduz espaço de busca

Se um uplink alimenta dez switches, a queda do uplink explica múltiplos sintomas. Dependências e mapas ajudam a representar essa relação. Sem topologia, o operador vê uma lista plana e precisa reconstruir mentalmente a arquitetura durante a crise.

07 · Services

Impacto precisa existir além do componente

Services traduzem problemas técnicos em disponibilidade de serviço. Um switch down pode afetar “Internet — Filial Centro”; uma fonte redundante pode falhar sem interromper o serviço. Essa distinção melhora priorização.

08 · Tags

Contexto é dado

Tags como site, role, service, carrier, customer, region e scope transformam eventos em objetos pesquisáveis e correlacionáveis. Sem taxonomia, o Zabbix sabe que existem problemas; com taxonomia, ele consegue agrupar problemas que compartilham contexto.

09 · Cardinalidade

Contexto útil não precisa virar explosão de valores

Tags de alta cardinalidade e nomes inconsistentes dificultam filtros e correlação. Defina vocabulário estável. IDs únicos podem ser úteis, mas dimensões operacionais devem permanecer previsíveis.

10 · Baseline

O normal é específico de cada sistema

Uma interface com 80% de utilização pode ser normal em horário comercial e anormal de madrugada. Baseline histórico, médias, percentis calculados externamente ou faixas por período ajudam a detectar desvios com mais inteligência que limites universais.

11 · Anomalia

Desvio não é automaticamente incidente

Uma mudança abrupta merece investigação, mas pode ser comportamento planejado. Combine anomalia com contexto de mudança, manutenção, serviço e persistência. Observabilidade reduz falsos positivos quando múltiplos sinais contam a mesma história.

12 · Golden signals

Latência, tráfego, erros e saturação formam um núcleo útil

Para muitos serviços, quatro dimensões são extremamente úteis: latency, traffic/demand, errors e saturation. Zabbix consegue coletar essas classes em servidores, aplicações e redes, adaptando nomes e unidades ao domínio.

13 · USE

Utilization, Saturation e Errors funcionam muito bem em infraestrutura

Para recursos como CPU, memória, disco, interface e fila, pergunte: quanto está sendo usado, existe fila/saturação e há erros? Essa estrutura simples evita dashboards cheios de métricas sem função diagnóstica.

14 · RED

Rate, Errors e Duration funcionam bem em serviços

APIs e aplicações podem ser observadas por taxa de requisições, erros e duração/latência. Mesmo quando o Zabbix não implementa um framework RED formal, a modelagem dos itens pode seguir essa lógica.

15 · Correlação temporal

O que mudou junto é uma pista

Se perda aumenta às 14:32, tráfego atinge limite às 14:31 e BGP reseta às 14:33, a proximidade temporal sugere relação. Dashboards sincronizados por período aceleram esse tipo de investigação.

16 · Causalidade

Correlação não prova causa

Dois sinais mudarem juntos pode indicar causa comum, dependência ou coincidência. Use topologia, logs, testes ativos e conhecimento do sistema para confirmar. Evite automações que tratem correlação estatística como causalidade garantida.

17 · Mudanças

Deploy e change são eventos observáveis

Incidentes frequentemente começam após alteração. Quando possível, registre mudanças relevantes como eventos, tags, annotations externas ou dados correlacionáveis. “O que mudou antes da falha?” é uma das perguntas de maior valor em troubleshooting.

18 · Maintenance

Manutenção é contexto, não invisibilidade total

Maintenance evita ruído operacional, mas não deveria apagar completamente a capacidade de observar o comportamento. Dependendo da política, continue coletando métricas durante mudanças para comparar antes/depois.

19 · Logs estruturados

Estrutura melhora extração

Logs JSON ou formatos consistentes permitem preprocessing e extração de campos. Mesmo em texto, prefixos, IDs de transação e códigos padronizados aumentam correlação. Aplicações que produzem logs caóticos dificultam qualquer ferramenta.

20 · IDs de correlação

Um identificador pode unir camadas

Request ID, transaction ID, circuit ID, interface alias, incident ID ou customer ID podem conectar evidências. Zabbix pode armazenar e exibir alguns desses campos em tags, nomes ou valores, desde que cardinalidade e privacidade sejam consideradas.

21 · Métricas derivadas

O sinal bruto nem sempre é o mais útil

Contador de bytes pode virar bit/s; erros podem virar taxa; ocupação pode virar percentual; múltiplos estados podem virar disponibilidade agregada. Preprocessing, calculated items e dependent items permitem criar sinais mais próximos da decisão.

22 · SLI

Indicador de serviço é observabilidade aplicada ao usuário

SLI resume uma propriedade importante do serviço, como disponibilidade ou latência. Ele não substitui sinais técnicos; ele orienta onde investigar quando a experiência entregue está fora do objetivo.

23 · Sintético

Teste ativo mede o serviço de fora

Web scenarios, ICMP, DNS e HTTP podem representar a perspectiva do consumidor. Quando combinados com sinais internos, ajudam a distinguir “aplicação ruim” de “caminho ruim” ou “monitor ruim”.

24 · Multiponto

Vários pontos de observação reduzem ambiguidade

Se apenas um Proxy detecta latência e os demais não, a hipótese regional ganha força. Se todos falham simultaneamente, aumenta a evidência de problema central. Multiponto é uma técnica poderosa para redes distribuídas.

25 · Self-monitoring

O observador também precisa ser observado

Queue, pollers, preprocessing, banco, proxies e alerting precisam de métricas próprias. Sem isso, uma falha no Zabbix pode ser confundida com falha nos sistemas monitorados.

26 · Dark data

Dado coletado e nunca usado é custo puro

Itens sem dashboard, trigger, relatório, troubleshooting ou objetivo histórico devem ser revisados. Observabilidade não significa coletar tudo; significa coletar o suficiente para formular e testar hipóteses.

27 · Telemetria orientada a hipótese

Cada sinal precisa responder uma classe de pergunta

Para cada métrica ou log, pergunte: qual hipótese ele ajuda a confirmar ou descartar? Isso é mais útil que “o fabricante expõe esse OID, então vamos coletar”.

28 · Camadas

Observe de fora para dentro e de cima para baixo

Uma investigação eficiente pode começar pelo serviço, descer para região, host, processo e métrica; ou começar pelo sintoma técnico e subir para impacto. A arquitetura deve suportar os dois caminhos.

29 · Drill-down

Dashboard deve permitir aprofundamento progressivo

Resumo → Service → Problems → Host → item → histórico/log é um fluxo natural. Se o operador precisa abrir várias telas e refazer filtros manualmente, o contexto se perde.

30 · Runbooks

Observabilidade sem resposta continua incompleta

Quando um padrão recorrente é entendido, transforme conhecimento em runbook. O objetivo é reduzir tempo de diagnóstico futuro e tornar conhecimento transferível.

31 · Knowledge loop

Incidente deve melhorar o monitoramento

Depois de cada falha importante, pergunte: qual sinal faltou? qual alerta foi ruidoso? qual contexto não existia? qual dependência estava ausente? observabilidade madura evolui a partir de incidentes reais.

32 · Error budget

SLO ajuda a priorizar estabilidade

Quando um serviço já consumiu grande parte do orçamento de indisponibilidade, mudanças arriscadas podem ser adiadas e melhorias de confiabilidade ganham prioridade. Observabilidade fornece os dados para essa decisão.

33 · Performance

Degradação progressiva deve aparecer antes do outage

Tráfego, queue, latency, errors e resource saturation frequentemente mostram tendência antes da falha. Alertas de capacidade e dashboards históricos ajudam a agir antes que a indisponibilidade aconteça.

34 · Network observability

Rede precisa de mais que interface up/down

Inclua tráfego, erros, discards, latência, perda, BGP/OSPF, potência óptica, temperatura e estado físico quando relevantes. Uma interface UP pode estar degradada.

35 · Application observability

Aplicação precisa de mais que processo ativo

Combine health endpoint, response time, error rate, backend dependency, logs e synthetic tests. Um processo “running” pode estar completamente inútil para o usuário.

36 · Database observability

Banco saudável é mais que conexão TCP

Observe connections, locks, latency, cache hit, transactions, replication lag, storage e query health quando suportado. Serviço de banco disponível com latência extrema ainda é degradação.

37 · Alert quality

Alerta deve carregar hipótese inicial

Uma mensagem útil inclui serviço, local, severidade, duração e sinais relacionados. Em vez de “host unreachable”, algo como “WAN Site Centro indisponível; ICMP e BGP falharam; interface física permanece UP” direciona melhor a primeira ação.

38 · Human factors

Tempo cognitivo também é métrica de operação

Painéis, naming, tags e mensagens devem reduzir esforço mental. Um ambiente tecnicamente completo, mas impossível de interpretar sob pressão, possui baixa observabilidade operacional.

39 · Data retention

Investigação precisa de histórico suficiente

Se o incidente é descoberto dois dias depois, history de seis horas é inútil. Retenção deve considerar janela típica de investigação. Ao mesmo tempo, dados de alto volume podem ser agregados ou reduzidos.

40 · Export e integração

Nenhuma ferramenta precisa fazer tudo

Zabbix pode integrar Grafana, SIEM, data lakes, incident platforms e automações. Use o Zabbix como fonte, contexto ou detector quando adequado, sem forçar todos os casos de uso para dentro de uma única interface.

41 · API

Contexto pode ser enriquecido por automação

A API permite consultar hosts, problemas, tags, history e Services para construir relatórios, correlações ou fluxos externos. Automação deve preservar semântica do modelo e não criar um segundo inventário contraditório.

42 · Scientific troubleshooting

Hipótese, evidência e falsificação

Trate troubleshooting como método: formular hipótese, escolher sinais que poderiam confirmá-la ou refutá-la, coletar evidência e revisar. Isso reduz tentativa e erro e melhora documentação.

43 · Confidence

Nem toda conclusão possui a mesma confiança

Uma única métrica sugere; múltiplos sinais independentes aumentam confiança. Documente “indício”, “forte evidência” e “causa confirmada” quando o processo exigir. Isso evita fechar incidente cedo demais.

44 · Unknown unknowns

A arquitetura precisa permitir perguntas novas

Se todos os dados foram reduzidos a thresholds binários, investigar comportamento inesperado fica difícil. Preserve séries e contexto suficientes para explorar perguntas que não existiam quando o template foi criado.

45 · Observabilidade útil

O objetivo final é reduzir tempo até compreensão

Mais métricas não significam automaticamente melhor observabilidade. A medida prática é quão rápido a equipe consegue detectar, delimitar, formular hipótese, confirmar causa e entender impacto.

46 · Frameworks práticos

USE, RED e Golden Signals como guias

Framework Perguntas Aplicação
USEUtilization / Saturation / ErrorsCPU, disco, memória, interface, fila
REDRate / Errors / DurationAPIs e serviços
Golden SignalsLatency / Traffic / Errors / SaturationServiços distribuídos
47 · Fluxo de investigação

Do impacto à hipótese

SERVICE
Internet — RJ
   │
   ▼
PROBLEM
29 links indisponíveis
   │
   ▼
CONTEXTO
carrier=operadora-a
region=rj
scope=availability
   │
   ▼
SINAIS
ICMP   BGP   interface   latency   loss
  │     │       │           │       │
  └─────┴───────┴───────────┴───────┘
                  │
                  ▼
              HIPÓTESE
falha externa da operadora
                  │
                  ▼
             VALIDAÇÃO
outro ponto de observação /
teste de rota / contato carrier
48 · Confiança por múltiplos sinais

Uma hipótese fica mais forte quando sinais independentes convergem

Sinais Leitura
ICMP downIndício fraco de indisponibilidade
ICMP + BGP downEvidência mais forte de perda de conectividade
ICMP + BGP down + interface local upHipótese externa ganha força
Mesma falha em vários sites da mesma operadoraEvidência de domínio comum
Outro carrier normal nos mesmos sitesReduz hipótese de energia/site
49 · Exemplo de rede

Interface UP e serviço ruim

14:00  utilização = 72%
14:15  utilização = 88%
14:25  drops começam
14:28  latency = 140 ms
14:29  loss = 4%
14:31  BGP flaps
14:32  aplicações reclamam
14:34  interface continua operStatus=UP

Conclusão:
“interface UP” não é sinônimo de serviço saudável.

Sinais úteis:
- utilization
- discards
- errors
- latency
- loss
- routing state
- service status
50 · Exemplo de aplicação

Processo ativo, serviço indisponível

process = running
CPU = 22%
memory = 48%

mas:

HTTP /health = 500
DB latency = 3.2s
queue depth = 18.000
error log = "database timeout"

Leitura:
infraestrutura do processo está viva,
mas o serviço entregue está indisponível.
51 · Dashboard orientado à investigação

Resumo e evidência no mesmo lugar

Service status Impacto percebido.
Problems Eventos ativos e severidade.
Latency/Loss Qualidade do caminho.
Traffic/Errors Carga e degradação.
Logs Explicação textual.
Changes O que mudou antes.
Topology Dependências relevantes.
Health Zabbix Confiança no observador.
52 · Anti-patterns

Mais dados sem contexto não é observabilidade

Coletar tudo Aumenta custo sem necessariamente aumentar entendimento.
Só thresholds Perde investigação sobre comportamento inesperado.
Só logs Fica difícil perceber tendência e magnitude.
Só métricas Perde detalhes explicativos.
Tags livres Contexto vira inconsistente.
Dashboard sem topologia Sintomas ficam desconectados.
Service sem root cause Impacto aparece, causa fica escondida.
Alerta sem contexto Operador começa investigação do zero.
Sem eventos de mudança Deploy e incidentes ficam difíceis de relacionar.
Monitor sem self-monitoring Falha do observador parece falha do alvo.
Conclusão por um único sinal Aumenta falso diagnóstico.
Incidente sem feedback O sistema nunca aprende com falhas reais.
53 · Laboratório

Transformar um alerta simples em investigação rica

1. Sintoma Comece por uma trigger “WAN down”.
2. Contexto Adicione tags carrier/site/service.
3. Sinais Colete ICMP, BGP, interface, loss e latency.
4. Topologia Crie dependência quando houver causa conhecida.
5. Service Associe o problema ao serviço de Internet.
6. Dashboard Sincronize os sinais no mesmo período.
7. Logs/Events Inclua mudanças ou mensagens relevantes.
8. Hipótese Defina regra de interpretação.
9. Teste Simule falha interna e externa.
10. Runbook Documente evidências que diferenciam os casos.
54 · Método científico aplicado

Hipótese → teste → evidência → revisão

OBSERVAÇÃO
“Clientes do RJ estão lentos”

HIPÓTESE A
Saturação da operadora A

PREDIÇÃO
Se A for a causa:
- circuitos A degradam
- B permanece normal
- loss/latency sobem em A
- tráfego se aproxima do limite

TESTE
comparar:
A x B
RJ x SP
externo x interno

RESULTADO
evidência confirma ou refuta

AÇÃO
tratar causa

PÓS-INCIDENTE
melhorar sinais / triggers / runbook
55 · Checklist de produção

Observabilidade orientada à compreensão

✓ Métricas respondem perguntas operacionais claras
✓ Logs relevantes estão disponíveis
✓ Eventos possuem contexto suficiente
✓ Tags seguem taxonomia estável
✓ Topologia/dependências estão modeladas
✓ Services representam impacto real
✓ Dashboards permitem drill-down
✓ Períodos de gráficos podem ser sincronizados
✓ Golden Signals/USE/RED foram avaliados
✓ Mudanças importantes são correlacionáveis
✓ Self-monitoring do Zabbix existe
✓ Testes sintéticos complementam sinais internos
✓ Proxies multiponto são usados quando geografia importa
✓ Alertas carregam hipótese inicial/contexto
✓ Retenção suporta janela típica de investigação
✓ Dados sem uso são revisados
✓ LLD não gera cardinalidade inútil
✓ Incidentes recorrentes viram runbooks
✓ Pós-incidente gera melhoria de telemetria
✓ Conclusões distinguem indício de causa confirmada
✓ O sistema permite formular perguntas novas
56 · Referências técnicas

Base factual

Conteúdo estruturado sobre recursos do Zabbix 7.4 para métricas, logs, triggers, tags, event correlation, Services, dashboards, Web monitoring, proxies, preprocessing e self-monitoring. Os frameworks USE, RED e Golden Signals, método científico de troubleshooting, modelos de hipótese, multiponto, causalidade e desenho de observabilidade são síntese de práticas consolidadas de engenharia de confiabilidade e operação.

PRÓXIMA PÁGINA

Troubleshooting

A próxima página transforma esses princípios em diagnóstico sistemático do próprio Zabbix: coleta, unsupported items, queue, preprocessing, Proxy, banco, alertas e performance.

Continuar →
Atualização editorial 2026

Linha Zabbix 7.4

Zabbix combina métricas, logs, eventos, Services, topologia e exportação de dados. Observabilidade útil depende de contexto consistente, timestamps confiáveis e correlação, não apenas volume de dados.

Recursos e limites sensíveis à versão devem ser confirmados contra o patch exato instalado antes de mudanças em produção.