Observierbarkeit & Fehlersuche

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.

Von der Anfrage zur Untersuchung und zum SupportCopy Anchor Link

1. Öffnen Sie Anfragen im zuständigen Workspace. Suchen Sie die Request ID und wählen Sie die Zeile aus.

2. Öffnen Sie die vollständigen Details auf einer eigenen Seite. Die Rückkehr zur Liste stellt die Filter wieder her. Ein Link erteilt keine Zugriffsrechte auf andere Workspaces; verwenden Sie ein berechtigtes Konto.

3. Aktualisieren Sie bei ausstehenden oder unbekannten Zuständen zuerst den Fortschritt. Bei Fehlern oder unterbrochenen Antworten können Sie die angebotene Untersuchung im integrierten Agent starten. Die ursprüngliche Modellanfrage wird dabei nicht erneut gesendet. Erfolgreiche Anfragen benötigen standardmäßig keine Untersuchung.

4. Wählen Sie bei Bedarf menschlichen Support aus der Anfrage oder Untersuchung. Prüfen Sie die Vorschau mit der verknüpften Anfrage und Unterhaltung, sofern vorhanden, entfernen Sie private Inhalte und senden Sie ausdrücklich ab. Untersuchung und Vorschau allein eröffnen keine Supportanfrage.

5. Bewahren Sie die Bestätigung auf und führen Sie dieselbe Unterhaltung unter Support für Antworten und Ergänzungen fort, statt doppelte Anfragen zu senden.

Öffentliche Identifikatoren Zum ErfassenCopy Anchor Link

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

Was Zu Protokollieren IstCopy Anchor Link

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-MatrixCopy Anchor Link

NutzungskontrolleCopy Anchor Link

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

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, 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-PaketvorlageCopy Anchor Link

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üfungenCopy Anchor Link

• 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-ReferenzCopy Anchor Link