Dela via


Azure Core-spårningsbibliotek för JavaScript

Det här är det grundläggande spårningsbiblioteket som tillhandahåller gränssnitt på låg nivå och hjälpmetoder för spårning i Azure SDK JavaScript-bibliotek som fungerar i webbläsaren och Node.js.

Komma igång

Installation

Det här paketet används främst i Azure-klientbibliotek och är inte avsett att användas direkt av konsumenter av Azure SDK:er.

Viktiga begrepp

  • TracingClient är det primära gränssnittet som tillhandahåller spårningsfunktioner till klientbibliotek. Klientbibliotek bör bara vara medvetna om och interagera med en TracingClient instans.
    • En TracingClient implementering kan skapas med hjälp av createTracingClient fabriksfunktionen.
  • Instrumenter ger en abstraktion över en instrumentation och fungerar som interop-punkt för att använda bibliotek från tredje part som OpenTelemetry. Som standard används en no-op Instrumenter . Kunder som vill aktivera OpenTelemetry baserad spårning gör det genom att installera och registrera paketet @azure/opentelemetry-instrumentation-azure-sdk .
  • TracingContext är en oföränderlig datacontainer som används för att skicka åtgärdsspecifik information (till exempel spaltningsinformation).
  • TracingSpan är en abstraktion av a Span som kan användas för att registrera händelser, attribut och undantag.

Exempel

Exempel finns i mappen samples .

Nästa steg

Du kan skapa och köra testerna lokalt genom att köra npm run test. Utforska test mappen för att se avancerad användning och beteende för de offentliga klasserna.

Felsökning

Om du stöter på problem när du använder det här biblioteket är du välkommen att skapa ett problem.

Bidragande

Om du vill bidra till det här biblioteket kan du läsa bidragsguide för att lära dig mer om hur du skapar och testar koden.