github kj187/jarvis v1.0.0

latest releases: v2.1.0, v2.0.1-rc.1, v2.0.0...
5 months ago

๐ŸŽ‰ Jarvis v1.0.0 โ€” First Public Release

Jarvis is an open source web frontend for Prometheus Alertmanager โ€” interactive, realtime, and self-hosted.


Why Jarvis?

Most Alertmanager UIs are read-only dashboards. Jarvis is built for teams that need to act on alerts, not just observe them. It was inspired by Karma โ€” a great project โ€” but I was missing features that matter for day-to-day on-call work: full persistence across restarts, the ability to comment on individual alerts, a claiming system so the team knows who is handling what, and a solid foundation to build further operational tooling on top of.

  • Realtime alerts via WebSocket โ€” no page reload required
  • Persistent history โ€” full alert lifecycle in SQLite or PostgreSQL; survives restarts and reconnects
  • Claiming โ€” assign an alert to yourself so the team sees who is on it
  • Comments โ€” fingerprint-bound notes that survive re-fires
  • Silence management โ€” create, edit, extend, delete; full Alertmanager proxy
  • Expiring silence detection โ€” alerts approaching silence expiry surface as active 15 min early
  • Multi-cluster โ€” poll multiple Alertmanager instances simultaneously
  • Single binary โ€” Go backend embeds the Vite build; one container, no sidecar
  • Authentication โ€” none / internal (local accounts) / oidc (Keycloak, Authentik, Dex, โ€ฆ)

What's in this release

Everything. This is the first public release, so the full feature set ships at once.

The core loop: Jarvis polls your Alertmanager clusters every 15 seconds (configurable), writes every alert lifecycle event to SQLite or PostgreSQL, and pushes real-time updates via WebSocket to the React frontend. When you reload the page or restart the container, history is still there.

On top of that: label-based filtering with full Alertmanager matcher syntax (= / != / =~ / !~), URL-serialized so filters are shareable. Card and list views. A detail panel that shows labels, annotations, firing history, occurrence stats, claim ownership, and a comment thread โ€” all bound to the alert's fingerprint and persisted across re-fires. A silence builder with a live match preview so you know exactly what you're silencing before you commit.

Security-wise: distroless container, read-only filesystem, no-new-privileges, strict CSP, per-IP rate limiting on all mutating endpoints, SBOM + provenance attestations and keyless image signing on every release.

Full feature reference โ†’ README.md


Getting Started

No clone needed โ€” runs entirely from the published image.
All configuration options โ†’ README โ†’ Configuration

Local

mkdir jarvis && cd jarvis

Create a compose.yml:

services:
  jarvis:
    image: ghcr.io/kj187/jarvis:1.0.0
    ports:
      - "8080:8080"
    volumes:
      - jarvis_data:/data
    environment:
      JARVIS_CLUSTER_1_NAME: production
      JARVIS_CLUSTER_1_ALERTMANAGER_URL: http://alertmanager:9093
    restart: unless-stopped
    read_only: true
    tmpfs:
      - /tmp
    security_opt:
      - no-new-privileges:true
    cap_drop:
      - ALL

volumes:
  jarvis_data:
docker compose up -d
# http://localhost:8080

Kubernetes

Helm chart

helm install jarvis oci://ghcr.io/kj187/charts/jarvis \
  --version 1.0.0 \
  --set clusters[0].name=production \
  --set clusters[0].alertmanagerUrl=http://alertmanager:9093 \
  --set persistence.enabled=true

Full docs โ†’ README.md ยท Configuration ยท Helm chart ยท Authentication

Tech stack
Go 1.25 ยท Echo v4 ยท SQLite / PostgreSQL (CGO-free) ยท React 19 ยท TypeScript ยท Vite ยท Tailwind CSS v4 ยท Zustand v5 ยท TanStack Query v5 ยท distroless container

Built with AI โ€” Jarvis was developed entirely using AI coding assistants. This is an intentional workflow choice, not a shortcut: the codebase follows established Go and React best practices, enforces security standards through automated tooling (gosec, govulncheck, golangci-lint, pnpm audit) on every commit and in CI, and applies defense-in-depth measures (strict CSP, read-only container filesystem, no-new-privileges).

Feedback and contributions welcome โ€” see CONTRIBUTING.md. If Jarvis is useful to you, a โญ on GitHub is always appreciated!

Container Image

docker pull ghcr.io/kj187/jarvis:1.0.0

Verify with Cosign

cosign verify ghcr.io/kj187/jarvis@sha256:521be7e2a03fcf11476935e0e890e3526dabcb4c173d1487abf08bb57daaf09f \
  --certificate-identity-regexp="https://github.com/kj187/jarvis/.*" \
  --certificate-oidc-issuer="https://token.actions.githubusercontent.com"

Changelog 1.0.0

Added

  • Initial open source release of Jarvis
  • Realtime alert view via WebSocket (card and list layout)
  • Persistent alert history stored in SQLite (WAL mode, single-writer)
  • PostgreSQL support via DSN-based dialect detection (JARVIS_DB_DSN=postgres://...)
  • Alert claiming โ€” assign yourself to an alert so the team sees who is on it
  • Alert comments โ€” fingerprint-bound notes that survive restarts and re-fires
  • Full label-based filtering with = / != / =~ / !~ matchers, URL-serialized
  • Alert detail panel (labels, annotations, firing history, statistics, AI prompt section)
  • Summary/description section in alert detail panel
  • Multi-cluster support via JARVIS_CLUSTER_N_* environment variables
  • Silence management โ€” create, edit, extend, delete; full Alertmanager proxy
  • Silence history tab in alert detail panel
  • Inline claim/release and silence controls in list view
  • 60s grace period to prevent ghost-resolves
  • Immutable append-only audit log for full alert lifecycle history
  • 20-minute in-memory window for recently resolved alerts (survives brief poll gaps)
  • Immediate poll trigger after silence create/edit/delete actions
  • Paginated resolved view with configurable page size
  • Per-state alert counts displayed in navigation pills
  • User settings panel (page size, view preferences)
  • Authentication via JARVIS_AUTH_MODE โ€” none (default) or local (username/password)
  • Login/setup UI and admin panel for local auth mode
  • Dark/light theme toggle
  • Responsive header with mobile hamburger menu
  • Helm chart with OCI publish workflow (oci://ghcr.io/kj187/charts/jarvis)
  • Test Alertmanager in dev compose for local development without a live cluster
  • Single self-contained binary: Go backend embeds the Vite frontend build
  • Distroless container image with read-only filesystem and no-new-privileges
  • SBOM attestation, provenance attestation, and keyless image signing on all releases
  • GitHub Actions CI pipeline (Go tests + lint + govulncheck; frontend tests + build)
  • Helm chart unit tests via helm-unittest integrated into CI and pre-commit

Changed

  • Upgraded Vite from 6.4.3 to 8.0.16
  • Upgraded TypeScript from 5.9.3 to 6.0.3; removed deprecated baseUrl from tsconfig (paths work standalone since TS 5.5, Vite alias is defined independently)
  • Upgraded golang.org/x/crypto from 0.50.0 to 0.53.0
  • Upgraded GitHub Actions: actions/setup-go 5.6.0โ†’6.4.0, codecov/codecov-action 4.6.0โ†’7.0.0, docker/setup-qemu-action 3.7.0โ†’4.1.0, github/codeql-action 3.36.2โ†’4.36.2, sigstore/cosign-installer 3.9.1โ†’4.1.2

Fixed

  • Fingerprint regex tightened to match Alertmanager's actual format
  • Structured request access logging via slog
  • CSP connect-src restricted to 'self' only
  • Stable sort in resolved view โ€” tie-break by severity then alertname
  • Claim release delayed by 65 s to survive grace-period re-fires
  • Comment ownership checks use user_id; delete icon hidden for other users' comments
  • Alert card and list components display correctly in light theme
  • Force list view for resolved and suppressed state tabs (card layout not useful there)
  • View toggle hidden when state filter is not active
  • Default state filter set to active on bare URL load
  • Release workflow: generate release notes from CHANGELOG instead of GitHub auto-notes
  • Release workflow: add container image digest, cosign verify block, and contributor list to GitHub Release body
  • Release workflow: rewrite release body assembly with printf; use gh CLI for release creation; exclude bot accounts from contributor list
  • Containerfile: include pnpm-workspace.yaml in COPY step to fix frontend build in container

Security

  • Per-IP rate limiting on all mutating endpoints
  • Maximum length enforcement on all free-text input fields (claims, comments, silence matchers)
  • Comment DELETE scoped to fingerprint to prevent cross-alert IDOR
  • sslmode=require enforced in all production PostgreSQL documentation examples

Don't miss a new jarvis release

NewReleases is sending notifications on new releases.