> ## 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. # Gözlemlenebilirlik & Hata Ayıklama > Destek, kullanım uzlaştırması ve asenkron medya hata ayıklama için gereken kamuya açık TokenLab tanımlayıcılarını kaydedin. İyi bir TokenLab gözlemlenebilirliği, kamuya açık tanımlayıcılarla başlar. Loglarınız, "kullanıcı ne talep etti, TokenLab hangi kamuya açık görevi oluşturdu ve nasıl faturalandırıldı?" sorularını yanıtlamanıza yardımcı olmalı; sağlayıcı yönlendirme iç detaylarını veya hassas kullanıcı verilerini ifşa etmeden. ## Yakalanması Gereken Kamuya Açık Tanımlayıcılar | Tanımlayıcı | Nerede Görünür | Kullanım Amacı | | ----------------------------- | ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- | | `request_id` | Hata gövdesi, gösterge paneli logları, kullanım kayıtları | Talep düzeyinde destek ve uzlaştırma | | `id` / `task_id` | Asenkron oluşturma ve durum yanıtları | Görüntü, video, müzik ve 3D işlerini anketleme | | `poll_url` | Asenkron oluşturma yanıtları | Tercih edilen durum URL'si | | `billing_transaction_id` | Yerleştiğinde akış dışı yanıtlar, asenkron görev durum yanıtları, kullanım kayıtları, `X-Billing-Transaction-ID` | Maliyet uzlaştırması | | `X-Task-ID` | Asenkron görev yanıt başlıkları | Başlık düzeyinde görev korelasyonu | | Kendi işiniz/kullanıcı ID'niz | Uygulamanız | TokenLab etkinliğini kullanıcı iş akışına bağlama | Sağlayıcı görev ID'lerini, yukarı akış URL'lerini, yönlendirme kanal ID'lerini, Redis anahtarlarını veya özel yürütme meta verilerini müşteriyle yüzleşen gerçek olarak saklamayın. ## Ne Kaydedilmeli İsteği teşhis etmek için yeterince log kaydedin, sırları sızdırmadan: * Uç nokta, HTTP yöntemi, model, durum kodu, zaman damgası ve gecikme. * Kamuya açık tanımlayıcılar: `request_id`, `task_id`, `poll_url` ve `billing_transaction_id` mevcutsa. * Sanitize edilmiş istek şekli: hangi alanların mevcut olduğu, tam istem veya özel medya içeriği değil. * Terminal asenkron durum yanıtları, kamuya açık hata alanları dahil. * İstemci tekrar sayısı ve tekrarın yeni bir görev oluşturup oluşturmadığı veya mevcut birini devam ettirip ettirmediği. Her zaman `Authorization`, API anahtarları, yönetim tokenları, imzalı URL'ler, özel medya URL'leri, tam istemler ve kullanıcı kişisel verilerini saklamaktan kaçının, aksi takdirde bunları saklamak için açık izin almadığınız sürece. ## Hata Ayıklama Matrisi | Belirti | İlk Kontrol | Yararlı Sayfa | | --------------------------- | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------- | | `401` veya `403` | API anahtarı, yönetim tokenı, organizasyon erişimi, anahtar kapsamı | [Kimlik Doğrulama](/tr/authentication) | | `402` | Bakiye, API anahtarı harcama limiti, model fiyatı durumu | [Faturalama & Fiyatlandırma](/tr/guides/billing) | | `429` | Hesap katmanı, uç nokta hız limiti, tekrar davranışı | [Hız Limitleri](/tr/guides/rate-limits) | | `400 invalid_request_error` | Desteklenmeyen alan, yanlış uç nokta, gerekli alanın eksikliği veya model sözleşmesi uyuşmazlığı | [Hata Yönetimi](/tr/guides/error-handling) | | Asenkron görev bulunamıyor | Yanlış API anahtarı, eski görev ID'si, süresi dolmuş görev veya kamuya açık olmayan görev ID'si | [Asenkron İşler & Anketleme](/tr/guides/async-jobs-polling) | | Maliyet UI ile eşleşmiyor | Yerleşim zamanlaması veya yanlış tanımlayıcıyı karşılaştırma | [Faturalama & Fiyatlandırma](/tr/guides/billing) | ## Kullanım Uzlaştırması Sunucu tarafı uzlaştırması için Yönetim API'sini kullanın: ```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` `scene`, `accessChannel`, `logicalModel`, `modelVendor`, `startDate` ve `endDate` ile filtreleme yapabilir. Bu kayıtları gösterge paneli sayfalarını kazımak veya yukarı akış sağlayıcı görev ID'lerine güvenmek yerine kullanın. Akış yanıtları, akış gönderildikten sonra yerleşebilir, bu nedenle kullanım daha sonra kaydedilse bile bir faturalama başlığı mevcut olmayabilir. Asenkron medya görevleri, terminal anketlemesinden sonra yerleşebilir. ## Destek Paketi Şablonu Destekle iletişime geçerken şunları dahil edin: * `request_id`. * Asenkron işler için `task_id` ve `poll_url`. * Mevcutsa `billing_transaction_id`. * Uç nokta, yöntem, model, zaman damgası ve durum kodu. * Sanitize edilmiş istek şekli ve kamuya açık hata gövdesi. * Beklenen sonucunuzu ve kullanıcının gerçekten gördüğünü. API anahtarları, yönetim tokenları, özel medya, tam istemler, sağlayıcı URL'leri, kanal ID'leri veya dahili yönlendirme tanımlayıcılarını dahil etmeyin, TokenLab desteği açıkça redakte edilmiş bir örnek istemedikçe. ## Operasyonel Kontroller * Tekrar eden `401`, `402`, `429` ve `5xx` yanıtları için ayrı olarak uyarı verin; genellikle farklı sahipleri vardır. * Ürün SLA'nızdan daha uzun süre terminal olmayan asenkron işleri takip edin. * Aynı kullanıcı iş ID'si için tekrar eden oluşturma girişimlerini takip edin. * Tamamlanan işleri örnekleyin ve kullanıcıya görünür varlık, kullanım kaydı ve saklanan görev kaydının uyumlu olduğunu doğrulayın. ## API Referansı | Konu | Referans | | --------------------------- | ----------------------------------------------------------------------------- | | Hata Yönetimi | [Hata Yönetimi](/tr/guides/error-handling) | | Hız Limitleri | [Hız Limitleri](/tr/guides/rate-limits) | | Faturalama & Fiyatlandırma | [Faturalama & Fiyatlandırma](/tr/guides/billing) | | API Anahtarı Kullanımını Al | [API Anahtarı Kullanımını Al](/tr/api-reference/management/get-api-key-usage) | | Görev Durumunu Al | [Görev Durumunu Al](/tr/api-reference/tasks/get-task-status) |