64 lines
2.8 KiB
Markdown
64 lines
2.8 KiB
Markdown
# 🛡️ 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:**
|
|
```bash
|
|
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.*
|