This commit is contained in:
1 parent
23b1cb2966
commit
e9532e8878
30 files changed
+1835
-542
No files matched your search
@@ -1,40 +1,70 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""
|
||||
scripts/health_check_mindnet.py
|
||||
FILE: scripts/health_check_mindnet.py
|
||||
VERSION: 2.1.0 (2025-12-15)
|
||||
STATUS: Active
|
||||
COMPATIBILITY: v2.9.1 (Post-WP14/WP-15b)
|
||||
|
||||
Health-Check für den mindnet-Retriever-/Query-Endpoint.
|
||||
Zweck:
|
||||
-------
|
||||
Health-Check für den mindnet /query-Retriever-Endpoint.
|
||||
Prüft Verfügbarkeit, Antwortzeit und Ergebnisqualität.
|
||||
|
||||
Funktion:
|
||||
- Führt POST-Requests auf /query in verschiedenen Modi aus (standard: semantic + hybrid).
|
||||
- Prüft Status-Code, JSON-Struktur und Anzahl der Treffer.
|
||||
- Kennzeichnet Probleme als:
|
||||
- status="ok"
|
||||
- status="warning" (z.B. Timeout)
|
||||
- status="error" (harte Fehler wie HTTP-Fehler, JSON-Fehler etc.)
|
||||
Funktionsweise:
|
||||
---------------
|
||||
1. Führt POST-Requests auf /query in verschiedenen Modi aus
|
||||
2. Prüft für jeden Modus:
|
||||
- HTTP-Status-Code (erwartet 200)
|
||||
- JSON-Struktur (erwartet Objekt mit results-Array)
|
||||
- Anzahl der Treffer (mindestens min-results)
|
||||
- Antwortzeit (Latency)
|
||||
3. Klassifiziert Ergebnisse:
|
||||
- ok: Alles in Ordnung
|
||||
- warning: Timeout oder unerwartetes Verhalten
|
||||
- error: HTTP-Fehler, JSON-Fehler, zu wenige Ergebnisse
|
||||
|
||||
Exit-Code:
|
||||
- Default (tolerant):
|
||||
- overall_status = "ok" (inkl. warnings) → Exit-Code 0
|
||||
- overall_status = "error" → Exit-Code 1
|
||||
- Mit --strict:
|
||||
- warnings werden wie errors behandelt → Exit-Code 1
|
||||
Ergebnis-Interpretation:
|
||||
------------------------
|
||||
- Ausgabe: Menschlich lesbare Zusammenfassung + JSON-Report
|
||||
- overall_status: ok | warning | error
|
||||
- Exit-Code 0: ok (tolerant) oder ok/warning (strict)
|
||||
- Exit-Code 1: error (tolerant) oder warning/error (strict)
|
||||
|
||||
Beispiele:
|
||||
Verwendung:
|
||||
-----------
|
||||
- Monitoring und Alerting (z.B. cronjob)
|
||||
- CI/CD-Pipelines (Validierung nach Deployment)
|
||||
- Debugging von Performance-Problemen
|
||||
- Integration in externe Monitoring-Tools (n8n, etc.)
|
||||
|
||||
python scripts/health_check_mindnet.py \
|
||||
--url http://127.0.0.1:8001/query \
|
||||
--query "embeddings" \
|
||||
--top-k 3
|
||||
Hinweise:
|
||||
---------
|
||||
- Standard: Prüft semantic und hybrid Modi
|
||||
- Tolerant: Warnings führen nicht zu Exit-Code 1
|
||||
- Strict: Warnings werden wie Errors behandelt
|
||||
- JSON-Ausgabe für maschinelle Weiterverarbeitung
|
||||
|
||||
python scripts/health_check_mindnet.py \
|
||||
--url http://127.0.0.1:8001/query \
|
||||
--query "embeddings" \
|
||||
--top-k 3 \
|
||||
--timeout 15 \
|
||||
--modes hybrid
|
||||
Aufruf:
|
||||
-------
|
||||
python3 scripts/health_check_mindnet.py --url http://127.0.0.1:8001/query
|
||||
python3 scripts/health_check_mindnet.py --query "test" --top-k 5 --modes semantic hybrid
|
||||
python3 scripts/health_check_mindnet.py --strict
|
||||
|
||||
# Strenger Modus (warnings → Exit-Code 1)
|
||||
python scripts/health_check_mindnet.py --strict
|
||||
Parameter:
|
||||
----------
|
||||
--url URL Vollständige URL des /query-Endpunkts (Default: http://127.0.0.1:8001/query)
|
||||
--query TEXT Test-Query (Default: embeddings)
|
||||
--top-k INT Anzahl der erwarteten Ergebnisse (Default: 3)
|
||||
--timeout FLOAT Timeout in Sekunden pro Request (Default: 5.0)
|
||||
--modes LIST Zu prüfende Modi (Default: semantic hybrid)
|
||||
--min-results INT Minimale Anzahl erwarteter Ergebnisse (Default: 1)
|
||||
--strict Warnings als Fehler behandeln (Exit-Code 1 bei warnings)
|
||||
|
||||
Änderungen:
|
||||
-----------
|
||||
v2.1.0 (2025-12-15): Dokumentation aktualisiert
|
||||
v1.0.0: Initial Release
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
Reference in new issue
Block a user