Aracılığıyla paylaş


JavaScript için Azure Logger istemci kitaplığı - sürüm 1.2.0

Paket @azure/logger , JavaScript için Azure SDK'larında günlüğe kaydetmeyi etkinleştirmek için kullanılabilir.

Azure SDK için günlüğe kaydetme aşağıdaki yollarla etkinleştirilebilir:

  • AZURE_LOG_LEVEL ortam değişkenini ayarlama
  • "@azure/logger" öğesinden içeri aktarılan setLogLevel çağrısı
  • Belirli günlükçülerde enable() çağrısı
  • Ortam değişkenini DEBUG kullanma.

AZURE_LOG_LEVEL ayarlanırsa DEBUG'a göre öncelikli olduğunu unutmayın. yalnızca AZURE_LOG_LEVEL belirtmeden veya setLogLevel çağrısı yapmadan DEBUG kullanın.

Başlarken

Kurma

Aşağıdaki gibi npm kullanarak bu kitaplığı yükleyin

npm install @azure/logger

Önemli Kavramlar

Paket @azure/logger , en ayrıntılı olandan en az ayrıntılıya doğru sıralanan aşağıdaki günlük düzeylerini destekler:

  • Ayrıntılı
  • Bilgi
  • uyarı
  • hata

Programlı olarak veya ortam değişkeni AZURE_LOG_LEVEL aracılığıyla bir günlük düzeyi ayarlarken, seçtiğiniz günlük düzeyine eşit veya daha düşük bir günlük düzeyi kullanılarak yazılan tüm günlükler yayılır.

Örneğin, günlük düzeyini olarak warning ayarlamak, günlük düzeyine warning sahip olan veya error yayılan tüm günlüklerin yayınlanmasına neden olur.

NOT: İstekleri ve yanıtları günlüğe kaydederken, sır içeren başlıklar gibi Authorization şeylerin günlüğe kaydedilmediğinden emin olmak için bu nesneleri temizleriz.

İstek ve yanıt gövdeleri hiçbir zaman günlüğe kaydedilmez. Üst bilgiler, aşağıdaki listede yoksa veya istemci SDK'sı tarafından açıkça izin verilmediği sürece varsayılan olarak yeniden işlemden çıkarılır:

  • "x-ms-istemci-istek-kimliği",
  • "x-ms-return-client-request-id",
  • "x-ms-useragent",
  • "x-ms-korelasyon-istek-kimliği",
  • "x-ms-istek-kimliği",
  • "istemci-istek-kimliği",
  • "ms-cv",
  • "return-client-request-id",
  • "traceparent",
  • "Access-Control-Allow-Credentials",
  • "Access-Control-Allow-Headers",
  • "Erişim-Kontrol-İzin Verme Yöntemleri",
  • "Erişim-Kontrol-İzin Ver-Köken",
  • "Access-Control-Expose-Headers",
  • "Erişim-Kontrol-Maks-Yaş",
  • "Erişim-Kontrol-İstek-Başlıkları",
  • "Erişim-Kontrol-İstek-Yöntemi",
  • "Kaynak",
  • "Kabul Et",
  • "Kabul Et-Kodlama",
  • "Önbellek Kontrolü",
  • "Bağlantı",
  • "İçerik Uzunluğu",
  • "İçerik Türü",
  • "Tarih",
  • "ETag",
  • "Süresi Doluyor",
  • "Eğer-Eşleşme",
  • "Eğer-Değiştirilmiş-Çünkü",
  • "Eşleşmezse",
  • "Eğer-değiştirilmemiş-beri",
  • "Son Değiştirme Tarihi",
  • "Pragma",
  • "İstek Kimliği",
  • "Yeniden Dene-Sonra",
  • "Sunucu",
  • "Aktarım Kodlaması",
  • "Kullanıcı Aracısı",
  • "WWW-Kimlik Doğrulama",

Örnekler

Örnek 1 - temel kullanım

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

Örnek 2 - yeniden yönlendirme günlüğü çıkışı

import { setLogLevel, AzureLogger } from "@azure/logger";

setLogLevel("verbose");

// override logging to output to console.log (default location is stderr)
AzureLogger.log = (...args) => {
  console.log(...args);
};

öğesini kullanarak AzureLogger, yöntemi geçersiz kılarak Azure SDK'larından günlük çıkışını AzureLogger.log yeniden yönlendirmek mümkündür. Günlükleri stderr dışında bir konuma yeniden yönlendirmek istiyorsanız bu yararlı olabilir.

Sonraki adımlar

rushx testyürüterek testleri yerel olarak derleyebilir ve çalıştırabilirsiniz. Genel sınıfların gelişmiş kullanımını ve davranışını görmek için test klasörünü keşfedin.

Sorun giderme

Bu kitaplığı kullanırken sorunlarla karşılaşırsanız lütfen bir sorunçekinmeyin.

Katkıda

Bu kitaplığa katkıda bulunmak istiyorsanız kodu oluşturma ve test etme hakkında daha fazla bilgi edinmek için lütfen katkıda bulunma kılavuzu okuyun.