Skip to main content
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 sensible Provider-Details oder sensible Benutzerdaten offenzulegen.

​
Öffentliche Identifikatoren Zum Erfassen

Speichern Sie keine Anbieter-Aufgaben-IDs, Anbieter-URLs, Anbieter-Identifikatoren, Redis-Schlüssel oder sensiblen Ausführungsmetadaten als kundenorientierte Datensätze.

​
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

​
Nutzungskontrolle

Verwenden Sie die Management-API für serverseitige Abgleiche:
GET /v1/management/api-keys/{keyId}/usage kann nach scene, model, modelVendor, startDate und endDate filtern. Verwenden Sie diese Aufzeichnungen anstelle von Scraping-Dashboard-Seiten oder der Abhängigkeit von 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 privaten Diagnose-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