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

适用于 Python 的 Azure Core 跟踪 OpenCensus 客户端库 - 版本 1.0.0b8

入门

使用 pip 安装适用于 Python 的 opencensus python：

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

现在，可以像往常一样将 opencensus for Python 与与 azure 核心跟踪兼容的任何 SDK 一起使用。 这包括 (不详尽的列表) 、azure-storage-blob、azure-keyvault-secrets、azure-eventhub 等。

关键概念

• 无需传递任何上下文，SDK 将为你获取它
• opencensus 线程插件随此包一起安装

示例

没有要传递的显式上下文，只需创建常用的 opencensus 和跟踪器，并调用任何与 azure 核心跟踪兼容的 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('mycontainer')  # Call will be traced

疑难解答

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

后续步骤

有关 OpenCensus 配置的更多文档，请参阅 OpenCensus 网站

贡献

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

提交拉取请求时，CLA 机器人将自动确定你是否需要提供 CLA，并相应地修饰 PR（例如标签、注释）。 直接按机器人提供的说明操作。 只需使用 CLA 对所有存储库执行一次这样的操作。

此项目采用了 Microsoft 开放源代码行为准则。 有关详细信息，请参阅行为准则常见问题解答，或如果有任何其他问题或意见，请与 联系。