Pular para o conteúdo
Alberto Mateus

Lab 02 Observability

Protótipo

Monitoramento operacional local-first e telemetria de rede

  • DOMÍNIO: INFRASTRUCTURE
  • ATUALIZADO EM: 2026-07-08

Leitura Rápida (30s)

[problema_chave]

Configurar um ecossistema de monitoramento centralizado e offline que identifique falhas em menos de 5 segundos, sem causar overhead de processamento sobre computadores legados com memórias antigas DDR2.

[papel_alberto]

Responsável pelo design da topologia de monitoramento sanitizada, configuração dos agentes locais nas estações de trabalho, desenvolvimento de templates SNMP simplificados e importação automática de conexões no Grafana.

[resultado_principal]

Configuração do Docker Compose de observabilidade concluída e documentada de forma segura.

[diagrama_arquitetura]

Topologia Lógica Sanitizada do Lab 02 ObservabilityDiagrama de infraestrutura de redes ilustrando o monitoramento de múltiplas estações de trabalho através de uma rede privada local que direciona dados ao Zabbix Proxy, Zabbix Server, banco de dados MySQL e visualização do Grafana.LAB-PC-01LAB-PC-02LAB-PC-03Private NetworkIsolada da Internet[SNMP & AGENT TRAFFIC]Zabbix ProxyColetor localZabbix ServerProcessador central[OLLAMA STUB MON]MySQL DBDados históricos (30 dias)GrafanaDashboardsPainel de AulaUso didático localMétricas ativas / SNMPRede Física / Túnel VPN sanitizadoFluxo didático pedagógico
contexto & objetivo

O Contexto Operacional

Cenário de Entrada

Laboratórios de ensino técnico e estações de trabalho de borda legadas requerem monitoramento contínuo para evitar falhas silenciosas de rede, gargalos térmicos de CPU ou estouro de espaço em disco, rodando sob severa restrição de hardware.

Objetivo Técnico

Desenvolver uma stack local baseada em Docker Compose unificando Zabbix Server, Zabbix Agent 2 e Grafana para coletar dados SNMP e telemetria do sistema.

restrições

Restrições de Projeto

  • Consumo de Recursos Minimizado

    Garantir que o Zabbix Agent 2 consuma menos de 5% de processamento geral em computadores legados.

  • Sanitização de Informações

    Ocultar endereços IP internos, nomes de alunos, comunidades SNMP e credenciais em arquivos públicos.

  • Provisionamento Automatizado

    Evitar a necessidade de configurações manuais nas consoles web ao reiniciar os servidores.

camadas

Estrutura de Sistemas em Camadas

LAYER 01 //

Coleta (Zabbix Agent 2)

Agentes de Sistema Operacional

Coleta dados de uso de CPU, temperatura de placa-mãe física, consumo de memória RAM e integridade de blocos de disco nas estações locais.

LAYER 02 //

Coleta de Rede (SNMP)

Telemetria de Ativos físicos

Coleta dados de tráfego de entrada/saída em interfaces físicas e túneis VPN WireGuard utilizando pacotes SNMP estruturados.

LAYER 03 //

Servidor de Observabilidade

Zabbix Server & Frontend

Console que centraliza o processamento de itens de monitoramento, armazena logs históricos em MySQL local e dispara triggers de alerta.

LAYER 04 //

Visualização (Grafana)

Dashboards unificados

Mecanismo que consome a API JSON-RPC do Zabbix Server para renderizar gráficos de performance e relatórios de disponibilidade.

LAYER 05 //

Módulo Pedagógico

Transposição didática

Dashboards de Grafana expostos de forma simplificada em salas de aula para ensinar aos estudantes conceitos práticos de redes e confiabilidade (SRE).

decisões

Matriz de Decisão Arquitetural (ADRs)

ADR-OBS-01accepted

Templates SNMP customizados e restritos

Contexto
Templates SNMP padrão do Zabbix executam varreduras amplas que sobrecarregam processadores antigos de roteadores locais.
Decisão
Escrever templates de monitoramento focados estritamente nas interfaces de rede ativas (ex. wg0) e em status de carga média.
Consequências
Overhead de monitoramento sobre os ativos de rede reduzido a níveis negligenciáveis, sem perda das métricas críticas.
ADR-OBS-02accepted

Provisionamento automático de Datasources via YAML

Contexto
Fazer login no Grafana e cadastrar o endpoint do Zabbix manualmente em cada laboratório implantado consome tempo e induz a erros.
Decisão
Utilizar arquivos de configuração do Grafana (`grafana/provisioning/datasources/`) para registrar o datasource do Zabbix automaticamente na inicialização.
Consequências
Stack 100% configurada e operacional a partir do comando inicial docker compose up -d.
execução

Detalhamento da Implementação

A infraestrutura de monitoramento utiliza Docker Compose para orquestrar os containers locais. O Zabbix Agent 2 foi configurado e testado para rodar em Linux (Ubuntu) e Windows Hosts, fornecendo telemetria térmica e de uso. O provisionamento do Grafana automatiza a integração da API do Zabbix. Toda a topologia lógica foi documentada sem expor credenciais reais.

evidências

Evidências Técnicas Registradas

resultados

Resultados Obtidos

  • RESULTADO 01

    Configuração do Docker Compose de observabilidade concluída e documentada de forma segura.

  • RESULTADO 02

    Templates Zabbix mapeando tráfego de túnel VPN WireGuard e tráfego de interface.

  • RESULTADO 03

    Painéis de monitoramento do Grafana configurados via arquivos estáticos de provisionamento.

Nota de Segurança e Privacidade
  • [public] Para segurança cibernética e privacidade da instituição e de Alberto, todas as credenciais reais de banco de dados, chaves de comunidade SNMP, rotas de túnel VPN e IPs privados de rede foram completamente removidos ou substituídos por termos de placeholder lógico, tais como LAB-PC-01, Private Network e SNMP-Community.
evolução

Próximos Passos e Direções Futuras

Onboarding físico de estações legadas

planned

Instalar os agentes físicos Zabbix nos computadores antigos da escola para certificar o baixo overhead operacional na prática.

Painéis didáticos no Grafana

planned

Desenhar dashboards Grafana com cores simplificadas para facilitar a assimilação de dados de tráfego por alunos em formação.