Developer Hub içindeki Request logs sekmesi, kuruluşunuzun /v1 API trafiğini gösterir: son 24 saate ait özet istatistikler (istek sayısı, hata oranı ve hız sınırına takılan istekler) ile tek tek isteklerin yer aldığı, aranabilir bir günlük sunulur.
Her kayıt neleri içerir
Günlük tablosu, her çağrının zamanını, HTTP yöntemini, yolunu, yanıt durumunu, politika kararını, gecikmesini ve istek kimliğini gösterir. Bir kaydı açtığınızda, çağrıyı yapan hizmet hesabı ve API anahtarı, kaynak IP adresi ve geçerli olan izinler dahil olmak üzere tüm ayrıntılar görüntülenir.
Politika kararı, isteğin nasıl ele alındığını belirtir:
- Allowed — istek kimlik doğrulamasından ve yetkilendirmeden geçti.
- Denied — istek reddedildi; örneğin anahtarda gerekli izin yoktu, anahtarın süresi dolmuştu veya anahtar iptal edilmişti.
- Rate limited — istek, istek bütçesini aştı ve
429 ile reddedildi. Bkz. hız sınırları.
Filtreleme ve arama
Günlüğü hizmet hesabına, API anahtarına, HTTP yöntemine, durum sınıfına (2xx–5xx), politika kararına, zaman aralığına veya yol önekine (örneğin /v1/entities) göre daraltabilirsiniz.
Bir hatayı istek kimliğiyle izleme
Her API yanıtı bir Request-Id başlığı içerir ve her hata gövdesi aynı değeri request_id alanında taşır. Bu değeri istek günlüğü aramasına yapıştırarak doğrudan ilgili kayda gidebilir ve isteğin tam olarak nasıl ele alındığını görebilirsiniz.
Bir entegrasyon hata bildirdiğinde, hata yanıtındaki request_id değerini isteyin. Bu değer, müşteri tarafında görülen bir belirtiden yaşananların yetkili kaydına ulaşmanın en hızlı yoludur; ayrıca Living Security desteği ile iletişime geçerseniz iletmeniz gereken değerdir.
Sorunları erken fark etme
- Hata oranındaki artış genellikle bir anahtarın süresinin dolduğu, iptal edildiği veya ihtiyaç duyduğu bir izni kaybettiği anlamına gelir; başarısız olan kimlik bilgisini bulmak için karara göre filtreleyin.
- Hız sınırına takılan istek sayısındaki artış, bir iş yükünün aşırı yoğun çalıştığını gösterir; yükü dengelemeye yönelik stratejiler için hız sınırlarına bakın.
- Boşta olması gereken bir hizmet hesabından trafik gelmesi, kimlik bilgilerinin olması gereken yerde olup olmadığını kontrol etmeniz için bir işarettir; inceleme sürerken hesabı devre dışı bırakın.