Perfeito — isso é uma boa prática mesmo: nunca colocar URL real de empresa em repositório público.
Aqui está o seu README em português, limpo e pronto para GitHub público:
Ambiente local de observabilidade utilizando Grafana (Docker + WSL2) conectado a uma API remota do Zabbix, com foco em aprendizado de monitoramento, integração via API e automação de infraestrutura.
Este projeto simula um cenário real de observabilidade onde um Grafana local consome métricas de um servidor Zabbix remoto através de API.
O objetivo é estudo e prática de:
- Observabilidade (métricas, dashboards e monitoramento)
- Integração com APIs (Zabbix JSON-RPC)
- Ambientes com Docker
- Base para automação com Python
┌──────────────────────────────┐
│ Zabbix Server (Remoto) │
│ https://zabbix.example.com│
└─────────────┬────────────────┘
│ API (JSON-RPC)
▼
┌────────────────────────────────────────┐
│ Máquina Local (Windows + WSL2) │
│ │
│ ┌──────────────────────────────┐ │
│ │ Docker Container (Grafana) │ │
│ │ - Porta: 3000 │ │
│ │ - Plugin Zabbix │ │
│ └─────────────┬────────────────┘ │
│ ▼ │
│ Dashboard no navegador │
└────────────────────────────────────────┘
- 🐳 Docker
- 📊 Grafana
- 🔗 Zabbix API (JSON-RPC)
- 🐧 WSL2 (Ubuntu)
- 🐍 Python (futuro para automação)
observability_lab/
├── docker-compose.yml # Configuração do Grafana
├── README.md # Documentação do projeto
├── scripts/
│ └── zabbix_api.py # Integração futura com API do Zabbix
├── dashboards/ # Dashboards exportados do Grafana
└── configs/ # Arquivos de configuração opcionais
git clone https://github.com/seu-usuario/observability_lab.git
cd observability_labdocker compose up -dAbra no navegador:
http://localhost:3000
Usuário padrão:
- Usuário: admin
- Senha: admin
Dentro do Grafana:
- Acesse Data Sources
- Adicione Zabbix
- Configure a URL da API:
https://zabbix.example.com/api_jsonrpc.php
- Autentique com:
- usuário e senha do Zabbix ou
- token de API (caso disponível)
- O Grafana é exposto apenas localmente:
ports:
- "127.0.0.1:3000:3000"- Não há exposição para a rede externa
- O acesso ao Zabbix é feito via API autenticada
- Ambiente destinado exclusivamente para aprendizado
- Automação com Python para consumo da API do Zabbix
- Processamento de métricas
- Geração automática de relatórios
- Provisionamento de dashboards como código
- Integração com Prometheus (opcional)
O projeto será expandido para:
- Autenticação via API do Zabbix
- Coleta de hosts e métricas
- Transformação de dados
- Exportação em JSON/CSV
- Automação de relatórios
Este projeto tem como foco:
- Entender arquitetura de observabilidade
- Trabalhar com APIs reais (Zabbix JSON-RPC)
- Utilizar Docker no dia a dia
- Criar dashboards no Grafana
- Evoluir para automação com Python
Este projeto tem finalidade educacional e utiliza apenas integrações autorizadas com sistemas de monitoramento. Nenhum serviço é exposto publicamente.
Projeto de aprendizado em observabilidade, automação de infraestrutura e integração de sistemas.