From 8769b83d429be1d6f4e14d5871dd80f323ff4490 Mon Sep 17 00:00:00 2001
From: kurogeek <kurogeek@lmvhaus.com>
Date: Thu, 22 Oct 2026 06:32:42 +0000
Subject: [PATCH] prometheus: write README

manifest.readme read an empty file, triggering a missing-readme warning.
---
 modules/clan/prometheus/README.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/modules/clan/prometheus/README.md b/modules/clan/prometheus/README.md
index e69de29b..d4f57b27 100644
--- a/modules/clan/prometheus/README.md
+++ b/modules/clan/prometheus/README.md
@@ -0,0 +1,8 @@
+# Prometheus
+
+Monitoring over the Yggdrasil network. Requires the `yggdrasil` clan service on every machine in the instance.
+
+Roles:
+
+- `server`: runs Prometheus and Alertmanager, scraping every `nodes` machine by its Yggdrasil address. Optional `matrix-alertmanager` forwards alerts to Matrix rooms; the bot token and webhook secret are generated as clan vars.
+- `nodes`: enables the `services.prometheus.exporters` listed in `exporters` (with `openFirewall`) so the server can harvest them.