Knihovna trasování Azure Core pro JavaScript

Toto je základní knihovna trasování, která poskytuje nízkoúrovňová rozhraní a pomocné metody pro trasování v javascriptových knihovnách sady Azure SDK, které fungují v prohlížeči a Node.js.

Začínáme

Instalace

Tento balíček se primárně používá v klientských knihovnách Azure a není určen k přímému použití příjemci sad Azure SDK.

Klíčové koncepty

• TracingClient je primární rozhraní poskytující funkce trasování klientským knihovnám. Klientské knihovny by měly vědět pouze o instanci a interagovat s ní TracingClient .
  • Implementaci TracingClient lze vytvořit pomocí createTracingClient funkce factory.
• Instrumenter poskytuje abstrakci přes instrumentaci a funguje jako spojovací bod pro použití knihoven třetích stran, jako je OpenTelemetry. Ve výchozím nastavení se používá no-op Instrumenter . Zákazníci, kteří chtějí povolit OpenTelemetry trasování na základě, to udělají instalací a registrací balíčku @azure/opentelemetry-instrumentation-azure-sdk .
• TracingContext je neměnný kontejner dat, který se používá k předávání informací specifických pro operaci (například informace o nadřazeném rozsahu).
• TracingSpan je abstrakce objektu Span , který lze použít k zaznamenávání událostí, atributů a výjimek.

Příklady

Příklady najdete ve samples složce.

Další kroky

Testy můžete sestavit a spustit místně spuštěním rushx testpříkazu . test Prozkoumejte složku a podívejte se na pokročilé využití a chování veřejných tříd.

Poradce při potížích

Pokud při používání této knihovny narazíte na problémy, můžete problém napište.

Přispívání

Pokud chcete přispívat do této knihovny, přečtěte si prosím průvodce přispívání , kde se dozvíte více o tom, jak sestavit a otestovat kód.