APM Insight .NET Agent 配置选项

捕获数据库 SQL 查询

sql.capture.enabled

• 启用此选项将监听所有执行的 SQL 查询。
• 如果禁用此选项，则不会收集数据库指标。

True

混淆 SQL 参数

transaction.trace.sql.parametrize

• 启用此选项将在慢事务跟踪中参数化所有 SQL 查询。（前提是 sql.capture.enabled 和 transaction.trace.enabled 均设置为 true）
• 禁用此选项将显示实际的查询（带参数）。

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

True

事务跟踪 SQL 堆栈跟踪阈值

transaction.trace.sql.stacktrace.threshold

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

3（秒）

显示实例端口号

show.instance.port.number

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

True

日志级别

apminsight.log.level

• APM Insight agent 应记录信息的日志级别。
• 支持的级别有 SEVERE，WARNING，INFO 和 FINE。

CRITICAL

需跳过跟踪的 URL 扩展名列表

transaction.skip.listening

• 指定的 URL 模式的网络事务将被跳过跟踪。
• 使用逗号(,)分隔多个条目。
  

  示例：transaction.skip.listening=*.jpeg 将跳过以 .jpeg 结尾的事务监听。

*.css, *.js, *.gif, *.jpg, *.jpeg, *.bmp, *.png, *.ico

需跳过跟踪的异常列表

exceptions.ignore

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

无

跳过事务

transaction.skip.patterns

• 提供可跳过跟踪的正则表达式模式或事务名称。
• 多个条目应为逗号分隔值。

无

• 启用此选项将用问号（*）替换数据库操作名称中的字母数字值。

Apdex 阈值

apdex.threshold

• 应用性能指数（简称 Apdex）是应用性能的测量，范围从 0 到 1。
• 关于 Apdex 的详细信息可见于 www.apdex.org
• 如果任何事务响应时间高于 apdex.threshold 的四倍，该事务将被标记为“挫败”。
• 如果恰好等于 apdex.threshold 或介于满意和挫败阈值之间，则标记为“忍受”。

0.5（秒）

采样因子

transaction.tracking.request.interval

• 采样因子帮助跟踪采样事务。
• 如果设置为 5，APMInsight 仅跟踪相同类型的每5个请求中的1个。

5（请求）或 10（请求）*

启用事务跟踪

transaction.trace.enabled

• 启用此选项将构建慢事务的跟踪。
• 您可以通过在 APM Insight 页面选择跟踪标签查看收集的跟踪。

True

事务跟踪阈值

transaction.trace.threshold

• 任何响应时间超过指定阈值的事务跟踪将在 transaction.trace.enabled 设置为 true 的条件下被收集。
• 跟踪可用于分析和排查事务运行情况。

2（秒）或 5（秒）*

外部调用超过阈值时捕获跟踪

component.trace.threshold

• 对所有 HTTP 请求，当外部组件调用（如 MYSQL、MEMCACHED 等）总数等于或高于配置数量时，将采集跟踪快照。

30（计数）

捕获 HTTP 参数？

webtransaction.trace.input.params.record

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

False

需忽略的 HTTP 参数列表

webtransaction.trace.input.params.ignore

• 若要跳过捕获特定的网络请求参数（如密码、PIN 或任何机密值），请为该键指定参数名称。
• 使用逗号(,)分隔多个条目。此键的值区分大小写。
• 如果未指定值，则所有请求参数都将被记录。

password, authKey

• 启用此选项将捕获 http(s) 头中发送的参数（GET 和 POST）。

• 这些参数在 http(s) 头中（GET 和 POST）的值将被忽略跟踪。敏感和机密的键，如 Cookie、Host 等，应在此列出。

• 启用此选项将捕获在您的应用代码中定义的自定义参数。

• 启用时为每个 HTTP 请求记录 CPU 时间。

• 当任意事务 CPU 使用超过此阈值时，将收集 CPU 时间。

跟踪后台事务

bgtransaction.tracking.enabled

• 启用此选项，APM Insight agent 开始跟踪后台事务。
• 所有非 HTTP 事务均视为后台事务。

True

捕获跟踪

bgtransaction.trace.enabled

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

True

事务跟踪阈值

bgtransaction.trace.threshold

• 对响应时间超过指定阈值的后台事务收集跟踪，条件是 bgtransaction.trace.enabled 设置为 true。

2（秒）

采样因子

bgtransaction.tracking.request.interval

• 后台事务采样因子
• 如果设置为 1，agent 跟踪所有事务。如果设置为 n，agent 只跟踪相同类型的每 n 个事务中的 1 个。

5（请求）

• 启用此选项将收集后台 Web 服务事务。

捕获数据库 SQL 查询

sql.capture.enabled

• 启用此选项将监听所有执行的 SQL 查询。
• 如果禁用此选项，则不会收集数据库指标。

True

混淆 SQL 参数

transaction.trace.sql.parametrize

• 启用此选项将在慢事务跟踪中参数化所有 SQL 查询。（前提是 sql.capture.enabled 和 transaction.trace.enabled 均设置为 true）
• 禁用此选项将显示实际的查询（带参数）。

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

True

事务跟踪 SQL 堆栈跟踪阈值

transaction.trace.sql.stacktrace.threshold

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

3（秒）

显示实例端口号

show.instance.port.number

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

True

日志级别

apminsight.log.level

• APM Insight agent 应记录信息的日志级别。
• 支持的级别有 SEVERE，WARNING，INFO 和 FINE。

CRITICAL

需跳过跟踪的异常列表

exceptions.ignore

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

无

跳过事务

transaction.skip.patterns

• 提供可跳过跟踪的正则表达式模式或事务名称。
• 多个条目应为逗号分隔值。

无

• 采样因子帮助跟踪采样事务。
• 如果设置为 5，APMInsight 仅跟踪相同类型的每5个请求中的1个。

• 启用此选项将构建慢事务的跟踪。
• 您可以通过在 APM Insight 页面选择跟踪标签查看收集的跟踪。

• 任何响应时间超过指定阈值的事务跟踪将在 transaction.trace.enabled 设置为 true 的条件下被收集。
• 跟踪可用于分析和排查事务运行情况。

• 对所有 HTTP 请求，当外部组件调用（如 MYSQL、MEMCACHED 等）总数等于或高于配置数量时，将采集跟踪快照。

• 启用时为每个 HTTP 请求记录 CPU 时间。

• 当任意事务 CPU 使用超过此阈值时，将收集 CPU 时间。

捕获数据库 SQL 查询

sql.capture.enabled

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

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

True

混淆 SQL 参数

transaction.trace.sql.parametrize

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

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

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

True

事务跟踪 SQL 堆栈跟踪阈值

transaction.trace.sql.stacktrace.threshold

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

3（秒）

显示实例端口号

show.instance.port.number

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

True

日志级别

apminsight.log.level

• APM Insight agent 应记录信息的日志级别。

• 支持的级别有 SEVERE，WARNING，INFO 和 FINE。

CRITICAL

需跳过跟踪的异常列表

exceptions.ignore

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

无

跳过事务

transaction.skip.patterns

• 提供可跳过跟踪的正则表达式模式或事务名称。多个条目应为逗号分隔值。

无

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

• 如果设置为 5，APM Insight 仅跟踪相同类型的每5个请求中的1个。

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

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

• 任何响应时间超过指定阈值的事务跟踪将在 transaction.trace.enabled 设置为 true 的条件下被收集。
• 跟踪可用于分析和排查事务运行情况。

• 对所有 HTTP 请求，当外部组件调用（如 MYSQL、MEMCACHED 等）总数等于或高于配置数量时，将采集跟踪快照。

• 启用时为每个 HTTP 请求记录 CPU 时间。

• 当任意事务 CPU 使用超过此阈值时，将收集 CPU 时间。