Klientská knihovna Azure Core AMQP pro JavaScript – verze 4.3.5

Balíček @azure/core-amqp poskytuje běžné funkce pro knihovny Azure JavaScriptu, které používají protokol AMQP jako ty 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í

• Verze LTS Node.js
• Nejnovější verze 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ří:

• ověřování na základě deklarací identity
• odkaz Request-Response pro odesílání požadavků a přijímání odpovědí prostřednictvím AMQP
• Překlad chyb kódů chyb AMQP spolu s chybami specifickými pro Službu Azure Service Bus a Azure Event Hubs.
• RetryPolicy pro opakování dané operace, pokud byla zjištěna chyba opakovatelná.

Další kroky

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

Řešení problémů

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

Protokolování

Proměnnou prostředí AZURE_LOG_LEVEL můžete nastavit na jednu z následujících hodnot, abyste umožnili protokolování stderr:

• užvaněný
• informace
• varování
• chyba

Úroveň protokolu můžete také nastavit programově tak, že naimportujete balíček @azure/logger a zavoláte funkci setLogLevel s jednou z hodnot na úrovni protokolu. Když například nastavíte úroveň protokolu na info, protokoly zapsané pro úrovně warning a error se také vygenerují. Tato sada SDK se řídí sadou Azure SDK for TypeScript pokyny při určování úrovně, ke které se má protokolovat.

Při nastavování úrovně protokolu prostřednictvím kódu programu nebo prostřednictvím proměnné prostředí AZURE_LOG_LEVEL se všechny protokoly zapsané pomocí úrovně protokolu, která je rovna nebo menší hodnotě, kterou zvolíte, budou generovány.

Případně můžete nastavit proměnnou prostředí DEBUG 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.

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

• 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 jádra amqp a knihovny na úrovni protokolu.

export DEBUG=azure:core-amqp:*,rhea*

• Pokud nechcete zobrazovat nezpracovaná data událostí (což spotřebovává velké množství místa na konzole nebo disku), můžete proměnnou prostředí DEBUG 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 prostředí DEBUG 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 DEBUG proměnnou 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 se přesměrují do stejného souboru out.log přesměrováním stderru na stdout (&1) a pak přesměrují stdout na soubor:

    node your-test-script.js >out.log 2>&1
    

  • Příkazy protokolování z testovacího skriptu a sada SDK přejdou do stejného souboru out.log.

    node your-test-script.js &> out.log
    

Přispívající

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á deklaruje, že máte právo a ve skutečnosti nám udělíte práva k používání vašeho příspěvku. Podrobnosti najdete na adrese https://cla.microsoft.com.

Když odešlete žádost o přijetí změn, robot CLA automaticky určí, jestli potřebujete poskytnout CLA, a odpovídajícím způsobem vyzdobit žádost o přijetí změn (např. popisek, komentář). Stačí postupovat podle pokynů poskytovaných robotem. Stačí to udělat jen jednou napříč všemi úložištěmi pomocí naší cla.

Pokud chcete přispívat do této knihovny, přečtěte si průvodce přispívání a přečtěte si další informace o vytváření a testování kódu.

Tento projekt přijal pravidla chování microsoftu open source . Další informace najdete v nejčastějších dotazech k kodexu chování nebo kontaktujte opencode@microsoft.com s dalšími dotazy nebo komentáři.