应用监控的一些常用设置，例如调用链采样率、Agent开关、慢SQL阈值等，可直接在自定义配置页签上配置。

前提条件

创建应用监控任务

功能入口

  1. 登录ARMS控制台。
  2. 在左侧导航栏选择应用监控 > 应用列表，并在顶部菜单栏选择目标地域。
  3. 在应用列表页面单击目标应用的名称。
  4. 在左侧导航栏中单击应用设置，并在右侧页面单击自定义配置页签。
  5. 设置自定义配置参数，设置完毕后，在页面底部单击保存。

配置调用链采样设置

ARMS试用版和专家版

在调用链采样设置区域，可以打开或关闭调用链采样开关，并设置采样率。采样率设置字段输入百分比的数字部分即可，例如输入10代表采样10%。

说明 调用链采样率优先级高于限流阈值。
Chain sampling

ARMS基础版

ARMS基础版支持设置客户端采样策略，并按照采集数据行数进行计费。ARMS默认免费为您账号下所有接口的每个探针每分钟采集一条调用链。除此之外，您还可以添加自定义的采样策略。

表 1. 客户端采样策略设置项
设置项说明
策略名称自定义采样策略名称。
采样类型和采样值
  • 固定比例采样：按照设置的固定比例进行调用链采样。若选择此选项，则采样值设置为固定比例，如10%。
  • 流量限额：若选择此选项，采样值需设置每个探针在设定时间范围内采集的调用链条数，如5条Trace/每个探针每1秒，表示每个探针每1秒钟采集5条调用链。
适用接口设置采样策略生效的接口范围，可选择每个接口或指定接口并输入指定的接口名称。
说明 目前每个采样策略在选择指定接口时，仅支持输入一个接口名。若需对多个接口进行调用链采样，则需设置多个采样策略。

完成采样策略设置后，您可以在控制台选择是否开启该策略。多个采样策略会同时生效，但存在优先级如下：默认采样（免费）> 单接口流量限额 > 单接口固定比例采样 > 全部接口流量限额 > 全部接口固定比例采样。您也可以编辑已添加的采样策略，或删除不需要的采样策略。

采样策略-基础版

配置Agent（探针）开关和日志级别

在Agent开关配置区域，可以打开或关闭探针总开关以及各插件开关，并配置日志级别。

重要 探针总开关和日志级别的修改即时生效，无需重启应用。如果关闭探针总开关，则系统将无法监控您的应用，请谨慎操作。要使对各插件开关的修改生效，必须手动重启应用。
Agent Switches

配置阈值设置

在阈值设置区域，可以设置慢SQL查询阈值、接口响应时间阈值和限流阈值。

说明 调用链采样率优先级高于限流阈值。
Threshold Settings

配置高级设置

在高级设置区域，可以设置需过滤的接口、方法堆栈最大长度等。

Advanced Settings
  • 无效接口调用过滤：输入不需要查看调用情况的接口，从而将其从接口调用页面隐去。
  • 方法堆栈最大长度：默认为128条，最大值为400条。
  • 同类异常堆栈区分深度：同类型异常，用于作为不同异常区分的堆栈深度，一般设置为第一个差异调用的深度。
  • 采集SQL最大长度：默认为1024个字符，最小值为256，最大值为4096。
  • 采集SQL绑定值：捕获PrepareStatement参数绑定的变量值，无需重启应用即可生效。
  • 原始SQL：仅对SQL截断，不做额外处理。
  • 异常过滤：此处输入的异常不会显示在应用详情和异常分析页面的图表中。
  • 错误数过滤：默认情况下，大于400的状态码会计入错误数，您可以自定义大于400但不计入的HTTP状态码。
  • 调用链新格式：采用支持调用链时间排序的新存储格式（默认打开）。
  • 调用链压缩：是否将重复调用（比如for循环）简化，无需重启应用即生效。
  • 请求入参最大长度：默认为512字符，支持的最大长度为2048字符。
  • 分位数统计：是否开启分位数统计功能。
    说明 分位数：指将一个随机变量的概率分布范围分为几个等份的数值点，常用的有中位数（即二分位数）、四分位数、百分位数等。
  • RabbitMQ自定义消费者：通过设置自定义消费者的类名或者包含匿名内部消费者的类名，可以看到该消费者的调用链路。多个消费者以半角逗号（,）分隔。
  • 线程池监控：支持Tomcat/Dubbo/HSF等框架的线程池指标监控，需升级Agent探针至最新版本。该设置需重启应用后生效。
  • 异步透传扫描包名：添加异步透传扫描包实现异步任务监控。异步透传扫描包中的Runnable、Callable和Supplier接口在创建新对象时会自动捕获当前线程调用链的上下文，并在异步线程中执行时使用该调用链上下文，完成串联。探针版本必须为v2.7.1.3及以上。
  • 请求中返回TraceId：仅针对HTTP类型的请求，在Response Header中返回字段为eagleeye-traceid。

配置线程设置

在线程设置区域，可以打开或关闭线程诊断方法栈开关、线程剖析总控开关，并设置慢调用监听触发阈值。

说明 仅应用监控专家版支持该功能。
Thread Settings
说明 服务调用耗时超过慢调用监听触发阈值（默认值为1000毫秒）时才会启动监听，并一直持续到该次调用结束或超过15秒。建议将此阈值设为调用耗时的第99百分位数。假设有100次调用，则按耗时从小到大排序，排在第99位的耗时就是第99百分位数。

设置关联业务日志与TraceId

在业务日志关联设置区域，可以设置是否在应用的业务日志中关联调用链的TraceId信息。更多信息，请参考业务日志关联调用链的TraceId信息。
说明 仅应用监控专家版支持该功能。
Business log

配置URL收敛规则

在URL收敛设置区域，可以打开或关闭收敛功能的开关，并设置收敛阈值、收敛规则和排查规则。URL收敛是指将具有相似性的一系列URL作为一个单独的个体展示，例如将前半部分都为/service/demo/的一系列URL集中展示。收敛阈值是指要进行URL收敛的最低数量条件，例如当阈值为100时，则符合规则正则表达式的URL达到100时才会对它们进行收敛。

URL Aggregation

设置Arthas监控

在Arthas监控区域，可以打开或关闭Arthas诊断功能，并设置生效IP。更多信息，请参见Arthas诊断（新版）。

说明 仅应用监控专家版支持该功能。
自定义配置-Arthas监控

设置日志分析

在日志分析配置区域，可以打开或关闭日志分析功能，并设置日志采集级别和长度。更多信息，请参见日志分析（旧版）。

自定义配置-日志分析配置

将配置复制到其他应用

如果您需要为其他应用同步相同配置，可以将对应配置复制到其他应用上。

将单个配置复制到其他应用

  1. 在对应配置区域单击批量复制到其他应用。
  2. 在弹出的对话框中选择生效的应用，然后单击确定。
    批量复制

将所有配置复制到其他应用

  1. 在页面底部单击批量复制到其他应用。
  2. 在弹出的对话框中选择生效的应用，然后单击确定。
    批量复制

全局默认配置

您可以将当前配置保存为全局默认配置，在之后创建新应用时将会默认使用当前配置。

  1. 在页面底部单击保存当前应用设置为全局默认配置。
  2. 在弹出的对话框中单击确认。