tracing

5 Funktionen in dieser Kategorie.

tracing.list GET /api/admin/tracing/list

Traces auflisten

Hilfe

Listet aufgezeichnete OpenTelemetry-Traces mit Pagination und optionalen Filtern. Unterstuetzt Filterung nach Root-Span-Name, Mindest-Dauer, Status (OK/ERROR/UNSET), Zeitraum, Span-Name und JSONB-Attribut-Suche.

Parameter

Name	Typ	Required	Default	Beschreibung
`page`	integer	Nein	1	Seite (ab 1)
`page_size`	integer	Nein	100	Eintraege pro Seite (max 500)
`name`	string	Nein	—	Root-Span-Name-Filter (z.B. 'rag_query')
`min_duration_ms`	number	Nein	—	Mindest-Dauer in Millisekunden
`status`	string	Nein	—	Trace-Status (OK, ERROR, UNSET)
`from_date`	string	Nein	—	Startdatum (YYYY-MM-DD)
`to_date`	string	Nein	—	Enddatum (YYYY-MM-DD)

Beispiel-Prompts

Zeig mir die letzten Traces
Liste alle fehlgeschlagenen Traces
Welche Traces gibt es von heute?

raw_response: Ja

tracing.detail GET /api/admin/tracing/detail

Trace-Details mit Spans anzeigen

Hilfe

Zeigt einen einzelnen Trace mit allen Spans, Timing und Status-Informationen. Die Span-Hierarchie (Parent/Child) ist ueber parent_span_id nachvollziehbar.

Parameter

Name	Typ	Required	Default	Beschreibung
`trace_id`	string	Ja	—	Die 32-stellige Trace-ID

Beispiel-Prompts

Zeig mir die Details zum Trace abc123
Was passiert im Trace xyz?

raw_response: Ja

tracing.histogram GET /api/admin/tracing/histogram

Duration-Histogram der Traces anzeigen

Hilfe

Erstellt eine Bucket-basierte Verteilung der Trace-Dauern inkl. P50/P95/P99-Percentilen. Die gleichen Filter wie bei tracing.list sind anwendbar.

Parameter

Name	Typ	Required	Default	Beschreibung
`buckets`	integer	Nein	20	Anzahl Buckets (2-100)
`name`	string	Nein	—	Root-Span-Name-Filter
`status`	string	Nein	—	Trace-Status-Filter
`from_date`	string	Nein	—	Startdatum (YYYY-MM-DD)
`to_date`	string	Nein	—	Enddatum (YYYY-MM-DD)

Beispiel-Prompts

Zeig mir das Dauer-Histogram der Traces
Wie verteilen sich die Trace-Laufzeiten?

raw_response: Ja

tracing.span_averages GET /api/admin/tracing/span-averages

Durchschnittliche Span-Dauern anzeigen

Hilfe

Berechnet pro Span-Typ die durchschnittliche Dauer, Aufrufhaeufigkeit und Percentile. Nuetzlich um Engpaesse zu identifizieren (z.B. langsames Reranking).

Parameter

Name	Typ	Required	Default	Beschreibung
`name`	string	Nein	—	Root-Span-Name-Filter
`status`	string	Nein	—	Trace-Status-Filter
`from_date`	string	Nein	—	Startdatum (YYYY-MM-DD)
`to_date`	string	Nein	—	Enddatum (YYYY-MM-DD)

Beispiel-Prompts

Welche Spans sind am langsamsten?
Zeig mir die Span-Averages
Wo verbringen Traces die meiste Zeit?

raw_response: Ja

tracing.compare GET /api/admin/tracing/compare

Zwei Traces vergleichen

Hilfe

Vergleicht zwei Traces anhand ihrer Span-Dauern. Zeigt pro Span-Typ die Dauer in beiden Traces, die Differenz (absolut und prozentual) und die Aufrufhaeufigkeit.

Parameter

Name	Typ	Required	Default	Beschreibung
`trace_a`	string	Ja	—	Erste Trace-ID
`trace_b`	string	Ja	—	Zweite Trace-ID

Beispiel-Prompts

Vergleiche Trace abc123 mit def456
Warum ist Trace X langsamer als Trace Y?

raw_response: Ja