blumeops/docs/reference/operations/observability.md

---
title: Observability
tags:
  - operations
---

# Observability

Metrics, logs, and dashboards for BlumeOps infrastructure.

## Components

- [[prometheus|Prometheus]] - Metrics storage and querying
- [[loki|Loki]] - Log aggregation
- [[alloy|Alloy]] - Metrics and log collection
- [[grafana|Grafana]] - Dashboards and visualization
Phase 2: Add Reference section with 24 technical reference cards (#88) ## Summary - Create `docs/reference/` section with 24 technical reference cards - Services (16): alloy, argocd, borgmatic, 1password, forgejo, grafana, jellyfin, kiwix, loki, miniflux, navidrome, postgresql, prometheus, teslamate, transmission, zot - Infrastructure (3): hosts, tailscale, routing - Kubernetes (2): cluster, apps - Storage (2): sifaka, backups - Update README to mark Phase 2 as complete - Add towncrier changelog fragment ## Deployment and Testing - [ ] Build docs locally to verify wiki-links resolve - [ ] Deploy via ArgoCD and verify at docs.ops.eblu.me/reference/ 🤖 Generated with [Claude Code](https://claude.com/claude-code) Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/88 2026-02-03 14:27:37 -08:00			`---`
			`title: Observability`
			`tags:`
			`- operations`
			`---`

			`# Observability`

			`Metrics, logs, and dashboards for BlumeOps infrastructure.`

			`## Components`

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			`- [[prometheus\|Prometheus]] - Metrics storage and querying`
			`- [[loki\|Loki]] - Log aggregation`
			`- [[alloy\|Alloy]] - Metrics and log collection`
			`- [[grafana\|Grafana]] - Dashboards and visualization`