Biblioteka klienta usługi Azure Core AMQP dla języka JavaScript — wersja 4.4.1

Pakiet udostępnia typowe funkcje bibliotek języka JavaScript platformy Azure, które korzystają z protokołu AMQP, takich jak te dla usług Azure Service Bus i Azure Event Hubs.

Wprowadzenie

Instalacja

Zainstaluj tę bibliotekę przy użyciu narzędzia npm w następujący sposób:

npm install @azure/core-amqp

Obecnie obsługiwane środowiska

• wersje Node.js LTS
• Najnowsze wersje przeglądarek Safari, Chrome, Edge i Firefox.

Aby uzyskać więcej informacji, zobacz nasze zasad pomocy technicznej.

Kluczowe pojęcia

Oto niektóre z najważniejszych funkcji biblioteki azure Core AMQP:

• autoryzacji opartej na oświadczeniach
• Request-Response link do wysyłania żądania i odbierania odpowiedzi za pośrednictwem AMQP
• Tłumaczenie błędów protokołu AMQP wraz z błędami specyficznymi dla usług Azure Service Bus i Azure Event Hubs.
• RetryPolicy w celu ponawiania próby wykonania danej operacji, jeśli napotkano błąd z możliwością ponowienia próby.

Następne kroki

Testy można kompilować i uruchamiać lokalnie, wykonując npm run test. Zapoznaj się z folderem test, aby zobaczyć zaawansowane użycie i zachowanie klas publicznych.

Rozwiązywanie problemów

Biblioteka core-amqp zależy od biblioteki rhea-promise do zarządzania połączeniami oraz wysyłania i odbierania zdarzeń za pośrednictwem protokołu AMQP.

Wyrąb

Możesz ustawić zmienną środowiskową AZURE_LOG_LEVEL na jedną z następujących wartości, aby umożliwić rejestrowanie stderr:

• pełny
• Informacji
• ostrzeżenie
• błąd

Poziom dziennika można również ustawić programowo, importując pakiet @azure/rejestratora i wywołując funkcję setLogLevel przy użyciu jednej z wartości na poziomie dziennika. Na przykład po ustawieniu poziomu dziennika na infosą również emitowane dzienniki zapisywane dla poziomów warning i error. Ten zestaw SDK jest zgodny z wytycznymi zestawu Azure SDK dla języka TypeScript podczas określania poziomu do zalogowania.

Podczas ustawiania poziomu dziennika programowo lub za pośrednictwem zmiennej środowiskowej AZURE_LOG_LEVEL wszystkie dzienniki zapisywane przy użyciu poziomu dziennika równego lub mniejszego niż wybrany zostanie wyemitowany.

Alternatywnie można ustawić zmienną środowiskową DEBUG w celu pobrania dzienników podczas korzystania z tej biblioteki. Może to być przydatne, jeśli chcesz również emitować dzienniki z zależności rhea-promise i rhea.

Uwaga: AZURE_LOG_LEVEL, jeśli ustawiono, ma pierwszeństwo przed debugowaniem. Nie należy określać żadnych bibliotek azure za pomocą debugowania podczas określania również AZURE_LOG_LEVEL lub wywoływania polecenia setLogLevel.

• Pobieranie tylko dzienników debugowania na poziomie informacji z biblioteki core-amqp.

export DEBUG=azure:core-amqp:info

• Pobieranie dzienników debugowania z biblioteki core-amqp i biblioteki na poziomie protokołu.

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

• Jeśli nie chcesz wyświetlać nieprzetworzonych danych zdarzeń (które zużywa dużą ilość miejsca na dysku/konsoli), możesz ustawić zmienną środowiskową DEBUG w następujący sposób:

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

• Jeśli interesuje Cię tylko błędy i ostrzeżenia zestawu SDK, możesz ustawić zmienną środowiskową DEBUG w następujący sposób:

export DEBUG=azure:core-amqp:(error|warning),rhea-promise:error,rhea:events,rhea:frames,rhea:io,rhea:flow

Rejestrowanie w pliku

• Ustaw zmienną środowiskową DEBUG, jak pokazano powyżej, a następnie uruchom skrypt testowy w następujący sposób:
  • Instrukcje rejestrowania skryptu testowego przechodzą do out.log i instrukcji rejestrowania z zestawu SDK przejdź do debug.log.

    node your-test-script.js > out.log 2>debug.log
    

  • Instrukcje rejestrowania ze skryptu testowego i zestawu SDK przechodzą do tego samego pliku out.log przez przekierowanie narzędzia stderr do pliku stdout (&1), a następnie przekierowanie elementu stdout do pliku:

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

  • Instrukcje rejestrowania ze skryptu testowego i zestawu SDK przejdź do tego samego pliku out.log.

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

Przyczyniając się

Ten projekt z zadowoleniem przyjmuje wkład i sugestie. Większość kontrybucja wymaga zgody na umowę licencyjną współautora (CLA), deklarując, że masz prawo, a w rzeczywistości przyznaj nam prawa do korzystania z twojego wkładu. Aby uzyskać szczegółowe informacje, odwiedź stronę https://cla.microsoft.com.

Po przesłaniu żądania ściągnięcia bot CLA automatycznie określi, czy musisz podać cla i odpowiednio ozdobić żądanie ściągnięcia (np. etykieta, komentarz). Po prostu postępuj zgodnie z instrukcjami dostarczonymi przez bota. Należy to zrobić tylko raz we wszystkich repozytoriach przy użyciu naszego CLA.

Jeśli chcesz współtworzyć tę bibliotekę, przeczytaj przewodnik dotyczący współtworzenia , aby dowiedzieć się więcej na temat tworzenia i testowania kodu.

Ten projekt przyjął kodeks postępowania firmy Microsoft typu open source. Aby uzyskać więcej informacji, zobacz Kodeks postępowania — często zadawane pytania lub skontaktuj się z opencode@microsoft.com z dodatkowymi pytaniami lub komentarzami.