From 4cc5a1e2226dc4514732171c16b7478e12048201 Mon Sep 17 00:00:00 2001
From: Micha <michideheld@gmx.de>
Date: Sun, 21 Jun 2026 23:34:40 +0200
Subject: [PATCH] Document Dawarich metrics verification

---
 apps/dawarich/README.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/apps/dawarich/README.md b/apps/dawarich/README.md
index 72bd840..617c06f 100644
--- a/apps/dawarich/README.md
+++ b/apps/dawarich/README.md
@@ -79,6 +79,19 @@ Der Monitoring-Stack ist dafuer bereits vorbereitet:
 
 Nicht `dawarich_app:9394` scrapen: das ist nach aktueller Dawarich-Doku veraltet. Der Web-Service aggregiert App- und Sidekiq-Metriken unter `/metrics`. Im KalliLab scrapt Prometheus intern `http://dawarich_app:3000/metrics` ueber `backend_net` und setzt `X-Forwarded-Proto: https`, damit Dawarich mit `APPLICATION_PROTOCOL=https` keinen HTTPS-Redirect erzeugt.
 
+Verifikation aus dem Prometheus-Container:
+
+```bash
+PW="$(cat /run/secrets/dawarich_metrics_password)"
+curl -i -u "prometheus:${PW}" http://dawarich_app:3000/metrics
+```
+
+Erwartung:
+
+- `200`: Scrape ist direkt funktionsfaehig.
+- `301`/`308` nach HTTPS: `http_headers` mit `X-Forwarded-Proto: https` im Prometheus-Job beibehalten.
+- `403 Blocked host`: `dawarich_app` in `APPLICATION_HOSTS` aufnehmen.
+
 ## Grafana
 
 Der Read-only-User `dawarich_grafana_ro` wird beim ersten DB-Init durch `postgres/initdb/20-grafana-readonly.sh` angelegt.