Skip to content

Runbook: GlitchTip — Error Tracking

Přehled

GlitchTip (errors.studio60.cz) slouží jako centrální error tracking pro všechny S60 aplikace. Dev agenti integrují Sentry SDK do svých aplikací → errory se posílají na GlitchTip → agenti mohou proaktivně reagovat.

Infrastruktura

  • URL: https://errors.studio60.cz
  • Server: sentinel (178.104.40.167)
  • Port: 127.0.0.1:8000 (nginx proxy)
  • Docker: /opt/glitchtip/docker-compose.yml (web + worker + redis)
  • DB: DO Managed PG, database glitchtip, user glitchtip
  • SSL: Let's Encrypt (auto-renew)

Správa

# Stav
cd /opt/glitchtip && docker compose ps
curl -s https://errors.studio60.cz/_health/

# Restart
cd /opt/glitchtip && docker compose restart

# Logy
docker logs s60-glitchtip-web --tail 50
docker logs s60-glitchtip-worker --tail 50

# Upgrade
cd /opt/glitchtip && docker compose pull && docker compose up -d

Integrace pro dev agenty

Každá aplikace potřebuje: 1. Vytvořit projekt v GlitchTip UI (https://errors.studio60.cz) 2. Získat DSN (Data Source Name) z projektu 3. Přidat Sentry SDK do aplikace:

NestJS (backend)

npm install @sentry/node

import * as Sentry from '@sentry/node';
Sentry.init({ dsn: '<DSN>', environment: 'production' });

React/Vue (frontend — prohlížeč)

npm install @sentry/browser

import * as Sentry from '@sentry/browser';
Sentry.init({ dsn: '<DSN>', environment: 'production' });

Env vars

  • DATABASE_URL — PG connection string
  • SECRET_KEY — Django secret
  • GLITCHTIP_DOMAIN — public URL
  • REDIS_URL — redis://glitchtip-redis:6379/0
  • DEFAULT_FROM_EMAIL — pro notifikace (zatím consolemail)

Notifikace

TODO: Nastavit email notifikace přes Resend nebo SMTP pro proaktivní alerting.