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: Loki
|
|
|
|
|
tags:
|
|
|
|
|
- service
|
|
|
|
|
- observability
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# Loki
|
|
|
|
|
|
|
|
|
|
Log aggregation system for BlumeOps infrastructure.
|
|
|
|
|
|
|
|
|
|
## Quick Reference
|
|
|
|
|
|
|
|
|
|
| Property | Value |
|
|
|
|
|
|----------|-------|
|
|
|
|
|
| **URL** | https://loki.ops.eblu.me |
|
|
|
|
|
| **Tailscale URL** | https://loki.tail8d86e.ts.net |
|
|
|
|
|
| **Namespace** | `monitoring` |
|
|
|
|
|
| **Image** | `grafana/loki:3.4.2` |
|
|
|
|
|
| **Storage** | 50Gi PVC |
|
|
|
|
|
| **Retention** | 31 days |
|
|
|
|
|
|
|
|
|
|
## Architecture
|
|
|
|
|
|
|
|
|
|
- Single-node deployment with filesystem storage
|
|
|
|
|
- TSDB index with 24h period
|
2026-02-03 15:55:31 -08:00
|
|
|
- Logs collected by [[Grafana Alloy|Alloy]] and pushed via Loki API
|
|
|
|
|
- Queried via [[Grafana]]
|
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
|
|
|
|
|
|
|
|
## Log Sources
|
|
|
|
|
|
|
|
|
|
**From Indri (via Alloy):**
|
|
|
|
|
- forgejo, tailscale (brew services)
|
|
|
|
|
- alloy, borgmatic, zot, jellyfin (LaunchAgents)
|
|
|
|
|
|
|
|
|
|
**From Kubernetes (via Alloy DaemonSet):**
|
|
|
|
|
- All pods in all namespaces
|
|
|
|
|
|
|
|
|
|
## Query Examples (LogQL)
|
|
|
|
|
|
|
|
|
|
```logql
|
|
|
|
|
{service="forgejo"} # All forgejo logs
|
|
|
|
|
{service="borgmatic", stream="stderr"} # Borgmatic errors
|
|
|
|
|
{host="indri"} |= "error" # All logs containing "error"
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Related
|
|
|
|
|
|
2026-02-03 15:55:31 -08:00
|
|
|
- [[Grafana Alloy|Alloy]] - Log collector
|
|
|
|
|
- [[Grafana]] - Log visualization
|
|
|
|
|
- [[Prometheus]] - Metrics counterpart
|
