Sdílet prostřednictvím


Knihovna trasování Azure Core pro JavaScript

Jedná se o základní trasovací knihovnu, která poskytuje nízkoúrovňová rozhraní a pomocné metody pro trasování v knihovnách JavaScriptu 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 nemá být používán přímo spotřebiteli sad Azure SDK.

Klíčové koncepty

  • TracingClient je primární rozhraní poskytující funkce trasování pro klientské knihovny. Klientské knihovny by měly vědět pouze o instanci a pracovat s ní TracingClient .
    • Implementace může být vytvořena TracingClientcreateTracingClient pomocí funkce factory.
  • Instrumenter poskytuje abstrakci přes instrumentaci a funguje jako bod spolupráce 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ě , tak učiní instalací a registrací balíčku @azure/opentelemetry-instrumentation-azure-sdk .
  • TracingContext je neměnný datový kontejner, který slouží k předávání informací specifických pro operaci (například informace o hierarchickém uspořádání rozsahu).
  • TracingSpan je abstrakce jazyka A Span , která může být použita k zaznamenávání událostí, atributů a výjimek.

Příklady

Příklady naleznete ve složce samples .

Další kroky

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

Řešení problémů

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

Přispívající

Pokud chcete přispívat do této knihovny, přečtěte si průvodce přispívání a přečtěte si další informace o vytváření a testování kódu.