Anfrageprotokolle auflisten

Hinweis

Die Admin-API verlangt keinen Token. Die Admin-API wird üblicherweise auf der Netzebene geschützt.

Senden Sie die Anfrage als GET an den Pfad /admin/v1/logs.

Beschreibung

Der Endpunkt liefert die Protokolleinträge in umgekehrt zeitlicher Reihenfolge, den jüngsten zuerst. Jeder Filter ist wahlfrei und lässt sich mit den übrigen verbinden.

Anfrage

Die folgenden Parameter sind verfügbar:

Parameter	Ort	Typ	Erforderlich	Beschreibung
tenant_id	Abfrage	string	nein	Schränkt die Liste auf die UUID eines Mandanten ein.
gateway_id	Abfrage	string	nein	Schränkt die Liste auf die UUID eines Gateways ein.
provider	Abfrage	string	nein	Schränkt die Liste auf den Namen eines Anbieters ein, etwa openai oder anthropic.
model	Abfrage	string	nein	Schränkt die Liste auf den Namen eines Modells ein.
status	Abfrage	integer	nein	Schränkt die Liste auf einen HTTP-Statuscode ein, etwa 200, 400 oder 429.
blocked	Abfrage	string	nein	Bei true liefert der Endpunkt ausschließlich blockierte Anfragen, bei false ausschließlich nicht blockierte.
since	Abfrage	string	nein	Liefert die Einträge ab diesem Zeitpunkt. Zulässig sind ein Zeitstempel nach ISO 8601 und ein Unix-Zeitstempel in Millisekunden.
guardrail_outcome	Abfrage	string	nein	Schränkt die Liste auf ein Ergebnis der Guardrails ein.
limit	Abfrage	integer	nein	Höchstzahl der gelieferten Einträge.
offset	Abfrage	integer	nein	Überspringt so viele Einträge für die Seitenschaltung.

Beispiel

Beispiel für den Rumpf der Antwort:

{
  "logs": [
    {
      "id": "log_abc789",
      "ts": 1742547632000,
      "tenant": "myapp",
      "tenant_id": "ten_abc123"
    }
  ]
}

Antworten

Der Endpunkt beantwortet die Anfrage mit den folgenden Statuscodes:

Statuscode	Beschreibung
200	Liste der Protokolleinträge.