Sdílet prostřednictvím

Klientská knihovna Azure Core AMQP pro JavaScript – verze 4.3.0

  • Článek

Balíček @azure/core-amqp poskytuje běžné funkce pro knihovny Azure JavaScript, které používají protokol AMQP, například pro Azure Service Bus a Azure Event Hubs.

Začínáme

Instalace

Nainstalujte tuto knihovnu pomocí npm následujícím způsobem:

npm install @azure/core-amqp

Aktuálně podporovaná prostředí

  • LtS verze Node.js
  • Nejnovější verze prohlížečů Safari, Chrome, Edge a Firefox.

Další podrobnosti najdete v našich zásadách podpory .

Klíčové koncepty

Mezi klíčové funkce knihovny Azure Core AMQP patří:

Další kroky

Testy můžete sestavit a spustit místně spuštěním rushx testpříkazu . test Prozkoumejte složku a podívejte se na pokročilé využití a chování veřejných tříd.

Poradce při potížích

Knihovna core-amqp závisí na knihovně rhea-promise pro správu připojení a pro odesílání a příjem událostí přes protokol AMQP .

protokolování

Můžete nastavit proměnnou AZURE_LOG_LEVEL prostředí na jednu z následujících hodnot a povolit protokolování do stderr:

  • verbose
  • Info
  • upozornění
  • error

Úroveň protokolu můžete také nastavit programově importem balíčku @azure/protokolovacího nástroje a voláním setLogLevel funkce s jednou z hodnot na úrovni protokolu. Pokud například nastavíte úroveň protokolu na info, protokoly, které jsou zapsány pro úrovně warning a error jsou také generovány. Tato sada SDK se při určování úrovně, na kterou se má protokolovat, dodržuje pokyny sady Azure SDK pro TypeScript.

Při nastavování úrovně protokolu prostřednictvím kódu programu nebo prostřednictvím AZURE_LOG_LEVEL proměnné prostředí se vygenerují všechny protokoly, které se zapisují pomocí úrovně protokolu, která je stejná nebo menší než vámi zvolená.

Můžete také nastavit proměnnou DEBUG prostředí pro získání protokolů při použití této knihovny. To může být užitečné, pokud chcete také generovat protokoly ze závislostí rhea-promise a rhea také.

Poznámka: AZURE_LOG_LEVEL, pokud je nastavená, má přednost před laděním DEBUG. Při zadávání AZURE_LOG_LEVEL nebo volání setLogLevel nezadávejte žádné azure knihovny prostřednictvím funkce DEBUG.

  • Získání pouze protokolů ladění na úrovni informací z knihovny core-amqp
export DEBUG=azure:core-amqp:info
  • Získání protokolů ladění z knihovny core-amqp a knihovny na úrovni protokolu
export DEBUG=azure:core-amqp:*,rhea*
  • Pokud vás nezajímá zobrazení nezpracovaných dat událostí (které spotřebovávají velké množství místa na konzole nebo disku), můžete proměnnou DEBUG prostředí nastavit následujícím způsobem:
export DEBUG=azure:core-amqp:*,rhea*,-rhea:raw,-rhea:message
  • Pokud vás zajímají jenom chyby a upozornění sady SDK, můžete proměnnou DEBUG prostředí nastavit následujícím způsobem:
export DEBUG=azure:core-amqp:(error|warning),rhea-promise:error,rhea:events,rhea:frames,rhea:io,rhea:flow

Protokolování do souboru

  • Nastavte proměnnou DEBUG prostředí, jak je znázorněno výše, a pak spusťte testovací skript následujícím způsobem:
    • Příkazy protokolování z testovacího skriptu přejděte na out.log a příkaz protokolování ze sady SDK přejděte na debug.log. 
      node your-test-script.js > out.log 2>debug.log
    • Příkazy protokolování z testovacího skriptu a sady SDK přesměrují stderr na stdout (&1) do stejného souboru out.log a pak přesměrují stdout do souboru:
      node your-test-script.js >out.log 2>&1
    • Příkazy protokolování z testovacího skriptu a sady SDK přejdou do stejného souboru out.log. 
      node your-test-script.js &> out.log

Přispívání

Tento projekt vítá příspěvky a návrhy. Většina příspěvků vyžaduje souhlas s licenční smlouvou s přispěvatelem (CLA), která stanoví, že máte právo udělit nám práva k používání vašeho příspěvku a skutečně tak činíte. Podrobnosti najdete tady: https://cla.microsoft.com

Při odesílání žádosti o přijetí změn robot CLA automaticky určí, jestli je potřeba poskytnout smlouvu CLA, a příslušným způsobem žádost o přijetí změn upraví (např. přidáním jmenovky nebo komentáře). Stačí postupovat podle pokynů robota. Pro všechna úložiště používající naši smlouvu CLA to stačí udělat jenom jednou.

Pokud chcete přispívat do této knihovny, přečtěte si prosím průvodce přispívání , kde se dozvíte více o tom, jak sestavit a otestovat kód.

Tento projekt přijal pravidla chování pro Microsoft Open Source. Další informace najdete v nejčastějších dotazech k pravidlům chování nebo se obraťte na opencode@microsoft.com případné další dotazy nebo komentáře.

Imprese