opencensus-extension-azure-functions 1.0.0

安装

pip install opencensus-extension-azure-functions

先决条件

安装azure-functions-core-tools或Azure Functions vscode-extension。

如何在Python函数中使用

1. 使用func init --python或VSCode扩展刀片-> Azure -> Functions -> 创建新项目...来创建Python函数应用程序。

2. 使用func new -a anonymous -t HttpTrigger -n HttpTrigger在您的函数应用程序中创建匿名Http触发器。如果您使用VSCode，项目创建向导将引导您完成相同的过程。

3. 将opencensus-extension-azure-functions和requests包含到您的requirements.txt中。

4. 在local.settings.json中，添加新的设置"PYTHON_ENABLE_WORKER_DEPENDENCIES": "1"和"APPLICATIONINSIGHTS_CONNECTION_STRING": "InstrumentationKey=aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"。您可以从Azure Application Insights资源获取您的应用程序洞察仪器密钥。

5. 为您的本地开发设置虚拟环境

   1. 在Windows中使用py -3.7 -m venv .venv或在类Unix系统中使用python3.7 -m venv .venv创建虚拟环境。

   2. 使用 Windows PowerShell 中的 .venv\Scripts\Activate.ps1 或 Unix-like 系统中的 source .venv/bin/activate 激活虚拟环境。

6. 在 <项目根目录>/HttpTrigger/__init__.py 中更改 HTTP 触发文件以启用 OpenCensus 追踪集成。

import json
import logging

from opencensus.extension.azure.functions import OpenCensusExtension
logger = logging.getLogger('HttpTriggerLogger')

OpenCensusExtension.configure()

def main(req, context):
    logger.info('Executing HttpTrigger with OpenCensus extension')

    # You must use context.tracer to create spans
    with context.tracer.span("parent"):
        logger.info('Message from HttpTrigger')

    return json.dumps({
        'method': req.method,
        'ctx_func_name': context.function_name,
        'ctx_func_dir': context.function_directory,
        'ctx_invocation_id': context.invocation_id,
        'ctx_trace_context_Traceparent': context.trace_context.Traceparent,
        'ctx_trace_context_Tracestate': context.trace_context.Tracestate,
    })

7. 通过在 Core Tools 中使用 func host start --verbose 或在 VSCode 中按 F5 来在本地开发环境中运行它。

8. 现在您应该能够在 Application Insight -> Investigate -> Application Map 中检查跟踪信息。

要在其他场景中使用 Opencensus Python 扩展，请访问 我们的示例文件夹

参考资料

• OpenCensus 项目

• OpenCensus Python SDK

• Python 工作线程扩展接口

• 编写您的第一个工作线程扩展