joao.goncalves
/
templates-zabbix-itguys
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
11 Commits 1 Branch 0 Tags 512 KiB
Python 92.5%
Shell 7.5%
Go to file
João Pedro Toledo Goncalves b4a56ed604 feat: Add pfSense OpenVPN Zabbix agent installation instructions with a cache system. 2026-01-05 19:37:22 -03:00
.gemini feat: Add PFSense SNMP template and documentation, include Gemini files and DHCP agent execution plan, and remove `.gemini/` from `.gitignore`. 2026-01-04 15:57:51 -03:00
deploy_package Initial commit - Arthur Gold Standard: Tools, Templates e Documentação 2026-01-04 15:07:32 -03:00
templates_gold feat: Add pfSense OpenVPN Zabbix agent installation instructions with a cache system. 2026-01-05 19:37:22 -03:00
.gitignore feat: Add PFSense SNMP template and documentation, include Gemini files and DHCP agent execution plan, and remove `.gemini/` from `.gitignore`. 2026-01-04 15:57:51 -03:00
README.md Initial commit - Arthur Gold Standard: Tools, Templates e Documentação 2026-01-04 15:07:32 -03:00
clean_hosts_export.py Initial commit - Arthur Gold Standard: Tools, Templates e Documentação 2026-01-04 15:07:32 -03:00
export_hosts_zabbix.py Initial commit - Arthur Gold Standard: Tools, Templates e Documentação 2026-01-04 15:07:32 -03:00
export_templates.py Initial commit - Arthur Gold Standard: Tools, Templates e Documentação 2026-01-04 15:07:32 -03:00
extract_nginx_config.py feat: Add comprehensive Nginx monitoring for Zabbix, including host configurations, templates, and utility scripts. 2026-01-05 00:53:31 -03:00
fix_ad_uuids.py Initial commit - Arthur Gold Standard: Tools, Templates e Documentação 2026-01-04 15:07:32 -03:00
fix_uuids.py Initial commit - Arthur Gold Standard: Tools, Templates e Documentação 2026-01-04 15:07:32 -03:00
generate_template_docs.py feat: Add a Zabbix template documentation generator script and initial documentation for the PFSense SNMP template. 2026-01-04 15:20:53 -03:00
get_group_uuid.py Initial commit - Arthur Gold Standard: Tools, Templates e Documentação 2026-01-04 15:07:32 -03:00
merge_exchange.py Initial commit - Arthur Gold Standard: Tools, Templates e Documentação 2026-01-04 15:07:32 -03:00
merge_nginx_templates.py feat: Add comprehensive Nginx monitoring for Zabbix, including host configurations, templates, and utility scripts. 2026-01-05 00:53:31 -03:00
regen_all.py Initial commit - Arthur Gold Standard: Tools, Templates e Documentação 2026-01-04 15:07:32 -03:00
regen_uuids.py Initial commit - Arthur Gold Standard: Tools, Templates e Documentação 2026-01-04 15:07:32 -03:00
template_nginx_custom_extracted.yaml feat: Add comprehensive Nginx monitoring for Zabbix, including host configurations, templates, and utility scripts. 2026-01-05 00:53:31 -03:00
validate_zabbix_template.py feat: Add pfSense hybrid template with OpenVPN monitoring, enhance YAML validation, and remove old DHCP execution plan. 2026-01-04 18:05:01 -03:00
zbx_export_hosts.yaml feat: Add comprehensive Nginx monitoring for Zabbix, including host configurations, templates, and utility scripts. 2026-01-05 00:53:31 -03:00

README.md

🛡️ Zabbix ITGuys - Gold Collection

Repositório Oficial de Ferramentas e Templates de Monitoramento de Alta Performance.

"Um alerta sem contexto é apenas ruído. Um alerta com solução é uma ferramenta." — Arthur "O Farol" Mendes

Este repositório contém a suíte de ferramentas e templates "Gold Standard" desenvolvida pela ITGuys para elevar o nível da observabilidade Zabbix. Aqui focamos em inteligência acionável, não apenas em coleta de dados.

🏆 O Padrão Arthur (Gold Standard)

Todo recurso neste repositório segue rigorosos critérios de qualidade:

  1. 🇧🇷 Localização Total: Tudo o que o operador vê (Items, Triggers, Graphs) está em Português do Brasil (PT-BR), claro e profissional.
  2. 🧠 Inteligência Acionável: Alertas explicam o motivo, o impacto e a solução.
  3. 🔮 Preditividade: Uso de funções como timeleft() e detecção de anomalias para prevenir incidentes antes que ocorram.
  4. ✅ Integridade Técnica: UUIDs v4 válidos, sem dependências quebradas e sintaxe YAML impecável.

🧰 Ferramentas (Toolchain)

Scripts em Python desenvolvidos para garantir a integridade e qualidade dos templates.

1. validate_zabbix_template.py (The Gatekeeper)

O validador definitivo para templates Zabbix (YAML).

  • Verifica: Sintaxe YAML, Duplicidade de UUIDs, Referências quebradas (Gráficos -> Itens, Dashboards -> Gráficos).
  • Garante: Conformidade estrita com o padrão UUIDv4.
  • Audita: Descrições em inglês (aviso) para garantir a tradução.

Uso:

python validate_zabbix_template.py templates_gold/template_app_pfsense_snmp.yaml

2. fix_uuids.py

Utilitário para correção em massa e higienização de templates.

  • Remove metadados sujos de versões instáveis (Zabbix 8.0).
  • Regenera UUIDs inválidos mantendo a consistência.

3. merge_exchange.py

Ferramenta para fundir o melhor de dois mundos: templates oficiais da Zabbix com customizações "Gold" da comunidade.

📂 Estrutura do Repositório

  • /templates_gold: Templates prontos para produção, validados e traduzidos.
    • Exemplo: template_app_pfsense_snmp.yaml (Monitoramento completo de pfSense via SNMP com análises de segurança e preditivas).
  • /community-templates: Fonte upstream de templates diversos.
  • /deploy_package: Scripts e arquivos para deploy automatizado de agentes e proxies.

✨ Como Contribuir

  1. Valide sempre: Antes de commitar qualquer template, execute o validate_zabbix_template.py.
  2. Traduza: Não deixe termos como "Incoming Traffic" ou "Discarded packets". Use "Tráfego de Entrada" e "Pacotes Descartados".
  3. Contextualize: Na descrição da trigger, explique o que fazer se o alerta disparar.

Mantido pela equipe de SRE da ITGuys.