Track HiveGrid Cloud planning reference
This commit is contained in:
1 parent
b3d5ea6764
commit
e341c5938a
5784 files changed
+1104929
-3
No files matched your search
@@ -0,0 +1,68 @@
|
||||
# `infra/sentry` — Self-Hosted Sentry Stack
|
||||
|
||||
This directory contains the artifacts to deploy a **self-hosted Sentry** instance
|
||||
on the staging Hetzner host (`boilerplate-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.boiler.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.boiler.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`.
|
||||
Reference in new issue
Block a user