Библиотека трассировки Azure Core для JavaScript

Это основная библиотека трассировки, которая предоставляет низкоуровневые интерфейсы и вспомогательные методы для трассировки в библиотеках JavaScript Azure SDK, которые работают в браузере и Node.js.

Начало работы

Установка

Этот пакет в основном используется в клиентских библиотеках Azure и не предназначен для использования непосредственно потребителями пакетов SDK Azure.

Основные понятия

• TracingClient является основным интерфейсом, обеспечивающим функциональность трассировки клиентских библиотек. Клиентские библиотеки должны знать только экземпляр и взаимодействовать с ним TracingClient .
  • Реализация TracingClient может быть создана с помощью createTracingClient функции factory.
• Instrumenter предоставляет абстракцию над инструментарием и выступает в качестве точки взаимодействия для использования сторонних библиотек, таких как OpenTelemetry. По умолчанию используется no-op Instrumenter . Клиенты, которые хотят включить OpenTelemetry трассировку на основе данных, могут сделать это, установив и зарегистрировав пакет @azure/opentelemetry-instrumentation-azure-sdk .
• TracingContext Это неизменяемый контейнер данных, используемый для передачи информации, специфичной для операции (например, родительской информации о диапазоне).
• TracingSpan — это абстракция объекта Span , которая может быть использована для записи событий, атрибутов и исключений.

Примеры

Примеры можно найти в samples папке.

Дальнейшие действия

Вы можете создать и запустить тесты локально, выполнив npm run test. Изучите папку, чтобы ознакомиться с test расширенным использованием и поведением открытых классов.

Устранение неполадок

Если у вас возникнут проблемы при использовании этой библиотеки, пожалуйста, не стесняйтесь сообщать о проблеме.

Способствует

Если вы хотите внести свой вклад в эту библиотеку, ознакомьтесь с руководством по вкладу, чтобы узнать больше о том, как создавать и тестировать код.