blumeops/docs/zk/grafana-log.md
Erich Blume 4ccb7b9a26 Fix wiki-links to use filename-based resolution (#90)
## Summary
- Quartz's "shortest" path mode resolves wiki-links by **filename**, not frontmatter title
- Previous PR used title-based links like `[[Grafana Alloy]]` which looked for non-existent `Grafana-Alloy.md`
- Now using filename-based links like `[[alloy|Grafana Alloy]]` which correctly resolve

## Changes
- Rename zk duplicate files with `-log` suffix (e.g., `argocd.md` → `argocd-log.md`)
- Rename `reference/storage/postgresql.md` to `postgresql-storage.md`
- Convert all 175 wiki-links from `[[Title]]` to `[[filename|Title]]` format
- Rename `doc-card-titles` task to `doc-filenames` (checks filename uniqueness, not titles)
- Update pre-commit hook for renamed task

## Deployment and Testing
- [x] Pre-commit hooks pass
- [x] `mise run doc-filenames` shows no duplicate filenames
- [ ] Verify wiki-links work correctly in Quartz build

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/90
2026-02-03 15:30:42 -08:00

1.9 KiB

id tags
grafana-log
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