Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
1.6 KiB
Pager
Docs: https://pager-2607d3.jonasled.dev/
Multi-tenant Opsgenie-like alerting. Go backend (Gin, Gorm, gormigrate, Logrus via go-libs, swaggo) + React PWA with Web Push.
Run
cd frontend && pnpm install && pnpm build # dev: pnpm dev (proxies /api to :8080)
cd ../backend && cp .env.example .env && go run . # serves API, UI (STATIC_DIR) and /swagger/index.html
Push needs HTTPS (or localhost). VAPID keys are generated once and stored in the DB unless set in env.
DB: DB_DRIVER = postgres | mariadb | sqlite, with single DB_HOST/PORT/USER/PASSWORD/NAME entries.
Use
- Register at
/register→ creates tenant + owner. Owner/admins add users in Team. - Team → Inbound shows the Alertmanager URL (
/api/ingest/<token>/alertmanager,send_resolved: true) and the generic webhook URL. - Alertmanager
firingcreates an alert or refreshes it (count + last refresh).resolvedcloses it. Changedsummary/description/labelpriority(P1–P5) update it; annotationcommentadds a comment. - Alerts list shows open-since, refresh count and last refresh. Assign, ack, close, comment in UI or from the notification buttons.
Regenerate API docs after changing annotations: cd backend && swag init --parseInternal -g main.go
Docs
Docusaurus site in docs/ (cd docs && pnpm install && pnpm start). Screenshots are not committed: they are taken with Playwright (pnpm screenshots) against the real app with demo data. The Forgejo Actions pipeline does this on every run and publishes the site to git-pages on the default branch: https://jonasled.jonasled.dev/pager/