APM Insight代理配置选项

application.name*

• 指定所需的应用程序名称以显示在Applications Manager中
• 如果您的应用程序有多个实例，并且希望将它们分组，请在所有已安装的APM Insight Agent配置文件中指定相同的应用程序名称。

示例： myonlineshopping.com

My Application

apm.host*

• 正在运行Applications Manager的主机名。
• 如果输入了无效/无法访问的主机名，则代理将引发连接被拒绝异常，并将重试，直到在apminsight.conf中输入正确的主机名为止。
• 接受主机名或Ipv4地址

示例： mymachine.mydomain.com

apm.protocol.https

• 如果应通过HTTPS协议发送到Applications Manager的数据，则指定true。
• 如果为false，则数据将通过HTTP协议发送

false

apm.port*

• 指定Applications Manager的HTTP端口。如果apm.protocol.https为true，请指定HTTPS端口。
• 如果服务未在指定端口中运行，则代理将引发拒绝连接异常，并将重试，直到在apminsight.conf中输入正确的端口为止。

示例： 9090

behind.proxy

• 指定代理安装的Application Server在代理网络下的环境。
• 如果设置为True，则应提供代理凭证信息，以便将指标数据从代理发送到Applications Manager。
• 如果将behind.proxy设置为true，请为以下键指定值：
  • proxy.server.host：代理服务器的主机名
  • proxy.server.port：代理服务器的端口
  • proxy.auth.username：代理服务器的用户名
  • proxy.auth.password：代理服务器的密码

false

agent.server.port*

• 指定应用程序服务器的HTTP侦听端口。
• 当同一主机上运行多个Application Server时，区分实例将非常有用。例如：8080

apdex.threshold

• 应用程序性能指数（简称为Apdex）是对应用程序性能的衡量，范围为0到1。
• 有关Apdex的详细信息，请访问www.apdex.org。
• 如果任何事务响应时间的得分低于apdex.threshold值，则该事务被标记为满意。
• 如果任何事务响应时间得分超过apdex.threshold的四倍，则该事务被标记为失望。
• 如果它刚好等于apdex.threshold或介于满足阈值和失望阈值之间，则将其标记为容忍。

0.5 (Second)

sql.capture.enabled

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

true

transaction.trace.enabled

• 启用此选项将构造慢速事务跟踪。
• 您可以通过选择跟踪选项卡来查看在Applications Manager APM Insight页面中收集的跟踪。

true

transaction.trace.threshold

• 如果transaction.trace.enabled设置为true，则将收集其响应时间得分超过指定阈值的任何事务的跟踪。
• 跟踪可用于分析事务并对其进行故障排除。

2 (Seconds)

transaction.trace.sql.parametrize

• 启用此选项将对慢速事务跟踪中的所有SQL查询进行参数化。（如果sql.capture.enabled设置为true，而transaction.trace.enabled设置为true）
• 禁用此选项将为您提供真实的查询（带有参数）。
• 如果有使用私密参数（例如信用卡号，密码等）执行的查询，建议启用此选项。

true

transaction.trace.sql.stacktrace.threshold

• 只要在此阈值时间值以上执行任何SQL查询，启用此选项将收集堆栈跟踪。

3 (Second)

webtransaction.trace.input.params.record

• 启用此选项将获取所有GET＆POST Web请求的参数
• 要跳过获取特定参数，请使用webtransaction.trace.input.params.ignore键
• 通过在跟踪选项卡中选择所需的事务，可以查看获取的参数

false

webtransaction.trace.input.params.ignore

• 要跳过获取特定的Web请求参数（例如密码，PIN或任何机密值），请为此密钥指定这些参数名称
• 使用逗号（，）分隔多个条目。为此键指定的值区分大小写
• 如果未指定任何值，则将记录所有请求参数

password, authKey

webtransaction.naming.use.requesturl

• 要显示Web事务的完整URL，请使用webtransaction.n 。apminsight.conf文件中的use.requesturl = true。这是一个隐藏的配置，默认值为false。

webtransaction.encoding.charset

• 要在处理应用程序数据时指定编码字符集，请使用apminsight.conf文件中的webtransaction.encoding.charset = Windows-1252。默认值为UTF-8

transaction.skip.listening

• 跟踪时将跳过指定URL模式的Web事务
• 使用逗号（，）分隔多个条目
• 例如：transaction.skip.listening = *。jpeg，将跳过监听以.jpeg结尾的事务

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

transaction.tracking.request.interval

• 一种抽样。如果为20，则APM Insight仅在每20个同类请求后跟踪请求。即它将跟踪此类的1st，21st，41st ..请求。
• 保持的请求计数将每隔一分钟重置一次。

1 (request)

include.components

• 默认情况下，APM Insight将事务分组为不同的组件，例如STRUTS，SERVLET，MYSQL等。
• 可以通过以下格式指定包名称来添加自定义组件：packagename /.*：Component_Name
• 指定程序包下的所有程序包和类都将分组为指定的组件
• 对于Ex：include.components = com/test/custom /.*：CUSTOM，com/test/custom /包下的所有包和类都将分组到CUSTOM组件中
• 使用逗号（，）分隔多个条目

注意：默认情况下，指定的软件包名称将包含在检测中，您无需在custom_instrumentation.conf中重复此操作

apminsight.log.dir

• 应该存储APM Insight日志的目录路径。
• 使用正斜杠（/）作为路径分隔符
• 例如：D：/ apminsight /
• 如果注释或提及不正确或无法创建配置的目录，则默认为安装APM Insight代理jar的目录。

apminsight.log.level

• APM Insight代理应记录信息的日志级别。
• 支持的级别为严重，警告，信息。

INFO (level)

autoupgrade.enabled

• 启用此选项代理将自动下载并安装最新的免费版本

false

• 启用此选项，APM Insight代理开始跟踪后台事务
• HTTP以外的所有其他事务均被视为后台事务

• 启用此选项后，如果bgtransaction.tracking.enabled设置为true，则代理将收集针对慢速后台事务的跟踪

bgtransaction.trace.threshold

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

• 后台事务的采样因子
• 如果值设置为1，则代理会跟踪每个事务。如果将值设置为n，则代理在N种同类事务中跟踪1。

• 这些值不能在Java代理运行时更改。为了使更改生效，需要重新启动服务器。
• 使用.Net代理不需要重新启动服务器，这些值将在运行时更新。

Case 3: Usage on Methods

public class Product {
@ApmTracker
public int getPrice(String product, String brand) {
...
}
...

@ApmTracker(component="FetchBrand")
private List fetchAllBrandsList(String product) {
...
}
}