Instalar GlitchTip en un VPS: rastreador de errores soberano

Por qué migrar a GlitchTip ahora

Lo que obtiene con GlitchTip v6 autoalojado

• Huella reducida — solo cuatro contenedores (Django, Celery, PostgreSQL, Redis), frente a la veintena de servicios de Sentry self-hosted.
• Compatibilidad con el SDK de Sentry — todos los SDK oficiales de Sentry funcionan sin modificación; solo cambia el DSN.
• Soberanía de los datos — las trazas de errores y los datos de usuario permanecen en su infraestructura, bajo su política de retención.
• Licencia GPL-3.0 — el código es auditable, sin componentes propietarios ni funciones reservadas a un plan de pago.
• Monitorización de disponibilidad — GlitchTip incluye monitores de tipo uptime (ping HTTP) sin dependencia externa.
• Interfaz de gestión del rendimiento — seguimiento de las transacciones, de las trazas N+1 y de las consultas lentas mediante la API compatible con Sentry.
• Bajo consumo de RAM — 2 GB de RAM bastan para un uso individual o de equipo pequeño, sin ajustes de configuración.

Requisitos previos antes de empezar

Desplegar GlitchTip con Docker Compose

1. 01

   Crear el directorio de trabajo

   Conéctese a su VPS por SSH y cree un directorio dedicado:

   mkdir -p /opt/glitchtip && cd /opt/glitchtip

2. 02

   Crear el archivo de variables de entorno

   Cree un archivo .env con los valores de configuración:

   SECRET_KEY=<cadena-aleatoria-larga> — genérela con openssl rand -hex 32.
   DATABASE_URL=postgresql://glitchtip:contrasena@db:5432/glitchtip
REDIS_URL=redis://redis:6379/0
GLITCHTIP_DOMAIN=https://glitchtip.su-dominio.com
[email protected]
EMAIL_URL=smtp://usuario:[email protected]:587

   Sustituya los valores por sus propias credenciales. El campo GLITCHTIP_DOMAIN debe coincidir exactamente con el dominio que va a proteger con HTTPS — queda inscrito en los DSN generados.

3. 03

   Crear el archivo docker-compose.yml

   Cree un archivo docker-compose.yml con el contenido siguiente (adaptado de la documentación oficial de GlitchTip):

   version: "3.8"
   x-environment: &default-environment
     env_file: .env
   services:
     db:
       image: postgres:16
       environment:
         POSTGRES_DB: glitchtip
         POSTGRES_USER: glitchtip
         POSTGRES_PASSWORD: contrasena
       volumes:
         - pg_data:/var/lib/postgresql/data
     redis:
       image: redis:7
       volumes:
         - redis_data:/data
     web:
       image: glitchtip/glitchtip:latest
       depends_on: [db, redis]
       ports:
         - "127.0.0.1:8000:8080"
       <<: *default-environment
     worker:
       image: glitchtip/glitchtip:latest
       command: ./bin/run-celery-with-beat.sh
       depends_on: [db, redis]
       <<: *default-environment
   volumes:
     pg_data:
     redis_data:

   Observe que el puerto 8000 está enlazado únicamente a 127.0.0.1: el servicio nunca se expondrá directamente, sino a través de un proxy inverso.

4. 04

   Inicializar la base de datos

   Ejecute las migraciones de Django para crear el esquema:

   docker compose run --rm web ./manage.py migrate

   Este comando se lanza una sola vez en la instalación y, después, en cada actualización a una nueva versión de GlitchTip.

5. 05

   Crear el primer superusuario

   Cree su cuenta de administrador:

   docker compose run --rm web ./manage.py createsuperuser

   Introduzca la dirección de correo y la contraseña cuando el asistente las solicite.

6. 06

   Iniciar la stack

   Inicie todos los contenedores en segundo plano:

   docker compose up -d

   Compruebe que los cuatro contenedores están en ejecución con docker compose ps. El servicio web responde en http://127.0.0.1:8000.

7. 07

   Configurar el proxy inverso nginx con HTTPS

   Instale nginx y Certbot si aún no lo ha hecho:

   apt install -y nginx certbot python3-certbot-nginx

   Cree un vhost en /etc/nginx/sites-available/glitchtip con el bloque server que escucha en el puerto 80, define server_name glitchtip.su-dominio.com y reenvía el tráfico hacia http://127.0.0.1:8000 con proxy_pass. Active la configuración y obtenga después el certificado:

   certbot --nginx -d glitchtip.su-dominio.com

   Certbot actualiza automáticamente el vhost para redirigir HTTP hacia HTTPS y añade el bloque SSL.

8. 08

   Conectar el SDK de Sentry de sus aplicaciones

   En la interfaz de GlitchTip, cree una organización y después un proyecto. GlitchTip genera un DSN con el formato https://<clave>@glitchtip.su-dominio.com/<id-proyecto>.

   En cada una de sus aplicaciones, sustituya el valor de SENTRY_DSN (o del parámetro dsn pasado a Sentry.init()) por ese nuevo DSN. Reinicie sus procesos. Los eventos aparecen en GlitchTip sin ninguna otra modificación.

Configuración posterior a la instalación

Resolución de los errores más comunes

GlitchTip en producción en un VPS