Erich Blume
254b93096a
## 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
54 lines
1.6 KiB
Markdown
54 lines
1.6 KiB
Markdown
---
|
|
title: Grafana Alloy
|
|
tags:
|
|
- service
|
|
- observability
|
|
---
|
|
|
|
# Grafana Alloy
|
|
|
|
Unified observability collector for metrics and logs with two deployments:
|
|
1. **Indri (host)** - System metrics and service logs from macOS host
|
|
2. **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|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|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.
|
|
|
|
**Note:** This may no longer be needed now that services use `*.ops.eblu.me` URLs (routed via Caddy) instead of `*.tail8d86e.ts.net`. Should be tested in the future.
|
|
|
|
## Related
|
|
|
|
- [[prometheus|Prometheus]] - Metrics storage
|
|
- [[loki|Loki]] - Log storage
|
|
- [[grafana|Grafana]] - Visualization
|