Freigeben über

Azure Core AMQP-Clientbibliothek für JavaScript – Version 4.3.3

  • Artikel

Das @azure/core-amqp-Paket bietet allgemeine Funktionen für Azure JavaScript-Bibliotheken, die das AMQP-Protokoll verwenden, wie die für Azure Service Bus und Azure Event Hubs.

Erste Schritte

Installation

Installieren Sie diese Bibliothek mithilfe von npm wie folgt:

npm install @azure/core-amqp

Derzeit unterstützte Umgebungen

Weitere Informationen finden Sie in unserer Supportrichtlinie.

Schlüsselkonzepte

Einige der wichtigsten Features der Azure Core AMQP-Bibliothek sind:

Nächste Schritte

Sie können die Tests lokal erstellen und ausführen, indem Sie rushx testausführen. Erkunden Sie den Ordner test, um die erweiterte Verwendung und das Verhalten der öffentlichen Klassen anzuzeigen.

Fehlerbehebung

Die Kern-amqp-Bibliothek hängt von der rhea-promise--Bibliothek zum Verwalten von Verbindungen und zum Senden und Empfangen von Ereignissen über das AMQP--Protokoll ab.

Protokollierung

Sie können die AZURE_LOG_LEVEL Umgebungsvariable auf einen der folgenden Werte festlegen, um die Protokollierung für stderrzu aktivieren:

  • wortreich
  • Info
  • Warnung
  • Fehler

Sie können die Protokollebene auch programmgesteuert festlegen, indem Sie das @azure/Logger--Paket importieren und die setLogLevel-Funktion mit einem der Werte auf Protokollebene aufrufen. Wenn Sie beispielsweise die Protokollebene auf infofestlegen, werden auch die Protokolle ausgegeben, die für Ebenen warning und error geschrieben wurden. Dieses SDK folgt den Richtlinien des Azure SDK für TypeScript , wenn sie bestimmen, bei welcher Ebene die Anmeldung erfolgt.

Wenn Sie eine Protokollebene entweder programmgesteuert oder über die AZURE_LOG_LEVEL Umgebungsvariable festlegen, werden alle Protokolle, die mit einer Protokollebene geschrieben wurden, die gleich oder kleiner als die von Ihnen ausgewählte Protokollebene ist, ausgegeben.

Alternativ können Sie die DEBUG Umgebungsvariable festlegen, um Protokolle abzurufen, wenn Sie diese Bibliothek verwenden. Dies kann hilfreich sein, wenn Sie auch Protokolle aus den Abhängigkeiten rhea-promise und rhea ausgeben möchten.

Hinweis: wenn festgelegt, hat AZURE_LOG_LEVEL Vorrang vor DEBUG. Geben Sie keine azure Bibliotheken über DEBUG an, wenn Sie auch AZURE_LOG_LEVEL oder setLogLevel aufrufen.

  • Abrufen von Debugprotokollen auf Informationsebene aus der Core-amqp-Bibliothek.
export DEBUG=azure:core-amqp:info
  • Abrufen von Debugprotokollen aus der Core-amqp- und der Protokollebenenbibliothek.
export DEBUG=azure:core-amqp:*,rhea*
  • Wenn Sie nicht daran interessiert sind, die rohen Ereignisdaten anzuzeigen (die eine große Menge konsolen-/Festplattenspeicher belegt), können Sie die DEBUG Umgebungsvariable wie folgt festlegen:
export DEBUG=azure:core-amqp:*,rhea*,-rhea:raw,-rhea:message
  • Wenn Sie nur an Fehler und SDK-Warnungeninteressiert sind, können Sie die DEBUG Umgebungsvariable wie folgt festlegen:
export DEBUG=azure:core-amqp:(error|warning),rhea-promise:error,rhea:events,rhea:frames,rhea:io,rhea:flow

Anmelden bei einer Datei

  • Legen Sie die DEBUG Umgebungsvariable wie oben dargestellt fest, und führen Sie dann das Testskript wie folgt aus:
    • Die Protokollierungsanweisungen des Testskripts wechseln zu out.log und Protokollierungsanweisung aus dem Sdk zu debug.log. 
      node your-test-script.js > out.log 2>debug.log
    • Protokollierungsanweisungen aus Ihrem Testskript und das SDK gehen zu derselben Datei out.log, indem Sie stderr zu stdout (&1) umleiten und dann stdout an eine Datei umleiten: 
      node your-test-script.js >out.log 2>&1
    • Protokollierungsanweisungen aus Ihrem Testskript und das SDK wechseln zu derselben Datei out.log. 
      node your-test-script.js &> out.log

Beitragend

Dieses Projekt begrüßt Beiträge und Vorschläge. Die meisten Beiträge erfordern, dass Sie einem Mitwirkenden-Lizenzvertrag (CLA) zustimmen, der erklärt, dass Sie das Recht haben, uns tatsächlich die Rechte zur Nutzung Ihres Beitrags zu gewähren. Ausführliche Informationen finden Sie unter https://cla.microsoft.com.

Wenn Sie eine Pullanfrage einreichen, bestimmt ein CLA-Bot automatisch, ob Sie eine CLA bereitstellen und die PR entsprechend dekorieren müssen (z. B. Bezeichnung, Kommentar). Folgen Sie einfach den Anweisungen des Bots. Sie müssen dies nur einmal über alle Reposs hinweg tun, indem Sie unsereN CLA verwenden.

Wenn Sie an dieser Bibliothek mitwirken möchten, lesen Sie bitte den mitwirkenden Leitfaden, um mehr über das Erstellen und Testen des Codes zu erfahren.

Dieses Projekt hat den Microsoft Open Source Code of Conductübernommen. Weitere Informationen finden Sie im Code of Conduct FAQ oder wenden Sie sich an opencode@microsoft.com mit weiteren Fragen oder Kommentaren.

Aufrufe