3.2 KiB
3.2 KiB
📦 Guia de Instalação
⚙️ Pré-requisitos
- Docker Desktop (com Docker Compose incluído)
- Linux, macOS ou Windows WSL2
- Credenciais válidas para a API PersonalizeIT
🚀 Instalação Rápida (3 passos)
Passo 1: Configurar Credenciais
# Abra o arquivo .env
nano .env
Edite com suas credenciais:
API_USERNAME=seu_email@exemplo.com
API_PASSWORD=sua_senha
Passo 2: Iniciar os Serviços
# Dar permissão de execução aos scripts
chmod +x setup.sh test-api.sh
# Executar setup (opcional, mas recomendado)
./setup.sh
# Ou iniciar diretamente
docker-compose up -d
Passo 3: Acessar os Serviços
- Grafana: http://localhost:3000 (admin/admin)
- API: http://localhost:5000
- Prometheus: http://localhost:9090
🧪 Verificar Funcionamento
# Testar a API
./test-api.sh
# Ou manualmente
curl http://localhost:5000/health
curl http://localhost:5000/api/summary
🛑 Parar os Serviços
docker-compose down
🚪 Configurar Datasource no Grafana
Opção A: JSON Datasource (Para Tabelas)
- Grafana → Configuration → Data Sources → Add data source
- Selecione "JSON API"
- URL:
http://monitoring-api:5000 - Click "Save & Test"
Opção B: Prometheus (Para Gráficos)
- Grafana → Configuration → Data Sources → Add data source
- Selecione "Prometheus"
- URL:
http://prometheus:9090 - Click "Save & Test"
📊 Dashboard Pré-configurado
Um dashboard chamado "Monitoramento de Atendimento" já foi criado e deve aparecer automaticamente em Dashboards → Browse.
Se o dashboard não aparecer, você pode importá-lo manualmente:
- Grafana → Create → Import
- Copie o conteúdo de
grafana/provisioning/dashboards/monitoring-dashboard.json - Click "Load"
🔧 Troubleshooting
"Connection refused"
# Verificar status dos containers
docker-compose ps
# Reiniciar tudo
docker-compose restart
"Failed to authenticate"
# Verificar logs da API
docker-compose logs monitoring-api
# Verificar credenciais em .env
cat .env | grep API_
Sem dados no Grafana
# Testar endpoint diretamente
curl http://localhost:5000/api/summary
# Se vazio, verificar logs
docker-compose logs -f monitoring-api
📱 Usar em Produção
- Configure HTTPS: Use nginx/caddy como reverse proxy
- Credenciais seguras: Use secrets do Docker Compose
- Volumes persistentes: Configure para Grafana e Prometheus
- Backups: Configure backup automático do Grafana
Exemplo docker-compose para produção:
services:
monitoring-api:
# ... adicionar secrets
restart: always
grafana:
volumes:
- grafana-storage:/var/lib/grafana
restart: always
prometheus:
volumes:
- prometheus-storage:/prometheus
restart: always
📚 Documentação Adicional
- README.md - Documentação completa
- API Endpoints
- Criação de Dashboards
💡 Dicas
- Atualize o refresh interval em
.envpara ajustar frequência de coleta - Configure alertas no Grafana baseado em limites de tempo de atendimento
- Exporte dashboards para compartilhar com equipe