Files
monitoramento_personalizeit/ARCHITECTURE.md
2026-02-09 17:14:40 -03:00

3.2 KiB

🏗️ Arquitetura

Fluxo de Dados

PersonalizeIT API
       ↓
   (login)
       ↓
  API Client
  (bearer token)
       ↓
(busca tickets)
       ↓
PersonalizeIT API
   (tickets)
       ↓
Data Formatter
       ↓
    ┌──────────┬──────────┐
    ↓          ↓          ↓
  JSON    Prometheus  TimeSeries
    ↓          ↓          ↓
   (JSON)   (Metrics)   (TS)
    ↓          ↓          ↓
    └────────┬─────────┘
            ↓
      Flask API
       ↓      ↓
    JSON  Prometheus
    API   Endpoint
       ↓      ↓
    ┌──────┬──────┐
    ↓      ↓      ↓
Grafana  Prom  Bash
    ↓      ↓   Scripts
  Dash   Alert
    ↓      ↓
   UI   Notifi-
        cações

Componentes

📡 API Client (api_client.py)

  • Autenticação na PersonalizeIT API
  • Gerenciamento baseado em bearer token
  • Busca de tickets com filtros
  • Tratamento de erros e retry

🔄 Data Formatter (data_formatter.py)

  • Formata dados em 3 formatos:
    • JSON: Para datasources JSON do Grafana
    • Prometheus: Métricas no padrão Prometheus
    • TimeSeries: Dados agregados por tempo

🌐 Flask App (app.py)

Endpoints principais:

  • GET / - Status
  • GET /health - Health check
  • GET /api/tickets - Tickets em JSON
  • GET /metrics - Métricas Prometheus
  • GET /api/summary - Resumo estatístico
  • GET /api/timeseries - Série temporal

📊 Grafana

  • Visualização dos dados
  • 2 Datasources:
    • Prometheus (para gráficos)
    • JSON API (para tabelas)
  • Dashboard pré-configurado

🔥 Prometheus

  • Scraping de métricas
  • Storage de time series
  • Alerting baseado em regras

Configuração

.env
├── API_BASE_URL
├── API_USERNAME
├── API_PASSWORD
├── FLASK_PORT
├── REFRESH_INTERVAL
└── QUEUE_IDS

Cache e Refresh

  • Refresh Interval: Por padrão 30s (configurável em .env)
  • Cache: Dados em memória entre requisições
  • Atualização: Automática na primeira requisição após expiração

Escalabilidade

Para produção:

┌─────────────────────────┐
│   Reverse Proxy         │
│   (nginx/caddy)         │
└────────────┬────────────┘
             ↓
┌─────────────────────────┐
│  Load Balancer          │
└────────────┬────────────┘
      ┌──────┴──────┐
      ↓             ↓
   [Api 1]      [Api 2]
      ↓             ↓
      └──────┬──────┘
             ↓
        Redis Cache
             ↓
      PostgreSQL DB
   (histórico opcional)

Segurança

  • ✅ SSL/TLS para conexão com API
  • ✅ Bearer token para autenticação
  • ✅ Senhas em variáveis de ambiente (.env)
  • ✅ Health checks automáticos
  • ✅ Timeout em requisições

Monitoramento

O próprio sistema pode ser monitorado com:

  • Status HTTP endpoints
  • Logs estruturados
  • Prometheus metrics da app
  • Health checks do Docker