Aracılığıyla paylaş

JavaScript için Azure Core AMQP istemci kitaplığı - sürüm 4.4.1

@azure/core-amqp paketi, Azure Service Bus ve Azure Event Hubs gibi AMQP protokol kullanan Azure JavaScript kitaplıkları için ortak işlevler sağlar.

Başlarken

Kurma

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

npm install @azure/core-amqp

Şu anda desteklenen ortamlar

Daha fazla bilgi için bkz. destek ilkesi.

Temel kavramlar

Azure Core AMQP kitaplığının temel özelliklerinden bazıları şunlardır:

  • Talep Tabanlı Yetkilendirme
  • AMQP üzerinden istek gönderme ve yanıt alma için Request-Response bağlantısı
  • AMQP hata kodlarının yanı sıra Azure Service Bus ve Azure Event Hubs'a özgü hataların çevirisi.
  • Yeniden denenebilir bir hatayla karşılaşılırsa belirli bir işlemi yeniden denemek için RetryPolicy.

Sonraki adımlar

npm run 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

Core-amqp kitaplığı, bağlantıları yönetmek ve AMQP protokolü üzerinden olay gönderip almak için rhea-promise kitaplığına bağlıdır.

Günlük tutmak

AZURE_LOG_LEVELgünlüğe kaydetmeyi etkinleştirmek için stderr ortam değişkenini aşağıdaki değerlerden birine ayarlayabilirsiniz:

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

Ayrıca @azure/günlükçü paketini içeri aktararak ve günlük düzeyi değerlerinden biriyle setLogLevel işlevini çağırarak günlük düzeyini program aracılığıyla ayarlayabilirsiniz. Örneğin, günlük düzeyini infoolarak ayarladığınızda, düzeyler warning ve error için yazılan günlükler de yayılır. Bu SDK, hangi düzeyde oturum açıldığı belirlenirken TypeScript için Azure SDK yönergelerini izler.

Günlük düzeyini program aracılığıyla veya AZURE_LOG_LEVEL ortam değişkeni aracılığıyla ayarlarken, 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.

Bu kitaplığı kullanırken günlükleri almak için alternatif olarak DEBUG ortam değişkenini ayarlayabilirsiniz. Bu, rhea-promise ve rhea bağımlılıklardan günlükleri de yaymak istiyorsanız yararlı olabilir.

Not: AZURE_LOG_LEVEL ayarlanırsa DEBUG'a göre önceliklidir. AZURE_LOG_LEVEL belirtirken veya setLogLevel'i çağırırken DEBUG aracılığıyla azure kitaplık belirtmeyin.

  • Core-amqp kitaplığından yalnızca bilgi düzeyi hata ayıklama günlüklerini alma.
export DEBUG=azure:core-amqp:info
  • Core-amqp ve protokol düzeyi kitaplığından hata ayıklama günlükleri alınıyor.
export DEBUG=azure:core-amqp:*,rhea*
  • ham olay verilerini (büyük miktarda konsol/disk alanı tüketen) görüntülemekle ilgilenmiyorsanız, DEBUG ortam değişkenini aşağıdaki gibi ayarlayabilirsiniz:
export DEBUG=azure:core-amqp:*,rhea*,-rhea:raw,-rhea:message
  • yalnızca hataları ve SDK uyarıları ile ilgileniyorsanız, ortam değişkenini aşağıdaki gibi ayarlayabilirsiniz:
export DEBUG=azure:core-amqp:(error|warning),rhea-promise:error,rhea:events,rhea:frames,rhea:io,rhea:flow

Dosyaya günlük kaydı yapma

  • yukarıda gösterildiği gibi DEBUG ortam değişkenini ayarlayın ve test betiğinizi aşağıdaki gibi çalıştırın:
    • Test betiğinizden günlük deyimleri out.log'e, sdk'dan günlük deyimi ise debug.log'e gider. 
      node your-test-script.js > out.log 2>debug.log
    • Test betiğinizden ve sdk'dan alınan günlük deyimleri, stderr'ı stdout'a (&1) yeniden yönlendirerek out.log aynı dosyaya gider ve ardından stdout dosyasını bir dosyaya yönlendirir: 
      node your-test-script.js >out.log 2>&1
    • Test betiğinizden ve sdk'dan günlük deyimleri out.logaynı dosyaya gider. 
      node your-test-script.js &> out.log

Katkıda

Bu proje katkıları ve önerileri memnuniyetle karşılar. Çoğu katkı, Katkıda Bulunan Lisans Sözleşmesi'ni (CLA) kabul ederek bize katkınızı kullanma hakları verme hakkına sahip olduğunuzu bildirmenizi gerektirir. Ayrıntılar için adresini ziyaret edin https://cla.microsoft.com.

Çekme isteği gönderdiğinizde, CLA botu otomatik olarak CLA sağlamanız gerekip gerekmediğini belirler ve çekme isteğini uygun şekilde süsler (örneğin, etiket, açıklama). Bot tarafından sağlanan yönergeleri izlemeniz yeterlidir. Cla'mızı kullanarak bunu tüm depolarda yalnızca bir kez yapmanız gerekir.

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.

Bu proje, Microsoft Açık Kaynak Kullanım Kurallarıbenimsemiştir. Daha fazla bilgi için bkz. Davranış Kuralları SSS veya ek sorularınız veya yorumlarınızla opencode@microsoft.com iletişime geçin.

  • Last updated on