3.2 KiB
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 /- StatusGET /health- Health checkGET /api/tickets- Tickets em JSONGET /metrics- Métricas PrometheusGET /api/summary- Resumo estatísticoGET /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