> ## 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. # Observabilitas & Pemecahan Masalah > Catat pengenal TokenLab publik yang diperlukan untuk dukungan, rekonsiliasi penggunaan, dan debugging media asinkron. 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 routing penyedia atau data pengguna yang sensitif. ## Pengenal Publik yang Harus Ditangkap | Pengenal | Di mana muncul | Gunakan untuk | | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- | | `request_id` | Badan kesalahan, log dasbor, catatan penggunaan | Dukungan dan rekonsiliasi tingkat permintaan | | `id` / `task_id` | Respons pembuatan dan status asinkron | Memantau gambar, video, musik, dan pekerjaan 3D | | `poll_url` | Respons pembuatan asinkron | URL status yang diinginkan | | `billing_transaction_id` | Respons non-streaming saat diselesaikan, respons status tugas asinkron, catatan penggunaan, `X-Billing-Transaction-ID` | Rekonsiliasi biaya | | `X-Task-ID` | Header respons tugas asinkron | Korelasi tugas tingkat header | | ID pekerjaan/pengguna Anda sendiri | Aplikasi Anda | Menghubungkan aktivitas TokenLab kembali ke alur kerja pengguna | Jangan simpan ID tugas penyedia, URL hulu, ID saluran routing, kunci Redis, atau metadata eksekusi pribadi sebagai kebenaran yang terlihat oleh pelanggan. ## Apa yang Harus Dicatat 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 Masalah | Gejala | Periksa pertama | Halaman berguna | | ------------------------------------ | ------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | | `401` atau `403` | Kunci API, token manajemen, akses organisasi, cakupan kunci | [Autentikasi](/id/authentication) | | `402` | Saldo, batas pengeluaran kunci API, ketersediaan harga model | [Penagihan & Harga](/id/guides/billing) | | `429` | Tingkat akun, batas laju endpoint, perilaku percobaan ulang | [Batas Laju](/id/guides/rate-limits) | | `400 invalid_request_error` | Bidang tidak didukung, endpoint salah, bidang yang diperlukan hilang, atau ketidakcocokan kontrak model | [Penanganan Kesalahan](/id/guides/error-handling) | | Tugas asinkron tidak dapat ditemukan | Kunci API salah, ID tugas kadaluarsa, tugas kadaluarsa, atau ID tugas non-publik | [Pekerjaan Asinkron & Pemantauan](/id/guides/async-jobs-polling) | | Biaya tidak cocok dengan UI | Waktu penyelesaian atau membandingkan pengenal yang salah | [Penagihan & Harga](/id/guides/billing) | ## Rekonsiliasi Penggunaan Gunakan API Manajemen untuk rekonsiliasi sisi server: ```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` dapat memfilter berdasarkan `scene`, `accessChannel`, `logicalModel`, `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 Dukungan 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 routing internal kecuali dukungan TokenLab secara eksplisit meminta contoh yang telah direduksi. ## Pemeriksaan Operasional * 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 API | Topik | Referensi | | ----------------------------- | ------------------------------------------------------------------------------- | | Penanganan Kesalahan | [Penanganan Kesalahan](/id/guides/error-handling) | | Batas Laju | [Batas Laju](/id/guides/rate-limits) | | Penagihan & Harga | [Penagihan & Harga](/id/guides/billing) | | Dapatkan Penggunaan Kunci API | [Dapatkan Penggunaan Kunci API](/id/api-reference/management/get-api-key-usage) | | Dapatkan Status Tugas | [Dapatkan Status Tugas](/id/api-reference/tasks/get-task-status) |