Azure Core Tracing OpenCensus 客户端库（Python版）

入门指南

使用 pip 安装 opencensus python for Python

pip install azure-core-tracing-opencensus --pre

现在您可以使用与 azure-core tracing 兼容的任何 SDKs 使用 opencensus for Python。这包括（不完整列表），azure-storage-blob、azure-keyvault-secrets、azure-eventhub 等。

关键概念

• 您不需要传递任何上下文，SDK 会为您获取它
• 此软件包安装了 opencensus 线程插件

示例

没有明确的上下文要传递，您只需创建您通常的 opencensus 和 tracer，然后调用任何与 azure-core tracing 兼容的 SDK 代码。这是一个使用 Azure Monitor 导出器的示例，但您可以使用任何导出器（Zipkin 等）。

from opencensus.ext.azure.trace_exporter import AzureExporter

from opencensus.trace.tracer import Tracer
from opencensus.trace.samplers import AlwaysOnSampler

from azure.storage.blob import BlobServiceClient

exporter = AzureExporter(
    instrumentation_key="uuid of the instrumentation key (see your Azure Monitor account)"
)

tracer = Tracer(exporter=exporter, sampler=AlwaysOnSampler())
with tracer.span(name="MyApplication") as span:
    client = BlobServiceClient.from_connection_string('connectionstring')
    client.delete_container('my_container')  # Call will be traced

故障排除

此客户端引发在 Azure Core 中定义的异常。

下一步

更多关于 OpenCensus 配置的文档可以在 OpenCensus 网站 上找到

贡献

本项目欢迎贡献和建议。大多数贡献需要您同意贡献者许可协议（CLA），声明您有权，并且确实授予我们使用您贡献的权利。有关详细信息，请访问 https://cla.microsoft.com。

当您提交拉取请求时，CLA机器人会自动判断您是否需要提供CLA，并适当地装饰PR（例如，标签、评论）。只需遵循机器人提供的说明。您只需在整个使用我们的CLA的存储库中这样做一次。

本项目已采用微软开源行为准则。更多信息请参阅行为准则常见问题解答或联系opencode@microsoft.com，如有任何其他问题或意见。

发行历史

1.0.0b9 (2023-05-09)

已修复的bug

• 修复了在将意外关键字参数传递给OpenCensusSpan时启动span会失败的问题。

其他更改

• 不再支持Python 2.7。请使用Python 3.7或更高版本。

1.0.0b8 (2021-07-01)

• 修复了在实例化span时支持kind关键字的问题。

1.0.0b7 (2021-04-08)

• 现在可以在创建span实例时添加Link和SpanKind。

1.0.0b6 (2020-05-04)

• link和link_from_headers现在可以接受属性。

1.0.0b5 (2020-01-14)

错误修正

• 修复了多线程中的上下文传递问题
• 对于未知的span类型，不会失败，但映射到PRODUCER或UNSPECIFIED

功能

• 实现新的"change_context" API

1.0.0b4 (2019-10-07)

功能

• OpenCensus对azure-core跟踪协议的实现