Azure Core-Ablaufverfolgungsbibliothek für JavaScript

Dies ist die grundlegende Ablaufverfolgungsbibliothek, die Schnittstellen auf niedriger Ebene und Hilfsmethoden für die Ablaufverfolgung in Azure SDK-JavaScript-Bibliotheken bereitstellt, die im Browser und in Node.js funktionieren.

Erste Schritte

Installation

Dieses Paket wird hauptsächlich in Azure-Clientbibliotheken verwendet und soll nicht direkt von Consumern von Azure SDKs verwendet werden.

Wichtige Konzepte

• TracingClient ist die primäre Schnittstelle, die Ablaufverfolgungsfunktionen für Clientbibliotheken bereitstellt. Clientbibliotheken sollten nur eine TracingClient instance kennen und mit ihnen interagieren.
  • Eine TracingClient Implementierung kann mithilfe der createTracingClient Factory-Funktion erstellt werden.
• Instrumenter stellt eine Abstraktion über eine Instrumentierung bereit und fungiert als Interoppunkt für die Verwendung von Drittanbieterbibliotheken wie OpenTelemetry. Standardmäßig wird ein No-Op Instrumenter verwendet. Kunden, die die basierte Ablaufverfolgung aktivieren OpenTelemetry möchten, installieren und registrieren das Paket @azure/opentelemetry-instrumentation-azure-sdk .
• TracingContext ist ein unveränderlicher Datencontainer, der verwendet wird, um vorgangsspezifische Informationen (z. B. Span Parenting-Informationen) zu übergeben.
• TracingSpan ist eine Abstraktion von, Span die zum Aufzeichnen von Ereignissen, Attributen und Ausnahmen verwendet werden kann.

Beispiele

Beispiele finden Sie im Ordner samples.

Nächste Schritte

Sie können die Tests lokal entwickeln und ausführen, indem Sie rushx test ausführen. Erkunden Sie den Ordner test, um die erweiterte Nutzung und das Verhalten der öffentlichen Klassen kennenzulernen.

Problembehandlung

Wenn bei Nutzung dieser Bibliothek Probleme auftreten, können Sie uns gerne ein Problem melden.

Mitwirken

Wenn Sie an dieser Bibliothek mitwirken möchten, lesen Sie die Anleitung für Mitwirkende, um mehr darüber zu erfahren, wie Sie den Code erstellen und testen können.