> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Observierbarkeit & Fehlersuche

> Protokollieren Sie die öffentlichen TokenLab-Identifikatoren, die für den Support, die Nutzungskontrolle und das asynchrone Medien-Debugging erforderlich sind.

Gute TokenLab-Observierbarkeit beginnt mit öffentlichen Identifikatoren. Ihre Protokolle sollten Ihnen helfen, die Fragen "Was hat der Benutzer angefordert, welche öffentliche Aufgabe hat TokenLab erstellt und wie wurde sie abgerechnet?" zu beantworten, ohne interne Routing-Details des Anbieters oder sensible Benutzerdaten offenzulegen.

## Öffentliche Identifikatoren Zum Erfassen

| Identifikator                | Wo er erscheint                                                                                                                     | Verwendung                                                   |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| `request_id`                 | Fehlertexte, Dashboard-Protokolle, Nutzungsaufzeichnungen                                                                           | Unterstützung und Abgleich auf Anfrageebene                  |
| `id` / `task_id`             | Asynchrone Erstellungs- und Statusantworten                                                                                         | Abfragen von Bild-, Video-, Musik- und 3D-Jobs               |
| `poll_url`                   | Antworten auf asynchrone Erstellungen                                                                                               | Bevorzugte Status-URL                                        |
| `billing_transaction_id`     | Nicht-Streaming-Antworten, wenn abgerechnet, asynchrone Aufgabenstatusantworten, Nutzungsaufzeichnungen, `X-Billing-Transaction-ID` | Kostenabgleich                                               |
| `X-Task-ID`                  | Header von asynchronen Aufgabenantworten                                                                                            | Header-Level-Aufgaben-Korrelation                            |
| Ihre eigene Job-/Benutzer-ID | Ihre Anwendung                                                                                                                      | Verknüpfung der TokenLab-Aktivität mit dem Benutzer-Workflow |

Speichern Sie keine Anbieter-Aufgaben-IDs, upstream-URLs, Routing-Kanal-IDs, Redis-Schlüssel oder private Ausführungsmetadaten als kundenorientierte Wahrheit.

## Was Zu Protokollieren Ist

Protokollieren Sie genug, um die Anfrage zu diagnostizieren, ohne Geheimnisse preiszugeben:

* Endpunkt, HTTP-Methode, Modell, Statuscode, Zeitstempel und Latenz.
* Öffentliche Identifikatoren: `request_id`, `task_id`, `poll_url` und `billing_transaction_id`, wenn vorhanden.
* Sanitärisierte Anfrageform: welche Felder vorhanden waren, nicht das vollständige Prompt oder private Medieninhalte.
* Terminal asynchrone Statusantworten, einschließlich öffentlicher Fehlerfelder.
* Client-Wiederholungsanzahl und ob die Wiederholung eine neue Aufgabe erstellt oder eine bestehende fortgesetzt hat.

Redigieren Sie immer `Authorization`, API-Schlüssel, Verwaltungstoken, signierte URLs, private Medien-URLs, vollständige Prompts und persönliche Benutzerdaten, es sei denn, Sie haben ausdrückliche Erlaubnis, diese zu behalten.

## Fehlersuche-Matrix

| Symptom                                       | Erste Überprüfung                                                                                        | Nützliche Seite                                             |
| --------------------------------------------- | -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| `401` oder `403`                              | API-Schlüssel, Verwaltungstoken, Organisationszugriff, Schlüsselbereich                                  | [Authentifizierung](/de/authentication)                     |
| `402`                                         | Guthaben, Ausgabenlimit des API-Schlüssels, Verfügbarkeit des Modellpreises                              | [Abrechnung & Preisgestaltung](/de/guides/billing)          |
| `429`                                         | Kontostufe, Endpunkt-Rate-Limit, Wiederholverhalten                                                      | [Rate Limits](/de/guides/rate-limits)                       |
| `400 invalid_request_error`                   | Nicht unterstütztes Feld, falscher Endpunkt, fehlendes erforderliches Feld oder Modellvertragsabweichung | [Fehlerbehandlung](/de/guides/error-handling)               |
| Asynchrone Aufgabe kann nicht gefunden werden | Falscher API-Schlüssel, veraltete Aufgaben-ID, abgelaufene Aufgabe oder nicht-öffentliche Aufgaben-ID    | [Asynchrone Jobs & Abfragen](/de/guides/async-jobs-polling) |
| Kosten stimmen nicht mit der UI überein       | Abrechnungszeitpunkt oder Vergleich des falschen Identifikators                                          | [Abrechnung & Preisgestaltung](/de/guides/billing)          |

## Nutzungskontrolle

Verwenden Sie die Management-API für serverseitige Abgleiche:

```bash theme={null}
curl "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=video" \
  -H "Authorization: Bearer mt-your-management-token"
```

`GET /v1/management/api-keys/{keyId}/usage` kann nach `scene`, `accessChannel`, `logicalModel`, `modelVendor`, `startDate` und `endDate` filtern. Verwenden Sie diese Aufzeichnungen anstelle von Scraping-Dashboard-Seiten oder der Abhängigkeit von upstream-Anbieter-Aufgaben-IDs.

Streaming-Antworten können nach dem Senden des Streams abgerechnet werden, sodass ein Abrechnungsheader fehlen kann, selbst wenn die Nutzung später aufgezeichnet wird. Asynchrone Medienaufgaben können nach terminalen Abfragen abgerechnet werden.

## Support-Paketvorlage

Beim Kontakt mit dem Support sollten Sie Folgendes einfügen:

* `request_id`.
* `task_id` und `poll_url` für asynchrone Arbeiten.
* `billing_transaction_id`, wenn vorhanden.
* Endpunkt, Methode, Modell, Zeitstempel und Statuscode.
* Sanitärisierte Anfrageform und öffentlicher Fehlertext.
* Ihr erwartetes Ergebnis und was der Benutzer tatsächlich gesehen hat.

Schließen Sie keine API-Schlüssel, Verwaltungstoken, private Medien, vollständige Prompts, Anbieter-URLs, Kanal-IDs oder interne Routing-Identifikatoren ein, es sei denn, der TokenLab-Support fordert ausdrücklich ein redigiertes Beispiel an.

## Betriebliche Überprüfungen

* Alarmieren Sie bei wiederholten `401`, `402`, `429` und `5xx`-Antworten separat; sie haben normalerweise unterschiedliche Verantwortliche.
* Verfolgen Sie asynchrone Jobs, die länger als Ihre Produkt-SLA nicht-terminal bleiben.
* Verfolgen Sie doppelte Erstellungsversuche für dieselbe Benutzer-Job-ID.
* Proben Sie abgeschlossene Jobs und überprüfen Sie, ob das benutzerseitig sichtbare Asset, die Nutzungsaufzeichnung und der gespeicherte Aufgabenaufzeichnung übereinstimmen.

## API-Referenz

| Thema                         | Referenz                                                                        |
| ----------------------------- | ------------------------------------------------------------------------------- |
| Fehlerbehandlung              | [Fehlerbehandlung](/de/guides/error-handling)                                   |
| Rate Limits                   | [Rate Limits](/de/guides/rate-limits)                                           |
| Abrechnung & Preisgestaltung  | [Abrechnung & Preisgestaltung](/de/guides/billing)                              |
| API-Schlüssel-Nutzung abrufen | [API-Schlüssel-Nutzung abrufen](/de/api-reference/management/get-api-key-usage) |
| Aufgabenstatus abrufen        | [Aufgabenstatus abrufen](/de/api-reference/tasks/get-task-status)               |