Files
2026-02-09 17:14:40 -03:00

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

🧪 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)

  1. Grafana → Configuration → Data Sources → Add data source
  2. Selecione "JSON API"
  3. URL: http://monitoring-api:5000
  4. Click "Save & Test"

Opção B: Prometheus (Para Gráficos)

  1. Grafana → Configuration → Data Sources → Add data source
  2. Selecione "Prometheus"
  3. URL: http://prometheus:9090
  4. 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:

  1. Grafana → Create → Import
  2. Copie o conteúdo de grafana/provisioning/dashboards/monitoring-dashboard.json
  3. 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

  1. Configure HTTPS: Use nginx/caddy como reverse proxy
  2. Credenciais seguras: Use secrets do Docker Compose
  3. Volumes persistentes: Configure para Grafana e Prometheus
  4. 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

💡 Dicas

  • Atualize o refresh interval em .env para ajustar frequência de coleta
  • Configure alertas no Grafana baseado em limites de tempo de atendimento
  • Exporte dashboards para compartilhar com equipe