Monitoramento com Sentry¶

Opção 1: Sentry Cloud (Recomendado para início)¶

1. Crie uma conta em sentry.io
2. Crie um projeto Django
3. Copie o DSN
4. Configure no .env:

   SENTRY_DSN=https://xxx@xxx.ingest.sentry.io/xxx
   

Opção 2: Sentry Self-Hosted¶

Requisitos mínimos: 4GB RAM, 20GB disco.

git clone https://github.com/getsentry/self-hosted.git sentry/self-hosted
cd sentry/self-hosted
./install.sh
docker compose up -d

Acesse http://localhost:9000 e configure o DSN.

Eventos Capturados¶

• Todos os erros 500 automaticamente (integração Django)
• Erros de treinamento RAG (agents/rag.py)
• Erros na geração de respostas (chats/engine.py)
• Tentativas de uso com trial expirado (warning)
• Créditos esgotados (info)

Contexto nos Eventos¶

Cada evento inclui: - Usuário (id, email, role) - Escola (nome, plano) — para admins - Environment, release e tags personalizadas

Health Check¶

GET /health/ retorna {"status": "ok", "sentry": true/false} — usado pelo Docker e monitores externos.