Python 代理配置选项

捕获数据库 SQL 查询

sql.capture.enabled

• 启用此选项将监听执行的所有 SQL 查询。

• 如果禁用此选项，将不会收集任何数据库指标。

True

混淆 SQL 参数

transaction.trace.sql.parametrize

• 启用此选项将在慢事务跟踪中参数化所有 SQL 查询。（前提是 sql.capture.enabled 设置为 true 且 transaction.trace.enabled 设置为 true）

• 禁用此选项将显示带参数的实际查询。

• 如果有使用诸如信用卡号、密码等机密参数执行的查询，建议启用此选项。

True

事务跟踪中 SQL 的堆栈跟踪阈值

transaction.trace.sql.stacktrace.threshold

• 启用此选项将在任何 SQL 查询执行时间超过该阈值时收集堆栈跟踪。

3（秒）

显示实例端口号

show.instance.port.number

• 如果启用此选项，将显示应用实例的端口号。

True

跳过跟踪的 URL 扩展名列表

transaction.skip.listening

• 指定 URL 模式的 Web 事务将被跳过跟踪

• 使用逗号（,）分隔多个条目

  示例： transaction.skip.listening=*.jpeg，将跳过跟踪以 .jpeg 结尾的事务

*.css, *.js, *.gif, *.jpg, *.jpeg, *.bmp, *.png, *.ico, *.properties, *.jsf, *.ttf, *.woff, *.woff2, *.otf, *.svg, *.webp

• 不需要跟踪的异常列表。

• 提供一组字母数字关键字，这些关键字不应在事务名称中分组。

  示例： 例如，如果配置了 v1, v2, index1, index2，事务 api/v2/web3/index2.html 和 api/v1/web3/index1.html 会被模糊为 api/v2/*/index2.html 和 api/v1/*/index1.html。

Apdex 阈值

apdex.threshold

• 应用性能指数（简称 Apdex）是衡量应用性能的指标，范围从 0 到 1。

• 有关 Apdex 的详细信息，请参见 www.apdex.org

• 如果任何事务响应时间低于 apdex.threshold，事务标记为满意（Satisfied）。

• 如果任何事务响应时间高于 apdex.threshold 的四倍，事务标记为沮丧（Frustrated）。

• 如果响应时间正好等于 apdex.threshold 或介于满意和沮丧之间，则标记为可容忍（Tolerating）。

0.5（秒）

采样因子

transaction.tracking.request.interval

• 采样因子帮助跟踪抽样事务。

• 如果设置为 5，APM Insight 只跟踪同类请求中的 1/5。

1（请求）或 10（秒）

启用事务跟踪

transaction.trace.enabled

• 启用此选项将构建慢事务的跟踪。

• 您可以通过在 APM Insight 页面选择“Traces”标签查看收集的跟踪。

True

忽略跟踪的 HTTP 错误代码列表

http.errors.ignore

• 这是不跟踪的 HTTP 错误代码列表，如 400、401 和 500。

无

是否捕获每个事务的 CPU 时间？

• 如果启用，将记录每个 HTTP 请求的 CPU 时间。

True

• 按位置将相似事务合并为单个事务，便于监控。
• 输入格式： 事务 [*a-zA-Z0-9_/.,-:] ： 位置 [0-9] : 组名 [a-zA-Z0-9_]

• 提供一组字母数字关键字，这些关键字不应在事务名称中分组。

  示例： 例如，如果配置了 v1, v2, index1, index2，事务 api/v2/web3/index2.html 和 api/v1/web3/index1.html 会被模糊为 api/v2/*/index2.html 和 api/v1/*/index1.html。

• 启用此选项将捕获所有 GET 和 POST Web 请求的参数。
• 若需跳过捕获特定参数，请使用 webtransaction.trace.input.params.ignore 键。
• 可通过在“Traces”标签中选择所需事务查看捕获的参数。

• 启用此选项后，APM Insight 代理开始跟踪后台事务。

• 除 HTTP 以外的所有事务均视为后台事务。

• 启用此选项，代理将收集慢后台事务的跟踪，前提是 bgtransaction.tracking.enabled 设置为 true。

• 只有响应时间超过指定阈值的后台事务才会收集跟踪，前提是 bgtransaction.trace.enabled 设置为 true。

• 当后台事务的总外部组件（如 MYSQL、MEMCACHED 等）调用次数达到或超过配置值时，将捕获跟踪快照。

• 如果启用，将记录每个后台事务的 CPU 时间。

• 后台事务的采样因子

• 如果值设置为 1，代理跟踪所有事务。若设置为 n，代理跟踪同类事务中的 1/n。