Java代理配置选项


该页面应帮助您调整APM Insight Java代理配置概要文件的配置。APM Java代理配置概要文件使您可以设置关键参数和Web事务的阈值。可以在apminsight.conf文件中或从Web客户端 (由 表示)。确保此文件在您已部署APM Insight代理的文件夹中。

APM代理配置概要文件分为两部分:

The APM agent configuration profile is categorized into two parts:

基本配置文件

配置 描述 默认值

application.name *

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

示例: myonlineshopping.com

注意:使用APM Insight Java代理,您可以选择通过JVM参数配置应用程序名称,而不是在apminsight.conf文件中进行配置。添加以下参数:
-Dapminsight.application.name = MyApplication

My Application

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
8080

apminsight.log.dir

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

apminsight.log.level

  • APM Insight代理应记录信息的日志级别。
  • 支持的级别为严重,警告,信息。
INFO (level)

transaction.skip.listening

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

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

获取数据库SQL查询 

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

true

事务跟踪中的参数SQL 

  • 启用此选项将对慢速事务跟踪中的所有SQL查询进行参数化。(如果将Capture database SQL查询设置为true,并且将启用事务跟踪设置为true)
  • 禁用此选项将为您提供真实的查询(带有参数)。
  • 如果有使用私密参数(例如信用卡号,密码等)执行的查询,建议启用此选项。

true

事务跟踪中的SQL的Stacktrace阈值 

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

3(秒)

代理自动升级 

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

false

以下属性适用于Applications Manager版本14440及更高版本

apm.host *

  • Applications Manager运行所在的URL。
  • 如果输入了无效/无法访问的Applications Manager详细信息,则代理将引发连接被拒绝异常,并将重试,直到在apminsight.conf中输入正确的详细信息为止。
https:// localhost:8443

license.key *

  • 相应的Applications Manager的许可密钥。
  • 这将在APM Insight标签>帮助卡中提供。 
  • 复制并粘贴密钥作为此参数的值。
  • 该密钥特定于Applications Manager,请勿与其他任何人共享。 
例: 
license.key = APMI_38497e5d7f08c97214db485882372818b854445c98e2927e94
 
以下属性适用于14440以下的Applications Manager版本

apm.host *

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

示例: mymachine.mydomain.com

localhost

apm.protocol.https

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

false

apm.port *

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

 

注意事项
  • 标有*的选项为必填项。如果未提供任何必需项,则无法初始化/启动代理。但是,Application Server(部署代理的位置)将正常启动。
  • 对这些选项的任何更改仅在Application Server重新启动时才生效

事务配置

配置 描述默认值

Apdex 阈值

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

0.5 (秒)

Sampling factor

  • 如果为20,则APM Insight仅在每20个同类请求后跟踪请求。即它将跟踪此类的1st,21st,41st ..请求。

1 (请求)

Enable transaction tracing

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

true

Transaction tracing threshold

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

2 (秒)

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,请使用apminsight.conf文件中的webtransaction.naming.use.requesturl=true。这是一个隐藏的配置,默认值为false。
 

webtransaction.encoding.charset

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

如果为选项指定了任何无效值,则APM Insight将使用其默认出厂值。