Ruby代理配置选项

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

示例： myonlineshopping.com

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

Capture database SQL queries

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

true

Parametrize SQLs in transaction trace

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

true

Stacktrace threshold for SQLs in transaction trace

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

3 (Second)

apm.host^*

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

license.key^*

• 相应的Applications Manager的许可密钥。
• 这将在APM Insight标签>帮助卡 中提供。
• 复制并粘贴密钥作为此参数的值。
• 该密钥特定于Applications Manager，请勿与其他任何人共享。

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中输入正确的端口为止。

• 标有*的选项为必填项。如果未提供任何必需项，则无法初始化/启动代理。但是，Application Server（部署代理的位置）将正常启动。
• 对这些选项的任何更改仅在Application Server重新启动时才生效
• 所有选项apminsight.conf文件也可以作为环境变量提供。可以通过将环境变量括在{}中来完成。 
  
  示例：
  application.name = {app_name}
  这里的app_name是环境变量
  
  注意：代理仅在 ENV hash中查找环境变量

Apdex阈值

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

0.5 (Second)

采样系数

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

1 (request)

启用事务追踪

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

true

事务追踪阈值

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

2 (Seconds)