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.
Authentifizierung
Abschnitt betitelt „Authentifizierung“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:
curl -H "Authorization: Bearer $METRICS_TOKEN" http://localhost:8080/metricsMETRICS_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
.envein — das würde einen laufenden Scrape-Job ohne Vorwarnung abreißen lassen. SolangeMETRICS_TOKENleer ist, antwortet der Endpunkt ohne Authentifizierung, und der Host schreibt bei jedem Start eine Warnung ins Log. Zum Schließen ein Token in die.enveintragen, den Host mitdocker compose up -d hostneu starten und den Header in die Scrape-Konfiguration aufnehmen.
Ontheia-Metriken
Abschnitt betitelt „Ontheia-Metriken“| Metrik | Typ | Labels | Bedeutung |
|---|---|---|---|
mcp_runs_total | Counter | agent_id, task_id, status | Anzahl der Agenten-Runs nach Status |
mcp_run_latency_seconds | Histogram | agent_id, task_id | Dauer eines Agenten-Runs |
mcp_chain_runs_total | Counter | chain_id, chain_version_id, status | Anzahl der Chain-Runs nach Status |
mcp_chain_run_latency_seconds | Histogram | chain_id, chain_version_id | Dauer eines Chain-Runs |
mcp_memory_hits_total | Counter | agent_id, task_id | In den Kontext gelieferte Memory-Treffer |
mcp_memory_write_total | Counter | agent_id, task_id, items | Geschriebene Memory-Einträge |
mcp_memory_warning_total | Counter | code | Memory-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.
Beispiel-Scrape-Konfiguration
Abschnitt betitelt „Beispiel-Scrape-Konfiguration“scrape_configs: - job_name: ontheia authorization: type: Bearer credentials: '<METRICS_TOKEN>' static_configs: - targets: ['ontheia-host:8080']Hinweise
Abschnitt betitelt „Hinweise“- Counter beginnen bei
0und erscheinen erst, wenn der erste Run erfasst wurde — eine leere Antwort direkt nach einem Neustart ist normal. statustrennt 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.