5.7 KiB
5.7 KiB
🛠️ Troubleshooting & FAQ
❌ Problemas Comuns
1. "Connection refused" ao acessar http://localhost:3000
Causa: Containers não estão rodando ou porta já está em uso
# Verificar status
docker-compose ps
# Se não estiver rodando
docker-compose up -d
# Se porta já está em uso
lsof -i :3000
kill -9 <PID>
docker-compose down
docker-compose up -d
2. Grafana mostra "Data source is not responding"
Causa: Datasource não consegue conectar à API
# Verificar se API está rodando
docker-compose logs monitoring-api
# Verificar conectividade do container Grafana
docker-compose exec grafana ping monitoring-api
# Reiniciar API
docker-compose restart monitoring-api
3. API retorna "Failed to authenticate"
Causa: Credenciais inválidas ou API PersonalizeIT indisponível
# Verificar credenciais
cat .env | grep API_
# Testar login manualmente
curl -X POST \
-H 'Content-Type: application/json' \
-d '{"email":"seu_email@exemplo.com","password":"sua_senha"}' \
https://api-personalizeit.zapplataforma.chat/auth/login
# Verificar logs
docker-compose logs monitoring-api | grep -i "authent"
4. "ENOENT: no such file or directory, open '.env'"
Causa: Arquivo .env não foi criado
# Criar .env a partir do exemplo
cp config/.env.example .env
# Editar com credenciais
nano .env
5. Prometheus mostra "Unhealthy Target"
Causa: Prometheus não consegue scrape da API
# Verificar URL no prometheus.yml
# Deve ser: http://monitoring-api:5000/metrics
# Verificar se métrica está acessível
curl http://localhost:5000/metrics
# Se vazio, significa sem dados. Tudo ok.
6. "permission denied" ao executar setup.sh
Causa: Script sem permissão de execução
chmod +x setup.sh test-api.sh
./setup.sh
7. Docker Compose "service not found"
Causa: Nomes dos serviços estão incorretos
# Verifique os nomes em docker-compose.yml
# Devem ser: monitoring-api, grafana, prometheus
8. "Disk space insufficient"
Causa: Volumes do Docker muito grande
# Ver tamanho dos volumes
docker volume ls
docker system df
# Limpar volumes não usados
docker volume prune
# Remover dados históricos
docker-compose down -v
docker-compose up -d
⚙️ Otimizações
Melhorar Performance
- Aumentar intervalo de refresh (se dados menos atualizados ok)
REFRESH_INTERVAL=60 # Era 30s
- Limitar quantidade de tickets
# Na query da API, adicionar paginação
# Módulo API Client já suporta limitação
- Usar Redis para cache
# Adicionar ao docker-compose.yml
# Depois modificar app.py para usar Redis
Reduzir Consumo de Memória
- Usar volume para dados do Grafana
volumes:
- grafana-storage:/var/lib/grafana
- Limitar workers do Gunicorn
CMD ["gunicorn", "--workers", "2", "--bind", "0.0.0.0:5000", "app:app"]
📊 Monitoramento do Próprio Sistema
Métricas da API
# Ver saúde da API
curl http://localhost:5000/health
# Ver CPU e memória do container
docker stats monitoring-api
Métricas do Grafana
# Ver logs do Grafana
docker-compose logs grafana
# Ver consumo
docker stats grafana
Métricas do Prometheus
# Verificar targets
curl http://localhost:9090/api/v1/targets
# Verificar health
curl http://localhost:9090/-/healthy
🔐 Segurança
Checklist de Segurança
- ✅ .env não está commitado (verificar .gitignore)
cat .gitignore | grep .env
- ✅ Senhas não estão em logs
docker-compose logs | grep -i password
# Não deve encontrar nada
- ✅ HTTPS configurado (se em produção)
# Usar reverse proxy com SSL
- ✅ Firewall configurado
# Apenas portas 3000 e 5000 acessíveis
📝 Logs e Debug
Ativar debug mode
DEBUG=True # Em .env
Ver logs completos
# Tempo real
docker-compose logs -f
# Últimas 100 linhas
docker-compose logs --tail 100
# Apenas da API
docker-compose logs -f monitoring-api
Exportar logs
docker-compose logs > debug.log
cat debug.log
Log level em Python
# Em app.py, modificar:
logging.basicConfig(level=logging.DEBUG) # Era INFO
🔄 Resetar Tudo
# Parar todos os containers
docker-compose down
# Remover volumes (dados históricos)
docker-compose down -v
# Remover imagens
docker-compose down -v --rmi all
# Reconstruir
docker-compose build --no-cache
# Reiniciar
docker-compose up -d
📞 Quando Nada Funciona
- Verificar Docker
docker --version
docker run hello-world
- Verificar conectividade
ping -c 1 api-personalizeit.zapplataforma.chat
curl https://api-personalizeit.zapplataforma.chat/auth/login
- Recriar do zero
docker-compose down -v --rmi all
rm -rf grafana-storage prometheus-storage
rm .env
cp config/.env.example .env
# Configure .env
docker-compose up -d
- Buscar ajuda
# Coletar informações
docker-compose ps > info.txt
docker-compose logs >> info.txt
curl http://localhost:5000/health >> info.txt
# Compartilhar info.txt
🚀 Performance Tips
| Problema | Solução |
|---|---|
| Lento | Aumentar REFRESH_INTERVAL |
| Alto consumo memória | Reduzir workers gunicorn |
| Muitos dados | Fazer paginação ou filtrar |
| Sem dados | Verificar credenciais |
| Timeouts | Aumentar timeout em api_client.py |
| Erros de conexão | Verificar firewall/proxy |