blumeops/docs/zk/grafana.md
Erich Blume 7112297150 Move zk cards to docs/zk/ for documentation restructuring
Phase 1 of docs restructuring: move all zettelkasten cards to a
temporary docs/zk/ subdirectory while preparing to build a new
Diataxis-based documentation structure.

- Move all existing markdown files from docs/ to docs/zk/
- Update zk-docs mise task to look in the new location
- Add docs/README.md explaining the restructuring plan

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-03 07:57:47 -08:00

1.9 KiB

id aliases tags
grafana
grafana
blumeops

Grafana Management Log

Grafana provides dashboards and observability for blumeops.

Service Details

Embedding Note

Grafana panel embedding via iframes was attempted for Homepage but didn't work well:

  • Homepage's iframe widget doesn't support width constraints (only height)
  • Grafana's "Public Dashboards" feature doesn't support template variables or PostgreSQL datasources
  • Anonymous auth would be required, which exposes all dashboards

Current config has allow_embedding: false. If revisiting this, see git history for the iframe attempt (2026-01-30).

Datasources

Name Type URL
Prometheus prometheus http://prometheus.monitoring.svc.cluster.local:9090
Loki loki http://loki.monitoring.svc.cluster.local:3100
TeslaMate postgres blumeops-pg-rw.databases.svc.cluster.local:5432

Dashboard Provisioning

Dashboards are provisioned via ConfigMaps with label grafana_dashboard: "1". The sidecar watches for these and loads them automatically.

To add a dashboard:

  1. Create ConfigMap in argocd/manifests/grafana-config/dashboards/
  2. Add label grafana_dashboard: "1"
  3. Optionally add annotation grafana_folder: "FolderName" for organization
  4. Sync the grafana-config ArgoCD app

Log

2026-01-30

  • Attempted Grafana iframe embeds for Homepage metrics panel
  • Issues: width constraints don't work, some panels fail to load
  • Reverted to authenticated-only access (no anonymous auth)

2026-01-19 (Phase 2)

  • Migrated from Homebrew/Ansible to Kubernetes
  • Helm chart mirrored to forge
  • Exposed via Tailscale Ingress