69 lines
3.0 KiB
Markdown
69 lines
3.0 KiB
Markdown
# `infra/sentry` — Self-Hosted Sentry Stack
|
|
|
|
This directory contains the artifacts to deploy a **self-hosted Sentry** instance
|
|
on the staging Hetzner host (`hivegrid-staging`, see
|
|
`docs/improvement-plan/archive/STAGING-ACCESS.md`) via the existing Coolify-managed
|
|
Docker-Compose runtime.
|
|
|
|
## Purpose
|
|
|
|
- Aggregate **server-side errors** from the API + Worker containers
|
|
- Aggregate **browser errors** (incl. Replay + Performance) from the Web app
|
|
- Ingest **OpenTelemetry traces** via the Relay OTLP-HTTP endpoint
|
|
(consumed in Phase 02 task #33)
|
|
- Provide a DSGVO-compliant, EU-hosted alternative to SaaS Sentry
|
|
|
|
The companion light-weight alternative (GlitchTip) is documented in
|
|
`docs/observability/sentry-glitchtip-alternative.md` and is **not** the default —
|
|
it lacks full Performance / Replay / OTLP support.
|
|
|
|
## Prerequisites
|
|
|
|
- Hetzner host with **≥ 16 GB RAM, ≥ 4 vCPU, ≥ 50 GB free disk**
|
|
(Clickhouse + Kafka + Symbolicator are RAM-hungry; the staging host now has
|
|
32 GB RAM after the recent upgrade)
|
|
- Docker Engine ≥ 24 + Docker Compose v2 (provided by Coolify)
|
|
- Traefik v3.6 reverse-proxy from `coolify-proxy` (Let's Encrypt ACME via
|
|
`letsencrypt` cert resolver)
|
|
- DNS-record `sentry.saas-ctrl.com` → `46.225.5.93`
|
|
|
|
## Layout
|
|
|
|
```
|
|
infra/sentry/
|
|
├── README.md # this file
|
|
├── .gitignore # excludes runtime volumes + secrets
|
|
├── UPSTREAM.md # pinned getsentry/self-hosted version + clone strategy
|
|
├── upstream/ # populated at deploy time by install.sh (NOT committed)
|
|
│ └── .gitkeep
|
|
├── docker-compose.override.yml # overlay merged on top of upstream compose
|
|
├── sentry/sentry.conf.py # python-config overlay (single-org, no-signup, OTLP)
|
|
├── relay/config.yml # Relay OTLP-ingest config
|
|
├── traefik.labels.yml # Compose-fragment with Traefik labels
|
|
├── install.sh # wrapper that clones upstream + applies overlays + installs
|
|
├── .env.example # template for SENTRY_* secrets
|
|
└── backup/ # daily backup container
|
|
├── Dockerfile
|
|
├── backup.sh
|
|
└── crontab
|
|
```
|
|
|
|
## Deploy
|
|
|
|
See `docs/observability/sentry-selfhost.md` (full deploy + upgrade + backup
|
|
runbook). High-level:
|
|
|
|
1. Copy `.env.example` → `.env`, fill secrets (Coolify-Vault).
|
|
2. Run `./install.sh` (clones upstream at pinned tag, applies overlays,
|
|
installs).
|
|
3. In Coolify, attach this stack to the `sentry.saas-ctrl.com` domain.
|
|
4. Smoke-test per `## Test Requirements` in
|
|
`docs/improvement-plan/02-observability/sentry-selfhost-setup.md`.
|
|
|
|
## Versioning
|
|
|
|
- Upstream pin: `getsentry/self-hosted` tag **`25.12.1`** (see `UPSTREAM.md` for
|
|
rationale — skipping the buggy `25.12.0` migration release; staying on the
|
|
v25.x LTS-ish line until we manually qualify v26.x).
|
|
- GlitchTip alternative pin: `glitchtip/glitchtip:v6.1.6`.
|