Jakemon Observability Stack Hub

Part of the Simple Agility stack. jakemon is the stack's observability plane — the data backbone every Simple Agility product (Wikantik, Roller, and those to come) joins its own data against. Its contracts with the rest of the stack are documented separately: SimpleAgilityObservabilityPlane (what it owns, push feeds versus pull queries, the "do not build this in your backend" list) and SimpleAgilityTelemetryContract (what products must emit). This hub covers how jakemon itself is built and operated.

jakemon is the centralized observability stack for the host fleet: metrics, logs, dashboards, and alerting. It lives in its own repo (~/source/jakemon), separate from wikantik — the wikantik observability overlay was retired in May 2026 and must not be re-added there.

Architecture in one paragraph

The model is push-based: every fleet host runs a Grafana Alloy agent (universal config in agent/, per-host app scrape targets in hosts/<host>/apps.alloy) that ships metrics and logs to the central stack — Prometheus + Loki + Grafana + Alertmanager — running via Docker Compose on docker2 (192.168.0.5). Two custom exporters feed Prometheus: cf-analytics-exporter (Cloudflare analytics) and the search-visibility exporter (Google/Bing/Yandex webmaster data). The visibility-shipper sidecar posts retained search history, source-generic opportunities and the measured Click-Through Rate (CTR) curve nightly into Wikantik's /admin/insights/ingest — the reference push feed of the plane contract. The NAS is reached by tar-over-ssh instead of the standard agent deploy.

Known stale doc: the repo README and .env.example still say the central stack runs on inference — that host was decommissioned July 2026. remote.env (JAKEMON_CENTRAL=docker2) is authoritative.

Operating it

• bin/validate.sh — config check across all hosts before any deploy
• bin/deploy-central.sh — deploy the central stack to the JAKEMON_CENTRAL host
• bin/deploy-agent.sh <host> — deploy/update one host's Alloy agent
• Adding a host = edit JAKEMON_HOSTS in remote.env, add hosts/<host>/apps.alloy if it has apps, deploy the agent
• Dashboards are provisioned from the repo (dashboards/) — edit JSON in git, redeploy central; don't hand-edit in the Grafana UI

Pages

• Simple Agility Observability Plane — jakemon's role and boundary in the stack; the out-contract
• Simple Agility Telemetry Contract — what products must emit for jakemon to capture
• Search Visibility Exporter — the SEO/webmaster data pipeline and its webmaster_* metrics
• Jakemon Dashboards Inventory — what each provisioned dashboard shows
• Host: docker2 — Monitoring Central — ports, access, and the open-Prometheus agent tip

See Also

• Simple Agility Stack Hub — the stack this plane serves
• Simple Agility On-Call Automation — where jakemon's alerts are headed
• Home Lab Infrastructure Hub — the fleet this stack watches