帮助手册 APM APM Insight 配置

您可以通过修改 APM 代理配置文件来微调您的应用程序监控。APM 代理配置文件使您能够为 Web 和后台事务的关键参数设置阈值。

内容:

  1. 添加 APM 代理配置文件
  2. 编辑 APM 配置文件
  3. 配置文件 - 参数和默认值
 
对 APM 代理配置文件的更改应用于应用程序级别,而不是实例级别。如果您的应用程序有许多实例,则配置文件中的更改将应用​​于整个应用程序,并将反映在所有相应的实例中。

1.添加APM代理配置文件

要创建 APM 代理配置文件:

  1. 登录到您的 Site24x7 帐户。
  2. 导航到管理 > 配置文件 > APM 代理配置 > 添加 APM 代理配置文件。
  3. 输入您的个人资料名称并选择您的代理类型。
  4. 配置其他参数。
  5. 单击保存。

通常,默认配置文件(带有默认参数值)将分配给您的应用程序。对默认配置文件所做的任何更改都将自动反映在所有适用的代理中。
您还可以使用自定义参数值克隆配置文件,并将其应用于您各自的应用程序。

2. 编辑 APM 代理配置文件

  1. 导航到 APM Insight > 您的应用程序 > 编辑。
  2. 转到配置文件 > APM 代理配置文件。
  3. 单击下拉菜单以访问相应代理类型的配置文件。
  4. 选择相关配置文件并单击保存。

 

3.  配置文件 - 参数和默认值

APM 代理配置文件分为三部分——基本配置文件、Web 事务配置和后台事务配置。每个配置文件的参数说明如下。

基本配置文件

基本配置文件

日志记录级别
  • APM Insight 代理应记录信息的日志级别。
  • 支持的级别为严重、警告、信息和精细。
信息(日志级别)
配置 描述 默认值
捕获数据库 SQL 查询
  • 启用此选项将侦听所有执行的 SQL 查询。
  • 如果禁用此选项,则不会收集任何数据库指标。

true

混淆 SQL 参数
  • 启用此选项将参数化慢事务跟踪中的所有 SQL 查询。(如果 sql.capture.enabled 设置为 true & transaction.trace.enabled 设置为 true)
  • 禁用此选项将为您提供真正的查询(带参数)。
  • 如果使用信用卡号、密码等机密参数执行查询,建议启用此选项。
true
事务跟踪中 SQL 的 Stacktrace 阈值
  • 启用此选项将在超过此阈值时间值执行的任何 sql 查询时收集堆栈跟踪。
3(秒)
代理自动升级
  • 将此值设置为 true 时,代理将自动升级到最新的可用版本。
false
显示实例端口号
  • 如果启用此选项,将显示应用程序实例的端口号。
true
启用关闭告警
  • 只要您的应用程序进入 Down 状态,就会发送告警。
  • 仅支持非云监视器。
已禁用
抑制实例告警
  • 启用此选项将禁止所有实例的告警。
  • 所有告警模式,包括 SMS、语音、即时消息 (IM)、移动和网络浏览器推送通知都将被禁用。
false
要从跟踪中跳过的 URL 扩展列表
  • 跟踪时将跳过指定 URL 模式的 Web 事务
  • 使用逗号(,)分隔多个条目
    示例:transaction.skip.listening=*.jpeg,将跳过侦听以 .jpeg 结尾的事务
*.css、*.js、*.gif、*.jpg、*.jpeg、*.bmp、*.png、*.ico
要从跟踪中跳过的异常列表
  • 输入不需要跟踪的异常列表。
none
跳过事务
  • 提供可以从跟踪中跳过的正则表达式模式或事务名称。多个条目应该是逗号分隔的值。
none


Web 事务配置

Web 事务配置

配置 描述 默认值
Apdex 阈值
  • 应用程序性能指数(简称 Apdex)是衡量应用程序性能的指标,范围从 0 到 1。
  • 有关 Apdex 的详细信息,请访问www.apdex.org
  • 如果任何事务响应时间得分低于 apdex.threshold 值,则事务被标记为满意。
  • 如果任何事务响应时间得分高于 apdex.threshold 的四倍,则该事务被标记为受挫。
  • 如果它恰好等于 apdex.threshold 或介于满意和沮丧的阈值之间,则将其标记为容忍。
0.5(秒)
采样因子
  • 抽样因子有助于跟踪抽样事务。
  • 如果设置为 5,APMInsight 仅跟踪五分之一的同类请求
1(请求)
启用事务跟踪
  • 启用此选项将为慢速事务构建跟踪。
  • 您可以通过选择 Traces 选项卡查看在 Site24x7 APM Insight Edition 页面中收集的跟踪。
true
事务跟踪阈值
  • 如果 transaction.trace.enabled 设置为 true,则将收集其响应时间得分高于指定阈值的任何事务的跟踪。
  • 跟踪可用于分析、排除事务工作的故障。
2(秒)
如果外部调用超出,则捕获跟踪
  • 将为所有外部组件(如 MYSQL、MEMCACHED 等)调用计数等于或高于配置数量的所有 HTTP 请求拍摄跟踪快照。
30(计数)
捕获每个事务的 CPU 时间?
  • 记录每个 HTTP 请求的 CPU 时间(如果启用)。
true
捕获每个事务的内存分配?
  • 启用后,将捕获所有 Web 事务的内存分配。
2(秒)
捕获 HTTP 参数?
  • 启用此选项会捕获所有 GET 和 POST Web 请求的参数
  • 要跳过捕获特定参数,请使用 webtransaction.trace.input.params.ignore 键
  • 可以通过在 Traces 选项卡中选择所需的事务来查看捕获的参数
false
要忽略的 HTTP 参数列表
  • 要跳过捕获特定 Web 请求参数(如密码、PIN 或任何机密值),请为此密钥指定这些参数名称
  • 使用逗号(,) 分隔多个条目。为此键指定的值区分大小写
  • 如果不指定值,将记录所有请求参数
密码,authKey
要从跟踪中忽略的 HTTP 错误代码列表
  • 这是不会被跟踪的 HTTP 错误代码列表,例如 400、401 和 500。
none
捕获 HTTP 字节
  • 如果启用此选项,则在网络请求中捕获输入和输出字节。
true


后台事务配置

后台事务配置

配置 描述 默认值
跟踪后台事务
  • 启用此选项,APM Insight 代理开始跟踪后台事务
  • HTTP 以外的所有事务都被视为后台事务
true
捕捉痕迹
  • 启用此选项,代理收集慢后台事务的跟踪,前提是 bgtransaction.tracking.enabled 设置为 true
true
事务跟踪阈值
  • 如果 bgtransaction.trace.enabled 设置为 true,将为响应时间已超过指定阈值的后台事务收集跟踪
5秒)
捕获跟踪,如果外部调用超过
  • 将对外部组件(如 MYSQL、MEMCACHED 等)总调用计数等于或高于配置数量的后台事务进行跟踪快照。
40(计数)
捕获每个事务的 CPU 时间
  • 记录每个后台事务的 CPU 时间(如果启用)。
false
捕获每个事务的内存分配
  • 如果启用此选项,将捕获为后台事务分配的内存。
false
采样因子
  • 后台事务的抽样因子
  • 如果值设置为 1,代理会跟踪每笔事务。如果值设置为 n,代理会跟踪 n 个同类事务中的 1 个
1(请求)

仅在 apminsight.conf 中可用的配置

无法从客户端修改某些配置文件。这些设置可以在 apminsight.conf 文件中进行配置。

配置 描述 默认值
application.name
  • 指定要在 Site24x7 中显示的所需应用程序的名称。
  • 如果您的应用程序有多个实例并且您想对它们进行分组,则在所有已安装的 APM Insight 代理配置文件中指定相同的应用程序名称。
    示例:myonlineshopping.com
我的应用程序
注册码*
  • 对应用户的 API Key。
  • 登录后,这将在 APM Insight 主页中可用。
  • 复制并粘贴密钥作为此参数的值。
  • 此密钥是用户特定的。不要与其他任何人分享。
后台代理
  • 指定代理安装的应用程序服务器是否在代理网络下。
  • 如果设置为 True,则应提供代理凭据信息,以便将指标数据从代理发送到 Site24x7。
  • 如果 behind.proxy 设置为 true,请为以下键指定值:
    • proxy.server.host:代理服务器的主机名
    • proxy.server.port:代理服务器的端口
    • proxy.auth.username:代理服务器的用户名
    • proxy.auth.password:代理服务器的密码
false
代理服务器端口*
  • 指定应用程序在服务器上运行的端口号。
  • 每个端口号 ios 都被视为一个单独的实例,并将分组在相同的应用程序名称下。
80

* - 强制值。如果这些条目中的任何一个未提供或无效,则无法初始化/启动代理。但是应用程序服务器(部署代理的地方)将正常启动

帮助手册 APM APM Insight 配置