Observabilitas & Pemecahan Masalah

Observabilitas TokenLab yang baik dimulai dengan pengenal publik. Log Anda harus membantu Anda menjawab "apa yang diminta pengguna, tugas publik apa yang dibuat TokenLab, dan bagaimana penagihannya?" tanpa mengekspos detail sensitif penyedia atau data pengguna yang sensitif.

Dari permintaan ke investigasi dan dukunganCopy Anchor Link

1. Buka Permintaan di workspace pemilik permintaan. Cari Request ID lalu pilih barisnya.

2. Buka detail lengkap pada halaman tersendiri. Kembali ke daftar akan memulihkan filter. Tautan tidak memberikan akses ke workspace lain; gunakan akun yang berwenang.

3. Untuk status tertunda atau tidak diketahui, perbarui progres terlebih dahulu. Saat gagal atau respons terputus, mulai investigasi yang tersedia melalui Agent dalam aplikasi. Ini tidak mengirim ulang permintaan model asli. Permintaan yang berhasil biasanya tidak perlu diinvestigasi.

4. Jika masih memerlukan bantuan, pilih dukungan manusia dari permintaan atau investigasi. Periksa pratinjau dan tautan permintaan serta percakapan yang tersedia, hapus konten privat, lalu kirim secara eksplisit. Investigasi atau pratinjau saja tidak mengirim permintaan dukungan.

5. Simpan konfirmasi pengiriman dan lanjutkan percakapan yang sama pada Dukungan untuk balasan serta informasi tambahan, tanpa membuat duplikat.

Pengenal Publik yang Harus DitangkapCopy Anchor Link

Jangan simpan ID tugas penyedia, URL penyedia, pengenal penyedia, kunci Redis, atau metadata eksekusi sensitif sebagai catatan yang terlihat oleh pelanggan.

Apa yang Harus DicatatCopy Anchor Link

Catat cukup untuk mendiagnosis permintaan tanpa membocorkan rahasia:

• Endpoint, metode HTTP, model, kode status, timestamp, dan latensi.
• Pengenal publik: request_id, task_id, poll_url, dan billing_transaction_id jika ada.
• Bentuk permintaan yang disanitasi: bidang mana yang ada, bukan prompt lengkap atau konten media pribadi.
• Respons status asinkron terminal, termasuk bidang kesalahan publik.
• Jumlah percobaan ulang klien dan apakah percobaan ulang tersebut membuat tugas baru atau melanjutkan yang sudah ada.

Selalu redaksi Authorization, kunci API, token manajemen, URL yang ditandatangani, URL media pribadi, prompt lengkap, dan data pribadi pengguna kecuali Anda memiliki izin eksplisit untuk menyimpannya.

Matriks Pemecahan MasalahCopy Anchor Link

Rekonsiliasi PenggunaanCopy Anchor Link

Gunakan API Manajemen untuk rekonsiliasi sisi server:

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 dapat memfilter berdasarkan scene, model, modelVendor, startDate, dan endDate. Gunakan catatan ini alih-alih menggores halaman dasbor atau bergantung pada ID tugas penyedia hulu.

Respons streaming mungkin diselesaikan setelah aliran dikirim, jadi header penagihan bisa tidak ada bahkan ketika penggunaan dicatat kemudian. Tugas media asinkron mungkin diselesaikan setelah pemantauan terminal.

Template Paket DukunganCopy Anchor Link

Saat menghubungi dukungan, sertakan:

• request_id.
• task_id dan poll_url untuk pekerjaan asinkron.
• billing_transaction_id jika ada.
• Endpoint, metode, model, timestamp, dan kode status.
• Bentuk permintaan yang disanitasi dan badan kesalahan publik.
• Hasil yang Anda harapkan dan apa yang sebenarnya dilihat pengguna.

Jangan sertakan kunci API, token manajemen, media pribadi, prompt lengkap, URL penyedia, ID saluran, atau pengenal diagnostik pribadi kecuali dukungan TokenLab secara eksplisit meminta contoh yang telah disunting.

Pemeriksaan OperasionalCopy Anchor Link

• Beri peringatan pada respons 401, 402, 429, dan 5xx yang berulang secara terpisah; biasanya mereka memiliki pemilik yang berbeda.
• Lacak pekerjaan asinkron yang tetap non-terminal lebih lama dari SLA produk Anda.
• Lacak upaya pembuatan duplikat untuk ID pekerjaan pengguna yang sama.
• Sampel pekerjaan yang telah selesai dan verifikasi aset yang terlihat oleh pengguna, catatan penggunaan, dan catatan tugas yang disimpan setuju.

Referensi APICopy Anchor Link