Erich Blume ce1f696bd8 Add Reference section with 24 technical reference cards

Phase 2 of documentation restructuring. Creates docs/reference/ with:

Services (16):
- alloy, argocd, borgmatic, 1password, forgejo, grafana
- jellyfin, kiwix, loki, miniflux, navidrome, postgresql
- prometheus, teslamate, transmission, zot

Infrastructure (3):
- hosts - Device inventory
- tailscale - ACLs, groups, tags
- routing - DNS domains and port mappings

Kubernetes (2):
- cluster - Minikube specs
- apps - ArgoCD application registry

Storage (2):
- sifaka - Synology NAS configuration
- backups - Backup policy

All cards use wiki-links for cross-referencing and include YAML
frontmatter with title and tags for Quartz.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-02-03 13:22:19 -08:00

1.5 KiB

Raw Blame History

title

Grafana Alloy

Unified observability collector for metrics and logs with two deployments:

Indri (host) - System metrics and service logs from macOS host
Kubernetes (DaemonSet) - Automatic pod log collection and service health probes

Quick Reference

Property	Value
Indri Binary	`~/.local/bin/alloy`
Indri Config	`~/.config/grafana-alloy/config.alloy`
K8s Namespace	`alloy`
K8s Image	`grafana/alloy:v1.8.2`
ArgoCD App	`alloy-k8s`

Metrics Collected

From Indri

System metrics via prometheus.exporter.unix
Textfile collector: minikube.prom, borgmatic.prom, zot.prom, jellyfin.prom
Zot registry metrics from http://localhost:5050/metrics
Pushed to prometheus via remote_write

From Kubernetes

All pod logs via loki.source.kubernetes
Service health probes: miniflux, kiwix, transmission, devpi, argocd

Logs Collected

Brew services: forgejo, tailscale

mcquack LaunchAgents: alloy, borgmatic, zot, jellyfin

Logs pushed to loki at https://loki.tail8d86e.ts.net/loki/api/v1/push.

Why Built from Source

The Homebrew bottle uses CGO_ENABLED=0, which breaks Tailscale MagicDNS. Building with CGO_ENABLED=1 uses the macOS native resolver.

prometheus - Metrics storage
loki - Log storage
grafana - Visualization

1.5 KiB Raw Blame History