Monitoramento

Ferramentas

1. Wrangler Tail (Real-time Logs)

O wrangler tail permite monitorar requests em tempo real no Worker:

# Tail de todos os requests
npx wrangler tail

# Filtrar por status de erro
npx wrangler tail --status error

# Filtrar por path
npx wrangler tail --search "/auth/"

# Formato JSON (para piping)
npx wrangler tail --format json

Output exemplo:

GET /api/apps - 200 OK - 12ms
POST /auth/login - 401 Unauthorized - 45ms
GET /optimizer/ - 200 OK - 8ms
POST /auth/login - 429 Too Many Requests - 2ms

2. Cloudflare Dashboard

Acesse Workers & Pages → profarma-apps para:

Recurso	Dados
Analytics	Requests/dia, CPU time, erros
Logs	Real-time streaming (últimas 24h)
Deployments	Histórico de versões
Errors	Stack traces (em dev mode)

3. D1 Dashboard

Acesse D1 → profarma-apps para:

Recurso	Dados
Console	Queries SQL diretas
Metrics	Rows read/written, query latency
Backups	Point-in-time recovery

---

Métricas Chave

Métrica	Valor Normal	Alerta
CPU time (p50)	< 10ms	> 50ms
CPU time (p99)	< 50ms	> 200ms
Error rate	< 0.1%	> 1%
Requests/dia	~1.000-5.000	—
D1 query latency (p50)	< 5ms	> 20ms

---

Alertas

Cloudflare Workers não tem alertas nativos integrados. Monitoramento é feito via:

1. Dashboard manual — verificação periódica
2. Wrangler tail — durante operações críticas
3. Status page — health checks automáticos (ver Status)

---

Logs Importantes

Auth Events

# Monitorar tentativas de login
npx wrangler tail --search "/auth/login" --status error

# Monitorar rate limiting
npx wrangler tail --search "429"

Sync Events

# Monitorar sync VTEX
npx wrangler tail --search "/optimizer/api/internal/"

# Monitorar erros no Durable Object
npx wrangler tail --search "do-sync" --status error

Guest Access

# Monitorar acessos guest
npx wrangler tail --search "/auth/guest/"

---

Procedimento de Incidente

1. Detectar: Via Dashboard, tail ou report manual
2. Avaliar: Severidade (P1-P4)
3. Mitigar: Rollback se necessário (< 30s)
4. Comunicar: Notificar canal de resposta rápida
5. Investigar: Logs via wrangler tail --format json
6. Resolver: Fix → deploy → verificação
7. Post-mortem: Documentar causa raiz