Pustaka klien Azure Logger untuk JavaScript - versi 1.2.0

Paket dapat @azure/logger 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 DEBUG variabel lingkungan.

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 ini @azure/logger mendukung tingkat log berikut yang ditentukan dalam urutan paling verbose hingga paling sedikit verbose:

• penyedehanaan kata
• Info
• Peringatan
• kesalahan

Saat mengatur tingkat log, baik secara terprogram atau melalui AZURE_LOG_LEVEL variabel lingkungan, 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 warning log atau error dipancarkan.

CATATAN: Saat mencatat permintaan dan respons, kami membersihkan objek ini untuk memastikan hal-hal seperti Authorization header 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-korelasi-permintaan-id",
• "x-ms-request-id",
• "client-request-id",
• "ms-cv",
• "return-client-request-id",
• "orang tua jejak",
• "Akses-Kontrol-Izinkan-Kredensial",
• "Access-Control-Allow-Headers",
• "Akses-Kontrol-Izinkan-Metode",
• "Access-Control-Allow-Origin",
• "Access-Control-Expose-Headers",
• "Akses-Kontrol-Usia Maks",
• "Header Kontrol Akses",
• "Akses-Kontrol-Permintaan-Metode",
• "Asal",
• "Terima",
• "Terima-Pengkodean",
• "Kontrol Cache",
• "Koneksi",
• "Panjang Konten",
• "Tipe Konten",
• "Tanggal",
• "ETag",
• "Kedaluwarsa",
• "Jika-cocok",
• "Jika-Dimodifikasi-Sejak",
• "Jika-Tidak Cocok",
• "Jika-Tidak Dimodifikasi-Sejak",
• "Terakhir Diubah",
• "Pragma",
• "id permintaan",
• "Coba Lagi Setelah",
• "Server",
• "Pengodean Transfer",
• "Agen Pengguna",
• "WWW-Autentikasi",

Contoh

Contoh 1 - penggunaan dasar

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

setLogLevel("info");

Contoh 2 - mengalihkan output log

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

Dengan menggunakan AzureLogger, dimungkinkan untuk mengalihkan output pengelogan dari Azure SDK dengan mengganti AzureLogger.log metode. 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.