fix(archive): Anleitung zeigt auf das Archiv, nie auf die Produktions-TSDB; x22-Wrapper mit --file

scripts/apache-log-archive.py

@@ -33,7 +33,12 @@ AUFRUF (auf dem Quellhost, als root)
   python3 apache-log-archive.py --node x22.idx.wf-keyhelp
   python3 apache-log-archive.py --node x22 --out /root/apache-archive
 
-Danach die .tar.gz auf den imac bringen und dort einspielen (siehe README).
+Danach die .tar.gz auf den imac bringen und dort einspielen — AUSSCHLIESSLICH
+ueber prom-archive-import.sh in die getrennte ARCHIV-Instanz (:9091).
+NIEMALS die Bloecke von Hand in die Produktions-TSDB entpacken: ein Block mit
+Zeitstempeln ausserhalb des Live-Fensters verschiebt dort die Zeitreferenz und
+laesst jeden echten Sample als "too old" verwerfen (real passiert am 14.09.2026,
+13 Nodes verloren ihre Metriken).
 """
 import argparse
 import glob
@@ -315,10 +320,21 @@ def main():
     print()
     print(f"  Uebergabe an den zentralen Server:")
     print(f"    scp {tar_path} mm@192.168.188.177:/tmp/")
-    print(f"  Dort einspielen:")
-    print(f"    tar -xzf /tmp/{os.path.basename(tar_path)} -C /data/stacks/netbird-observability/stacks/central-imac/data/prometheus/")
-    print(f"    # Bloecke nach <prometheus>/  — Prometheus liest sie beim naechsten Start")
-    print(f"    docker restart observability-prometheus")
+    print()
+    print(f"  ============================================================")
+    print(f"  EINSPIELEN — NUR in die ARCHIV-Instanz (:9091)")
+    print(f"  ============================================================")
+    print(f"    ssh mm@192.168.188.177 \\")
+    print(f"      'sudo /usr/local/bin/prom-archive-import.sh --file /tmp/{os.path.basename(tar_path)}'")
+    print()
+    print(f"  Das Import-Skript prueft die Zeitstempel VOR dem Einspielen, legt ein")
+    print(f"  Manifest an (Schutz gegen Doppel-Import) und schreibt ausschliesslich")
+    print(f"  ins Archiv-Verzeichnis.")
+    print()
+    print(f"  NIEMALS von Hand entpacken — insbesondere NICHT nach")
+    print(f"  central-imac/data/prometheus/. Genau dieser Weg hat am 14.09.2026 die")
+    print(f"  Zeitreferenz der Produktions-TSDB verschoben: 13 Nodes verloren ihre")
+    print(f"  Metriken, jeder Live-Sample galt danach als 'too old'.")
     print()
     print(f"  Hinweis: instance=\"{args.node}\", archived=\"1\" — im Dashboard von")
     print(f"  Live-Daten unterscheidbar (Filter archived!=\"1\" blendet das Archiv aus).")