Kullanıcı Veri İşlevleri günlüklerini görüntüleme

Günlükler, Kullanıcı Verileri İşlevlerinizin nasıl yürütülmekte olduğunu anlamanıza ve işlevler beklendiği gibi davranmadığında sorunları tanılamanıza yardımcı olur. Günlükleri iki şekilde görüntüleyebilirsiniz:

  • Test sırasında - Geliştirme modunda işlevleri test ederken Test panelinde gerçek zamanlı günlükleri görüntüleme
  • Çağırmadan sonra - Çağrılan yayımlanmış işlevler için geçmiş günlükleri görüntüleme

Bu makalede, işlev yürütmeyi izlemek ve sorunları gidermek için günlüklerin nasıl görüntüleneceği ve kullanılacağı açıklanmaktadır.

Test sırasında günlükleri görüntüleme

İşlevleri test ederken, işleviniz yürütülürken günlükleri gerçek zamanlı olarak görebilirsiniz:

  • Geliştirme modunda test paneli - Yayımlanmamış veya yayımlanmış işlevleri test ederken günlükleri görüntüleme
  • Paneli Yalnızca çalıştır modunda çalıştır - Yayımlanan işlevleri çalıştırırken günlükleri görüntüleme

Her iki panel de log çıktısını anında görüntüler, bu sayede yürütme ayrıntılarını görebilir ve oluşan hataları anında ayıklayabilirsiniz. İşlevleri test etme hakkında daha fazla bilgi için bkz . Kullanıcı Verileri İşlevlerinizi test etme.

Çağrılan işlevler için geçmiş günlüklerini görüntüleme

Yayımlanan işlevleriniz çağrıldıktan sonra geçmiş yürütmeleri analiz etmek için geçmiş günlükleri görüntüleyebilirsiniz.

Geçmiş günlüklere erişmek için:

  1. Mod değiştiriciyi kullanarak Yalnızca çalıştır moduna geçin.

  2. İşlevler listesindeki işlev adının üzerine gelin.

  3. Üç nokta simgesini (...) ve ardından Geçmiş günlüğünü görüntüle'yi seçin.

    İşlevin geçmiş günlüklerini görüntülemeyi gösteren ekran görüntüsü.

Geçmiş günlükler görünümünü anlama

Geçmiş günlükler görünümü, seçili işlev için son çağrıları gösterir. En fazla 50 girdi görebilirsiniz ve günlükler 30 gün boyunca saklanır. Belirli bir çağrının ayrıntılı günlüklerini görüntülemek için Tarih (UTC) sütunundaki tarih bağlantısını seçin.

Tarihe göre sıralanmış işlevlerin tüm çağrılarını görüntülemeyi gösteren ekran görüntüsü.

Tüm geçmiş günlükler bölmesi çağrı başına aşağıdaki bilgileri içerir:

  • Tarih (UTC). İşlev çağrısının başlangıcını gösteren zaman damgası. Bu çağrının tüm günlüklerini gözden geçirmek için bağlantıyı seçin. Kullanıcı veya hizmetin günlüğe kaydettiği tüm mesajlarla birlikte çağrının ayrıntılarını görüntüler.
  • Durum. Çağırmanın başarılı mı yoksa başarısız mı olduğunu gösterir.
  • Süre(ms). milisaniye cinsinden işlev yürütme süresi.
  • Çağırma Kimliği. Bu spesifik işlev çağrısının kimliği. Çağırma Kimliği bir HTTP üst bilgisinin parçası olarak döndürülür. Herhangi bir sorun varsa, kullanıcılar çağrı hakkında daha fazla bilgi almak için bir destek isteğinde bu Çağırma Kimliğine başvurabilir.

Belirli bir çağrının ayrıntılı günlüklerini görüntüleyin

Geçmiş günlükler görünümünü açtıktan sonra (önceki bölümde açıklandığı gibi) tek tek çağrılarda detaya gidebilirsiniz. Tarih (UTC) sütununda bir zaman damgası bağlantısı seçtiğinizde, çağrının tüm günlüklerini görüntülemek için Çağırma ayrıntıları bölmesi açılır. Şunları görüntüleyebilirsiniz:

  • İşlev kodunuzda logging modülünü kullanarak eklenen tüm günlükler
  • İşlev yürütme hakkında sistem tarafından oluşturulan günlükler
  • Oluşan hatalar veya özel durumlar

Her günlük girdisi zaman damgasını, günlük iletisini ve günlük düzeyini (Bilgi, Uyarı, Hata, Kritik) içerir.

Belirli bir işlev çağrısı için ayrıntılı günlüklerin nasıl yapıldığını gösteren ekran görüntüsü.

İşlevlerinize kayıt ekleyin

Standart Python logging modülünü kullanarak işlevlerinize özel log ifadeleri ekleyebilirsiniz. Günlükler işlev davranışını izlemenize, veri işlemeyi izlemenize ve sorunları tanılamanıza yardımcı olur.

Günlük modülünü içeri aktarma

İlk olarak, işlev kodunuzdaki modülü içeri aktarın logging :

import logging

Uyarı

Doku portalında logging yeni bir Kullanıcı Verileri İşlevleri öğesi oluşturduğunuzda veya VS Code uzantısını kullandığınızda modül varsayılan olarak içeri aktarılır.

Uygun log (günlük) düzeylerini kullanın

Python, farklı durumlar için farklı günlük düzeyleri sağlar. Günlüklerinizi daha anlamlı hale getirmek için uygun düzeyi kullanın:

# INFO - Track normal function execution and key steps
logging.info('Processing started for customer ID: 12345')
logging.info('Successfully retrieved 150 records from database')

# WARNING - Log potentially problematic situations that don't prevent execution
logging.warning('API response time exceeded 2 seconds')
logging.warning('Using cached data because fresh data is unavailable')

# ERROR - Log errors that affect functionality but don't crash the function
logging.error('Failed to connect to external API: Connection timeout')
logging.error('Invalid data format in row 42')

# CRITICAL - Log severe errors that may cause function failure
logging.critical('Database connection lost')
logging.critical('Required configuration parameter missing')

Günlük kaydı için en iyi uygulamalar

Günlüklerinizi daha etkili hale getirmek için şu uygulamaları izleyin:

  • Anlamlı bilgileri günlüğe kaydetme - Kimlikler, sayılar veya sorunları tanılamaya yardımcı olan parametre değerleri gibi ilgili ayrıntıları ekleyin
  • Uygun günlük düzeylerini kullanma - Her şeyi BİlGİ veya HATA olarak günlüğe kaydetmeyin; durum için doğru düzeyi kullanma
  • Önemli noktalarda günlüğe kaydetme - İşlevlerin başına, dış çağrılardan önce ve sonra ve verileri işlerken günlükler ekleyin
  • Hassas verileri günlüğe kaydetmekten kaçının - Parolaları, belirteçleri, kişisel bilgileri veya diğer hassas verileri günlüğe kaydetmeyin
  • İletileri kısa tutun - Kolay taranabilen net, kısa günlük iletileri yazma
  • Hacme dikkat edin - Aşırı günlük kaydı performansı etkileyebilir ve günlük alınabilirlik sınırına ulaşabilir

İşlev kodu yazma hakkında daha fazla bilgi için bkz. Python programlama modeli.

Sınırlamalar ve günlük saklama

Günlüklerle çalışırken aşağıdaki sınırlamaları göz önünde bulundurun:

  • Günlük saklama - Geçmiş çağırma günlükleri varsayılan olarak 30 gün boyunca saklanır
  • Görünür girişler - Geçmiş günlükler görünümünde işlev başına en fazla 50 giriş gösterilir
  • Günlük kullanılabilirliği - Çağırma günlüklerinin görünmesi birkaç dakika sürebilir; son günlükleri görmüyorsanız sayfayı yenileyin
  • Günlük alım sınırı - günde 250 MB; sınır günlük olarak sıfırlanır
  • Örnekleme - Günlükler istatistiksel olarak doğru analiz korunarak hacmi azaltmak için örneklenebilir
  • Desteklenen günlük türleri - Bilgi, Hata, Uyarı ve İzleme

Tam hizmet sınırları bilgileri için bkz. Hizmet ayrıntıları ve sınırlamaları.

İlgili içerik

  • Last updated on