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

  • Makale

@azure/logger paketi, 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ı
  • DEBUG ortam değişkenini 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

@azure/logger paketi, en ayrıntılıdan en az ayrıntıya kadar sırasıyla belirtilen aşağıdaki günlük düzeylerini destekler:

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

Program aracılığıyla veya AZURE_LOG_LEVEL ortam değişkeni aracılığıyla günlük düzeyi ayarlanırken, seçtiğinize eşit veya ondan küçü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üzeyinin warning olarak ayarlanması, günlük düzeyi warning veya error olan tüm günlüklerin yayılmalarına neden olur.

NOT: İstekleri ve yanıtları günlüğe kaydettiğinizde, gizli diziler içeren Authorization üst bilgileri gibi öğelerin 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-client-request-id",
  • "x-ms-return-client-request-id",
  • "x-ms-useragent",
  • "x-ms-correlation-request-id",
  • "x-ms-request-id",
  • "client-request-id",
  • "ms-cv",
  • "return-client-request-id",
  • "traceparent",
  • "Access-Control-Allow-Credentials",
  • "Access-Control-Allow-Headers",
  • "Access-Control-Allow-Methods",
  • "Access-Control-Allow-Origin",
  • "Access-Control-Expose-Headers",
  • "Access-Control-Max-Age",
  • "Access-Control-Request-Headers",
  • "Access-Control-Request-Method",
  • "Kaynak",
  • "Kabul Et",
  • "Accept-Encoding",
  • "Cache-Control",
  • "Bağlantı",
  • "İçerik Uzunluğu",
  • "İçerik Türü",
  • "Tarih",
  • "ETag",
  • "Süresi Doluyor",
  • "If-Match",
  • "If-Modified-Since",
  • "If-None-Match",
  • "If-Unmodified-Since",
  • "Son Değiştirme Tarihi",
  • "Pragma",
  • "İstek Kimliği",
  • "Yeniden Dene-Sonra",
  • "Sunucu",
  • "Aktarım Kodlaması",
  • "User-Agent",
  • "WWW-Authenticate",

Örnekler

Örnek 1 - temel kullanım

const { EventHubClient } = require('@azure/event-hubs');

const logger = require('@azure/logger');
logger.setLogLevel('info');

// operations will now emit info, warning, and error logs
const client = new EventHubClient(/* params */);
client.getPartitionIds()
  .then(ids => { /* do work */ })
  .catch(e => { /* do work */ });
});

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

const { AzureLogger, setLogLevel } = require("@azure/logger");

setLogLevel("verbose");

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

AzureLoggerkullanarak, AzureLogger.log yöntemini geçersiz kılarak Azure SDK'larından günlük çıkışını 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ütfenbir 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.

Gösterimler