Bagikan melalui

Pustaka klien Azure Logger untuk JavaScript - versi 1.1.4

  • Artikel

Paket @azure/logger dapat digunakan untuk mengaktifkan pengelogan di Azure SDK untuk JavaScript.

Pengelogan dapat diaktifkan untuk Azure SDK dengan cara berikut:

  • Mengatur variabel lingkungan AZURE_LOG_LEVEL
  • Memanggil setLogLevel yang diimpor dari "@azure/pencatat"
  • Memanggil enable() pada pencatat tertentu
  • Menggunakan variabel lingkungan DEBUG.

Perhatikan bahwa AZURE_LOG_LEVEL, jika diatur, lebih diutamakan daripada DEBUG. Hanya gunakan DEBUG tanpa menentukan AZURE_LOG_LEVEL atau memanggil setLogLevel.

Persiapan

Instalasi

Instal pustaka ini menggunakan npm sebagai berikut

npm install @azure/logger

Konsep Utama

Paket @azure/logger mendukung tingkat log berikut yang ditentukan dalam urutan sebagian besar verbose ke verbose paling sedikit:

  • penyedehanaan kata
  • Info
  • Peringatan
  • kesalahan

Saat mengatur tingkat log, baik secara terprogram atau melalui variabel lingkungan AZURE_LOG_LEVEL, log apa pun yang ditulis menggunakan tingkat log yang sama dengan atau kurang dari yang Anda pilih akan dipancarkan.

Misalnya, mengatur tingkat log ke warning akan menyebabkan semua log yang memiliki tingkat log warning atau error dipancarkan.

NOTE: Saat mencatat permintaan dan respons, kami membersihkan objek ini untuk memastikan hal-hal seperti header Authorization yang berisi rahasia tidak dicatat.

Badan permintaan dan respons tidak pernah dicatat. Header diredaksi secara default, kecuali ada dalam daftar berikut atau secara eksplisit diizinkan oleh SDK klien:

  • "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",
  • "Asal",
  • "Terima",
  • "Accept-Encoding",
  • "Cache-Control",
  • "Koneksi",
  • "Panjang Konten",
  • "Tipe Konten",
  • "Tanggal",
  • "ETag",
  • "Kedaluwarsa",
  • "If-Match",
  • "If-Modified-Since",
  • "If-None-Match",
  • "If-Unmodified-Since",
  • "Terakhir Diubah",
  • "Pragma",
  • "Request-Id",
  • "Coba Lagi Setelah",
  • "Server",
  • "Pengodean Transfer",
  • "User-Agent",
  • "WWW-Authenticate",

Contoh

Contoh 1 - penggunaan dasar

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 */ });
});

Contoh 2 - mengalihkan output log

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);
};

Menggunakan AzureLogger, dimungkinkan untuk mengalihkan output pengelogan dari Azure SDK dengan mengambil alih metode AzureLogger.log. Ini mungkin berguna jika Anda ingin mengalihkan log ke lokasi selain stderr.

Langkah berikutnya

Anda dapat membangun dan menjalankan pengujian secara lokal dengan menjalankan rushx test. Jelajahi folder test untuk melihat penggunaan dan perilaku tingkat lanjut kelas publik.

Pemecahan masalah

Jika Anda mengalami masalah saat menggunakan pustaka ini, jangan ragu untuk mengajukan masalah.

Berkontribusi

Jika Anda ingin berkontribusi pada pustaka ini, baca panduan berkontribusi untuk mempelajari selengkapnya tentang cara membuat dan menguji kode.

Tayangan