你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

适用于 JavaScript 的 Azure 核心跟踪库

这是核心跟踪库,它提供低级接口和帮助程序方法,用于在浏览器和 Node.js中工作的 Azure SDK JavaScript 库中进行跟踪。

开始

安装

此包主要用于 Azure 客户端库,而不是直接供 Azure SDK 使用者使用。

关键概念

  • TracingClient 是为客户端库提供跟踪功能的主要接口。 客户端库应该只知道实例 TracingClient 并与之交互。
    • TracingClient可以使用工厂函数创建createTracingClient实现。
  • Instrumenter 提供对检测的抽象,并充当使用第三方库(如 OpenTelemetry)的互作点。 默认情况下,使用 no-op Instrumenter 。 希望启用 OpenTelemetry 基于跟踪的客户将通过安装和注册 @azure/opentelemetry-instrumentation-azure-sdk 包来实现。
  • TracingContext 是一个 不可变 的数据容器,用于传递特定于作的信息(例如 span 父信息)。
  • TracingSpan 是 的 Span 抽象,可用于记录事件、属性和异常。

例子

示例可以在文件夹中找到 samples

后续步骤

您可以通过执行 npm run test在本地构建和运行测试。 浏览该 test 文件夹以查看公共类的高级用法和行为。

故障 排除

如果您在使用此库时遇到问题,请随时 提出问题

贡献

若要参与此库,请阅读 贡献指南 了解有关如何生成和测试代码的详细信息。