Azure Core-Ablaufverfolgungsbibliothek für JavaScript

Hierbei handelt es sich um die zentrale Ablaufverfolgungsbibliothek, die Low-Level-Schnittstellen und Hilfsmethoden für die Ablaufverfolgung in Azure SDK-JavaScript-Bibliotheken bereitstellt, die im Browser und Node.jsfunktionieren.

Erste Schritte

Installation

Dieses Paket wird in erster Linie in Azure-Clientbibliotheken verwendet und soll nicht direkt von Verbrauchern von Azure SDKs verwendet werden.

Schlüsselkonzepte

• TracingClient ist die primäre Schnittstelle, die Ablaufverfolgungsfunktionen für Clientbibliotheken bereitstellt. Clientbibliotheken sollten nur eine Instanz kennen und mit ihr TracingClient interagieren.
  • Eine TracingClient Implementierung kann über die createTracingClient Factory-Funktion erstellt werden.
• Instrumenter Bietet eine Abstraktion über eine Instrumentierung und fungiert als Interop-Punkt für die Verwendung von Bibliotheken von Drittanbietern wie OpenTelemetry. Standardmäßig wird ein no-op Instrumenter verwendet. Kunden, die die basierte Ablaufverfolgung aktivieren OpenTelemetry möchten, können dies tun, indem sie das Paket @azure/opentelemetry-instrumentation-azure-sdk installieren und registrieren.
• TracingContext ist ein unveränderlicher Datencontainer, der zum Übergeben vorgangsspezifischer Informationen (z. B. Informationen zur übergeordneten Spanne) verwendet wird.
• TracingSpan ist eine Abstraktion von a Span , die zum Aufzeichnen von Ereignissen, Attributen und Ausnahmen verwendet werden kann.

Beispiele

Beispiele finden Sie im samples Ordner.

Nächste Schritte

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

Fehlerbehebung

Wenn Sie bei der Verwendung dieser Bibliothek auf Probleme stoßen, können Sie gerne ein Problem melden.

Beitragend

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.