Gözlemlenebilirlik & Hata Ayıklama

İ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ı; hassas sağlayıcı detaylarını veya hassas kullanıcı verilerini ifşa etmeden.

İstekten incelemeye ve desteğeCopy Anchor Link

1. İsteğin sahibi olan çalışma alanında İstekler sayfasını açın. Request ID ile kaydı bulup satırı seçin.

2. Tam ayrıntıları ayrı bir sayfada açın. Listeye dönünce filtreler korunur. Bağlantı başka bir çalışma alanına erişim izni vermez; yetkili bir hesap kullanın.

3. Durum beklemede veya bilinmiyorsa önce ilerlemeyi yenileyin. Hata ya da kesilen yanıt için sunulan inceleme işlemini uygulama içi Agent ile başlatabilirsiniz. Bu işlem özgün model isteğini tekrar göndermez. Başarılı isteklerin varsayılan olarak incelenmesi gerekmez.

4. Hâlâ yardıma ihtiyacınız varsa istek veya inceleme üzerinden insan desteğini seçin. Önizlemeyi ve varsa bağlı istek ile konuşmayı kontrol edin, özel içeriği çıkarıp açıkça gönderin. İnceleme veya önizleme tek başına destek talebi göndermez.

5. Gönderim onayını saklayın; yanıtlar ve ek bilgiler için Destek içindeki aynı konuşmayı sürdürün, yinelenen talepler açmayın.

Yakalanması Gereken Kamuya Açık TanımlayıcılarCopy Anchor Link

Sağlayıcı görev ID'lerini, sağlayıcı URL'lerini, sağlayıcı tanımlayıcılarını, Redis anahtarlarını veya hassas yürütme meta verilerini müşteriye görünen kayıtlar olarak saklamayın.

Ne KaydedilmeliCopy Anchor Link

İ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 MatrisiCopy Anchor Link

Kullanım UzlaştırmasıCopy Anchor Link

Sunucu tarafı uzlaştırması için Yönetim API'sini kullanın:

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, model, 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 ŞablonuCopy Anchor Link

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 özel tanılama tanımlayıcılarını dahil etmeyin, TokenLab desteği açıkça redakte edilmiş bir örnek istemedikçe.

Operasyonel KontrollerCopy Anchor Link

• 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ıCopy Anchor Link