Zum Inhalt springen

Metriken (`/metrics`)

Der Host stellt unter GET /metrics auf dem API-Port (Standard 8080) Prometheus-Metriken bereit. Der Endpunkt liefert das übliche Text-Expositionsformat und kann direkt gescrapt werden.

Die Labels enthalten Agenten- und Task-IDs — /metrics ist damit kein öffentliches Datum. Der Zugriff ist über ein gemeinsames Bearer-Token abgesichert, denn ein Prometheus-Scraper kann keine Sitzung halten:

Terminal-Fenster
curl -H "Authorization: Bearer $METRICS_TOKEN" http://localhost:8080/metrics

METRICS_TOKEN wird in der .env gesetzt. Eine Neuinstallation erzeugt es automatisch; ein falsches oder fehlendes Token beantwortet der Host mit 401.

Bestehende Installationen bleiben offen. Ein Update trägt kein Token in Ihre .env ein — das würde einen laufenden Scrape-Job ohne Vorwarnung abreißen lassen. Solange METRICS_TOKEN leer ist, antwortet der Endpunkt ohne Authentifizierung, und der Host schreibt bei jedem Start eine Warnung ins Log. Zum Schließen ein Token in die .env eintragen, den Host mit docker compose up -d host neu starten und den Header in die Scrape-Konfiguration aufnehmen.

MetrikTypLabelsBedeutung
mcp_runs_totalCounteragent_id, task_id, statusAnzahl der Agenten-Runs nach Status
mcp_run_latency_secondsHistogramagent_id, task_idDauer eines Agenten-Runs
mcp_chain_runs_totalCounterchain_id, chain_version_id, statusAnzahl der Chain-Runs nach Status
mcp_chain_run_latency_secondsHistogramchain_id, chain_version_idDauer eines Chain-Runs
mcp_memory_hits_totalCounteragent_id, task_idIn den Kontext gelieferte Memory-Treffer
mcp_memory_write_totalCounteragent_id, task_id, itemsGeschriebene Memory-Einträge
mcp_memory_warning_totalCountercodeMemory-Warnungen nach Warncode

Beide Histogramme verwenden die Buckets 0,5, 1, 2, 5, 10, 30, 60 Sekunden.

Zusätzlich sammelt prom-client die Node.js-Standardmetriken (process_*, nodejs_*) — Event-Loop-Verzögerung, Heap-Auslastung, offene Handles.

scrape_configs:
- job_name: ontheia
authorization:
type: Bearer
credentials: '<METRICS_TOKEN>'
static_configs:
- targets: ['ontheia-host:8080']
  • Counter beginnen bei 0 und erscheinen erst, wenn der erste Run erfasst wurde — eine leere Antwort direkt nach einem Neustart ist normal.
  • status trennt erfolgreiche von fehlgeschlagenen Runs; die Fehlerrate ist damit der naheliegendste erste Alarm: rate(mcp_runs_total{status!="success"}[5m]).
  • Die Metriken liegen im Prozess. Ein Neustart setzt sie zurück — mit increase()/rate() arbeiten, nicht mit rohen Counter-Werten.