tudattr/homelab-docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add Loki/Promtail, LiteLLM, agentmemory, Raspberry Pi; drop Elastic

Browse Source 
- Replace Elastic Stack with Loki + Promtail throughout
- Add LiteLLM (LLM proxy), agentmemory, athome (personal homepage) to applications
- Add Raspberry Pi (naruto) to hardware table — Zigbee2MQTT + Mosquitto via Ansible
- Update CloudNativePG note to include LiteLLM as consumer
- Add raspberry_pi role to repo layout
This commit is contained in:
Tuan-Dat Tran
2026-06-21 21:39:40 +02:00
parent 40fa132e0d
commit 1c2eb6688b
2 changed files with 14 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
docs/observability.md
View File

@@ -1,6 +1,6 @@
# Observability
Two parallel stacks: Prometheus for metrics, Elastic for logs.
Metrics and logs both surface in Grafana, keeping dashboards and log queries in one place.
---
@@ -16,21 +16,9 @@ Alertmanager routes alerts to Ntfy via a custom webhook bridge.
---
## Logs and fleet management
## Logs
The ECK operator (Elastic Cloud on Kubernetes) manages the Elastic stack in the `elastic-system` namespace:
| Component | Purpose |
|-----------|---------|
| Elasticsearch | Log storage and search (single-node, 15 Gi heap) |
| Kibana | Log exploration and dashboards |
| Fleet Server | Manages Elastic Agent enrollment and policies |
| Elastic Agent (DaemonSet) | Ships logs and metrics from every cluster node |
| Elastic Agent (standalone) | Runs on docker-host11 and the edge VPS |
The DaemonSet tolerates the control-plane `NoSchedule` taint so server nodes are covered too.
Elastic alert rules are bridged to Ntfy via `elastic-ntfy-bridge`, a small CronJob that polls the Elasticsearch alerts API and forwards new alerts as push notifications.
Loki runs in the `loki` namespace (single-node, filesystem storage). Promtail runs as a DaemonSet and ships pod logs from every cluster node to Loki. Logs are queryable in Grafana alongside metrics.
---
@@ -38,8 +26,4 @@ Elastic alert rules are bridged to Ntfy via `elastic-ntfy-bridge`, a small CronJ
```
Prometheus Alertmanager ──► Ntfy (push notification)
▲
Elasticsearch alert rule ──► elastic-ntfy-bridge CronJob ─┘
```
Both sources land in the same Ntfy topic.