Bagikan melalui

Pustaka klien Azure Core AMQP untuk JavaScript - versi 4.4.1

Paket menyediakan fungsionalitas umum untuk pustaka Azure JavaScript yang menggunakan protokol AMQP seperti yang untuk Azure Service Bus dan Azure Event Hubs.

Persiapan

Instalasi

Instal pustaka ini menggunakan npm sebagai berikut:

npm install @azure/core-amqp

Lingkungan yang saat ini didukung

Lihat kebijakan dukungan kami untuk detail selengkapnya.

Konsep utama

Beberapa fitur utama pustaka Azure Core AMQP adalah:

  • Otorisasi berbasis Klaim
  • tautan Request-Response untuk mengirim permintaan dan menerima respons melalui AMQP
  • Terjemahan kesalahan kode kesalahan AMQP bersama dengan kesalahan khusus untuk Azure Service Bus dan Azure Event Hubs.
  • RetryPolicy untuk mencoba kembali operasi tertentu jika terjadi kesalahan yang dapat dicoba kembali.

Langkah berikutnya

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

Pemecahan masalah

Pustaka core-amqp bergantung pada pustaka rhea-promise untuk mengelola koneksi, dan untuk mengirim dan menerima peristiwa melalui protokol AMQP .

Penebangan

Anda dapat mengatur variabel lingkungan AZURE_LOG_LEVEL ke salah satu nilai berikut untuk mengaktifkan pengelogan ke stderr:

  • penyedehanaan kata
  • Info
  • Peringatan
  • galat

Anda juga dapat mengatur tingkat log secara terprogram dengan mengimpor paket @azure/pencatat dan memanggil fungsi dengan salah satu nilai tingkat log. Misalnya, saat Anda mengatur tingkat log ke info, log yang ditulis untuk tingkat warning dan error juga dipancarkan. SDK ini mengikuti panduan Azure SDK for TypeScript saat menentukan tingkat mana yang akan dicatat.

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.

Anda juga dapat mengatur variabel lingkungan DEBUG untuk mendapatkan log saat menggunakan pustaka ini. Ini dapat berguna jika Anda juga ingin memancarkan log dari dependensi rhea-promise dan rhea juga.

Catatan: AZURE_LOG_LEVEL, jika diatur, lebih diutamakan daripada DEBUG. Jangan tentukan pustaka azure apa pun melalui DEBUG saat juga menentukan AZURE_LOG_LEVEL atau memanggil setLogLevel.

  • Hanya mendapatkan log debug tingkat info dari pustaka core-amqp.
export DEBUG=azure:core-amqp:info
  • Mendapatkan log debug dari core-amqp dan pustaka tingkat protokol.
export DEBUG=azure:core-amqp:*,rhea*
  • Jika Anda tidak tertarik untuk melihat data peristiwa mentah (yang menggunakan sejumlah besar ruang konsol/disk) maka Anda dapat mengatur variabel lingkungan DEBUG sebagai berikut:
export DEBUG=azure:core-amqp:*,rhea*,-rhea:raw,-rhea:message
  • Jika Anda hanya tertarik pada kesalahan dan peringatan SDK, maka Anda dapat mengatur variabel lingkungan DEBUG sebagai berikut:
export DEBUG=azure:core-amqp:(error|warning),rhea-promise:error,rhea:events,rhea:frames,rhea:io,rhea:flow

Pengelogan ke file

  • Atur variabel lingkungan DEBUG seperti yang ditunjukkan di atas lalu jalankan skrip pengujian Anda sebagai berikut:
    • Pernyataan pengelogan dari skrip pengujian Anda masuk ke out.log dan pernyataan pengelogan dari sdk buka debug.log. 
      node your-test-script.js > out.log 2>debug.log
    • Pernyataan pengelogan dari skrip pengujian Anda dan sdk masuk ke file yang sama out.log dengan mengalihkan stderr ke stdout (&1), lalu alihkan stdout ke file: 
      node your-test-script.js >out.log 2>&1
    • Pernyataan pengelogan dari skrip pengujian Anda dan sdk masuk ke file yang sama out.log. 
      node your-test-script.js &> out.log

Berkontribusi

Proyek ini menyambut kontribusi dan saran. Sebagian besar kontribusi mengharuskan Anda menyetujui Perjanjian Lisensi Kontributor (CLA) yang menyatakan bahwa Anda memiliki hak untuk, dan benar-benar melakukannya, memberi kami hak untuk menggunakan kontribusi Anda. Untuk detailnya, kunjungi https://cla.microsoft.com.

Saat Anda mengirimkan permintaan pull, cla-bot akan secara otomatis menentukan apakah Anda perlu memberikan CLA dan menghias PR dengan tepat (misalnya, label, komentar). Cukup ikuti instruksi yang diberikan oleh bot. Anda hanya perlu melakukan ini sekali di semua repositori menggunakan CLA kami.

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

Proyek ini telah mengadopsi Kode Etik Sumber Terbuka Microsoft. Untuk informasi selengkapnya, lihat Tanya Jawab Umum Kode Etik atau hubungi opencode@microsoft.com dengan pertanyaan atau komentar tambahan apa pun.

  • Last updated on