🐛 技術調査 - GlitchTip

x-environment: &default-environment
  DATABASE_URL: postgres://postgres:postgres@postgres:5432/postgres
  SECRET_KEY: your-secret-key-here
  PORT: 8000
  GLITCHTIP_DOMAIN: https://glitchtip.example.com
  EMAIL_URL: smtp+tls://user:pass@smtp.example.com:587
  DEFAULT_FROM_EMAIL: glitchtip@example.com
  ENABLE_USER_REGISTRATION: "False"
  GLITCHTIP_RETENTION_DAYS: "90"

services:
  postgres:
    image: postgres:17
    environment:
      POSTGRES_DB: postgres
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
    restart: unless-stopped
    volumes:
      - postgres-data:/var/lib/postgresql/data

  valkey:
    image: valkey/valkey:8
    restart: unless-stopped

  web:
    image: glitchtip/glitchtip:latest
    depends_on: [postgres, valkey]
    ports:
      - "8000:8000"
    environment: *default-environment
    restart: unless-stopped
    volumes:
      - uploads:/code/uploads

  worker:
    image: glitchtip/glitchtip:latest
    command: ./bin/run-worker.sh
    depends_on: [postgres, valkey]
    environment: *default-environment
    restart: unless-stopped
    volumes:
      - uploads:/code/uploads

  migrate:
    image: glitchtip/glitchtip:latest
    depends_on: [postgres]
    command: "./manage.py migrate"
    environment: *default-environment

volumes:
  postgres-data:
  uploads:

# 1. 設定ファイルを配置
cp compose.sample.yml compose.yml
vi compose.yml

# 2. DB マイグレーション実行
docker compose run --rm migrate

# 3. サービス起動
docker compose up -d

# 4. ログ確認
docker compose logs -f web

# SMTP（STARTTLS）
EMAIL_URL="smtp+tls://user:pass@smtp.example.com:587"

# SMTP（SSL）
EMAIL_URL="smtp+ssl://user:pass@smtp.example.com:465"

# ユーザー名に @ が含まれる場合は URL エンコード
EMAIL_URL="smtp+tls://user%40gmail.com:pass@smtp.gmail.com:587"

# コンソール出力（テスト用）
EMAIL_URL="consolemail://"

# Mailgun
EMAIL_BACKEND=anymail.backends.mailgun.EmailBackend
MAILGUN_API_KEY=key-xxxxx

# SendGrid
EMAIL_BACKEND=anymail.backends.sendgrid.EmailBackend
SENDGRID_API_KEY=SG.xxxxx

docker compose run --rm web ./manage.py createsuperuser
# 作成後 https://glitchtip.example.com/admin/ にアクセス可能

helm repo add glitchtip https://gitlab.com/api/v4/projects/16325141/packages/helm/stable
helm repo update
helm install glitchtip glitchtip/glitchtip -f my-values.yaml

# my-values.yaml
image:
  repository: glitchtip/glitchtip
  tag: v6.0.0
  pullPolicy: IfNotPresent

env:
  normal:
    GLITCHTIP_DOMAIN: https://glitchtip.example.com
    ENABLE_USER_REGISTRATION: "false"
    GLITCHTIP_RETENTION_DAYS: "90"
  secret:
    SECRET_KEY: "ランダムな文字列をここに設定"
    DATABASE_URL: "postgresql://user:pass@external-db:5432/glitchtip"
    EMAIL_URL: "smtp+tls://user:pass@smtp.example.com:587"

# ソースマップ / DIF / アップロードファイルを S3 互換ストレージに保存
DEFAULT_FILE_STORAGE=storages.backends.s3boto3.S3Boto3Storage
AWS_ACCESS_KEY_ID=your-key
AWS_SECRET_ACCESS_KEY=your-secret
AWS_STORAGE_BUCKET_NAME=glitchtip-uploads
AWS_S3_ENDPOINT_URL=https://s3.example.com  # MinIO 等の互換ストレージの場合
AWS_S3_REGION_NAME=us-east-1

https://<public_key>@<host>/<project_id>
        └── ProjectKey.public_key        └── Project.id

pip install sentry-sdk

import sentry_sdk

sentry_sdk.init(
    dsn="https://abc123@glitchtip.example.com/1",
    traces_sample_rate=0.01,
    auto_session_tracking=False,
    release="v1.2.3",
    environment="production",
)

division_by_zero = 1 / 0

# Django: settings.py
import sentry_sdk
from sentry_sdk.integrations.django import DjangoIntegration

sentry_sdk.init(
    dsn="https://abc123@glitchtip.example.com/1",
    integrations=[DjangoIntegration()],
    traces_sample_rate=0.01,
    auto_session_tracking=False,
)

# Flask
import sentry_sdk
from sentry_sdk.integrations.flask import FlaskIntegration

sentry_sdk.init(
    dsn="https://abc123@glitchtip.example.com/1",
    integrations=[FlaskIntegration()],
    traces_sample_rate=0.01,
    auto_session_tracking=False,
)

npm install @sentry/browser @sentry/node @sentry/nextjs

// ブラウザ
import * as Sentry from "@sentry/browser";

Sentry.init({
  dsn: "https://abc123@glitchtip.example.com/1",
  tracesSampleRate: 0.01,
  autoSessionTracking: false,
  release: "v1.2.3",
  environment: "production",
});

// Node.js / Express
const Sentry = require("@sentry/node");
const express = require("express");

Sentry.init({
  dsn: "https://abc123@glitchtip.example.com/1",
  tracesSampleRate: 0.01,
  autoSessionTracking: false,
});

const app = express();
Sentry.setupExpressErrorHandler(app);

// Next.js: sentry.client.config.js / sentry.server.config.js
import * as Sentry from "@sentry/nextjs";

Sentry.init({
  dsn: "https://abc123@glitchtip.example.com/1",
  tracesSampleRate: 0.01,
  autoSessionTracking: false,
});

// Go
import "github.com/getsentry/sentry-go"

sentry.Init(sentry.ClientOptions{
    Dsn: "https://abc123@glitchtip.example.com/1",
    Environment: "production",
    Release: "v1.2.3",
})

pip install glitchtip-cli
glitchtip-cli --url https://glitchtip.example.com login

# リリース作成とソースマップアップロード
glitchtip-cli releases new v1.2.3 --org my-org --project my-project
glitchtip-cli releases set-commits v1.2.3 --auto --org my-org --project my-project
glitchtip-cli sourcemaps inject ./dist
glitchtip-cli sourcemaps upload ./dist --release v1.2.3 --org my-org --project my-project
glitchtip-cli releases finalize v1.2.3 --org my-org --project my-project

# .sentryclirc
[defaults]
url = https://glitchtip.example.com
org = my-org
project = my-project

[auth]
token = your-auth-token

# Heartbeat モニタ（cron 例）
*/5 * * * * curl -s https://glitchtip.example.com/api/0/monitors/<uuid>/checkin/

docker compose pull           # イメージ取得
docker compose up -d          # バックグラウンド起動
docker compose stop           # 停止
docker compose down           # 完全停止（コンテナ削除）
docker compose ps             # 状態確認
docker compose logs -f web    # Web ログ
docker compose logs -f worker # Worker ログ

docker compose pull
docker compose stop
docker compose up -d
docker compose logs -f web

GLITCHTIP_RETAIN_LEGACY_DATA=True
docker compose exec web ./manage.py import_legacy_events --limit 100000 --delete-source

# 圧縮ダンプ（推奨）
docker compose exec postgres pg_dump -U postgres -Fc postgres > backup_$(date +%Y%m%d_%H%M%S).dump

# SQL ダンプ
docker compose exec postgres pg_dump -U postgres postgres > backup.sql

# リストア
docker cp backup.dump <postgres_container>:/tmp/backup.dump
docker compose exec postgres pg_restore -c -U postgres -d postgres /tmp/backup.dump

# /etc/cron.d/glitchtip-backup
0 2 * * * root docker compose -f /opt/glitchtip/compose.yml exec -T postgres pg_dump -U postgres -Fc postgres > /backup/glitchtip_$(date +\%Y\%m\%d).dump

# v6 以降（vtasks）
environment:
  - VTASKS_CONCURRENCY=20
  - DATABASE_POOL_MAX_SIZE=20

# v5 以前（Celery）
environment:
  - CELERY_WORKER_AUTOSCALE=2,8
  - CELERY_WORKER_MAX_TASKS_PER_CHILD=10000

docker compose up -d --scale worker=3

# スケジューラを専用コンテナに分離する構成例
services:
  scheduler:
    image: glitchtip/glitchtip:latest
    command: ./bin/run-worker.sh
    environment:
      <<: *default-environment
      SERVER_ROLE: scheduler
      VTASKS_CONCURRENCY: "1"

  worker:
    image: glitchtip/glitchtip:latest
    command: ./bin/run-worker.sh
    environment:
      <<: *default-environment
      SERVER_ROLE: worker
      VTASKS_CONCURRENCY: "20"
    deploy:
      replicas: 3

GLITCHTIP_RETENTION_DAYS=90
GLITCHTIP_EVENT_HOT_DAYS=30
GLITCHTIP_LOG_HOT_DAYS=7
GLITCHTIP_RELEASE_RETENTION_DAYS=365

# DuckDB + S3 アーカイブ（コールドストレージ）
GLITCHTIP_ENABLE_DUCKDB=true
GLITCHTIP_COLD_STORAGE_BUCKET=s3://my-bucket/glitchtip-cold
GLITCHTIP_COLD_STORAGE_CLEANUP_ENABLED=true
DUCKDB_MEMORY_LIMIT=256MB

# アプリケーション基本応答確認
curl -f http://localhost:8000/api/0/

# Prometheus メトリクス（要認証トークン）
curl -H "Authorization: Bearer <AUTH_TOKEN>" http://localhost:8000/api/0/observability/

# prometheus.yml
scrape_configs:
  - job_name: 'glitchtip'
    static_configs:
      - targets: ['glitchtip.example.com']
    scheme: https
    metrics_path: /api/0/observability/
    bearer_token: '<GLITCHTIP_AUTH_TOKEN>'

ENABLE_OBSERVABILITY_API=true

server {
    listen 80;
    server_name glitchtip.example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    server_name glitchtip.example.com;

    ssl_certificate     /etc/letsencrypt/live/glitchtip.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/glitchtip.example.com/privkey.pem;

    client_max_body_size 40M;

    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_request_buffering off;
    }
}

# Traefik（Docker Compose ラベル）
services:
  web:
    image: glitchtip/glitchtip
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.glitchtip.rule=Host(`glitchtip.example.com`)"
      - "traefik.http.routers.glitchtip.entrypoints=websecure"
      - "traefik.http.routers.glitchtip.tls.certresolver=letsencrypt"
      - "traefik.http.services.glitchtip.loadbalancer.server.port=8000"

# セキュリティヘッダー
SECURE_HSTS_SECONDS=31536000
SECURE_HSTS_PRELOAD=true
SECURE_HSTS_INCLUDE_SUBDOMAINS=true
CSRF_TRUSTED_ORIGINS=https://glitchtip.example.com

# .env ファイル（compose.yml から参照）
SECRET_KEY=your-very-long-random-secret-key
DATABASE_URL=postgres://glitchtip:password@postgres:5432/glitchtip
VALKEY_URL=redis://valkey:6379
EMAIL_URL=smtp+tls://sender:password@smtp.example.com:587
GLITCHTIP_DOMAIN=https://glitchtip.example.com
DEFAULT_FROM_EMAIL=noreply@example.com

# compose.production.yml
services:
  web:
    environment:
      - LOG_LEVEL=WARNING
      - GLITCHTIP_RETENTION_DAYS=90

# compose.staging.yml
services:
  web:
    environment:
      - LOG_LEVEL=INFO
      - GLITCHTIP_RETENTION_DAYS=14
      - EMAIL_URL=consolemail://

docker compose -f compose.yml -f compose.production.yml up -d

# GitHub Actions
- name: Notify GlitchTip of release
  env:
    SENTRY_URL: https://glitchtip.example.com
    SENTRY_AUTH_TOKEN: ${{ secrets.GLITCHTIP_AUTH_TOKEN }}
    SENTRY_ORG: my-org
    SENTRY_PROJECT: my-project
  run: |
    glitchtip-cli releases new ${{ github.sha }}
    glitchtip-cli releases set-commits ${{ github.sha }} --auto
    glitchtip-cli releases finalize ${{ github.sha }}
    glitchtip-cli deploys new ${{ github.sha }} --env production

services:
  web:
    deploy:
      resources:
        limits:
          cpus: '1.0'
          memory: 512M
        reservations:
          memory: 256M
  worker:
    deploy:
      resources:
        limits:
          cpus: '2.0'
          memory: 1G

VTASKS_CONCURRENCY=20
DATABASE_POOL_MAX_SIZE=20
GRANIAN_WORKERS=2

# 1. ログを詳細モードに
LOG_LEVEL=DEBUG

# 2. 再起動
docker compose up -d

# 3. サービスごとのログ確認
docker compose logs -f web
docker compose logs -f worker

# 4. GlitchTip CLI で設定確認
glitchtip-cli info

# 5. テストイベント送信
glitchtip-cli send-event -m "Test: $(date)"

# 6. メンテナンスモード（DB 作業中にイベントを止める）
MAINTENANCE_EVENT_FREEZE=true docker compose up -d