APM Insight .NET Core Agent 配置选项

捕获数据库 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

日志级别

apminsight.log.level

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

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

CRITICAL

跳过追踪的异常列表

exceptions.ignore

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

无

跳过事务

transaction.skip.patterns

• 输入可跳过追踪的正则表达式模式或事务名称。多项条目请用逗号分隔。

无

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

• 指定的 URL 模式的 Web 事务将被跳过追踪。
• 多项条目请用逗号（,）分隔。例如：transaction.skip.listening=*.jpeg，将跳过以 .jpeg 结尾的事务追踪。

Apdex 阈值

apdex.threshold

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

• 有关 Apdex 的详细信息，请访问 www.apdex.org

• 如果事务响应时间低于 apdex.threshold，事务被标记为满意。

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

• 如果响应时间恰好等于 apdex.threshold 或介于满意与沮丧阈值之间，则标记为容忍。

0.5（秒）

采样因子

transaction.tracking.request.interval

• 采样因子用于跟踪采样事务。

• 如果设置为 5，APM Insight 只跟踪每 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 Web 请求的参数。

• 若要跳过特定参数的捕获，请使用 webtransaction.trace.input.params.ignore 键。

• 捕获的参数可通过选择跟踪标签中的相应事务查看。

False

忽略的 HTTP 参数列表

webtransaction.trace.input.params.ignore

• 若要跳过捕获特定的请求参数（如密码、PIN 或其他机密值），请为此键指定参数名称。

• 多个条目请用逗号（,）分隔。该键的值区分大小写。

• 如果未指定任何值，则所有请求参数均被记录。

password, authKey

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

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

跟踪后台事务

bgtransaction.tracking.enabled

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

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

True

捕获跟踪

bgtransaction.trace.enabled

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

True

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

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

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

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

应用名称

application.name

• 指定在 Applications Manager 中显示的应用名称。

• 如果有多个应用实例且需要将它们分组，请在所有安装的 APM Insight Agent 配置文件中指定相同的应用名称。
  示例：myonlineshopping.com

True

捕获跟踪

license.key

• 对应用户的 API 密钥。

• 登录后，此密钥将显示在 APM Insight 首页。

• 复制并粘贴该密钥作为此参数的值。

• 此密钥为用户专属，不得与他人共享。

无

配置代理

behind.proxy

• 指定安装 Agent 的应用服务器是否处于代理网络下。

• 如果设置为 True，需提供代理凭证信息，以便从 agent 向 Applications Manager 发送指标数据。

• 如果 behind.proxy 设置为 true，请为以下键指定值：

• proxy.server.host：代理服务器主机名

• proxy.server.port：代理服务器端口

• proxy.auth.username：代理服务器用户名

• proxy.auth.password：代理服务器密码

False

APM 目录路径

apminsight.log.dir

• APM Insight 日志存储的目录路径。

• 使用正斜杠（/）作为路径分隔符

• 示例：D:/apminsight/
• 如果注释、指定错误或无法创建配置目录，则默认为 APM Insight agent jar 所安装目录。
• 该设置位于 apminsight.conf 中，默认处于注释状态。
• 要更改此参数，Windows 和 Linux 的示例用法如下： Windows：D:/Tomcat/APMInsight/logs Linux：/home/apps/APM/APMInsight/logs