跳转到主要内容

Falcon的OpenTelemetry工具

项目描述

pypi

此库基于OpenTelemetry WSGI中间件来跟踪Falcon应用程序中的Web请求。

安装

pip install opentelemetry-instrumentation-falcon

配置

排除列表

要排除某些URL的跟踪,请设置环境变量 OTEL_PYTHON_FALCON_EXCLUDED_URLS(或作为后备的 OTEL_PYTHON_EXCLUDED_URLS)为逗号分隔的正则表达式,表示要排除的URL。

例如,

export OTEL_PYTHON_FALCON_EXCLUDED_URLS="client/.*/info,healthcheck"

将排除如 https://site/client/123/infohttps://site/xyz/healthcheck 的请求。

请求属性

要从Falcon的请求对象中提取某些属性并将它们用作span属性,请设置环境变量 OTEL_PYTHON_FALCON_TRACED_REQUEST_ATTRS 为请求属性名称的逗号分隔列表。

例如,

export OTEL_PYTHON_FALCON_TRACED_REQUEST_ATTRS='query_string,uri_template'

将提取 path_info 和 content_type 属性并添加为 span 属性。

Falcon请求对象参考: https://falcon.readthedocs.io/en/stable/api/request_and_response.html#id1

请求/响应钩子

该仪器支持指定请求和响应钩子。这些是在为请求创建Span之后和响应处理完成之前,由仪器调用的函数。钩子可以配置如下

def request_hook(span, req):
    pass

def response_hook(span, req, resp):
    pass

FalconInstrumentation().instrument(request_hook=request_hook, response_hook=response_hook)

参考文献

项目详情


发布历史 发布通知 | RSS 源

下载文件

下载适用于您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。

源代码分发

opentelemetry_instrumentation_falcon-0.48b0.tar.gz (15.4 kB 查看哈希值)

上传时间 源代码

构建分发

由以下机构支持