Golang应用自定义配置

您可以在自定义配置页签上调整探针功能开关、采样策略等常用设置。

说明

如果您需要使用API方式调整,请参见SaveTraceAppConfig

前提条件

已为应用安装探针,具体操作,请参见应用监控接入概述

功能入口

  1. 登录ARMS控制台,在左侧导航栏选择应用监控 > 应用列表

  2. 应用列表页面顶部选择目标地域,然后单击目标应用名称。

    说明

    语言列的图标含义如下:

    Java图标:接入应用监控的Java应用。

    image:接入应用监控的Golang应用。

    image:接入应用监控的Python应用。

    -:接入可观测链路 OpenTelemetry 版的应用。

  3. 在上方导航栏选择应用配置 > 自定义配置

  4. 设置自定义配置参数,设置完成后,单击保存

采样设置

采样设置区域,可以为调用链设置采样策略。Golang应用目前仅支持通过固定采样率采样,同时支持按接口名、接口前缀、接口后缀配置全采样。

image

探针开关设置

探针开关设置区域,可以控制应用监控的启停并调整各插件开关。

重要

应用监控的启停修改即时生效,无需重启应用。如果暂停应用监控,则系统将无法监控您的应用,请谨慎操作。

对各插件开关的修改,手动重启应用后生效。

image

Runtime开关设置

Runtime开关设置区域,可以打开或关闭Runtime监控功能。更多信息,请参见Runtime监控

重要

修改动态生效,无需重启应用。若关闭Runtime监控功能,ARMS将不会采集Runtime指标,请谨慎操作。

image

应用日志关联配置

应用日志关联配置区域,可以设置应用关联的日志源信息,将SpanId、TraceId打印到对应的日志中。更多信息,请参见Golang应用业务日志关联调用链TraceId

image

URL收敛设置

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

image

持续剖析设置

持续剖析设置区域,可以打开或关闭总开关、CPU热点、内存热点和代码热点功能。更多信息,请参见Golang应用持续剖析

image

接口调用配置

接口调用配置区域,可以设置慢调用阈值、HTTP状态码白名单、无效接口调用过滤等。

2025-02-18_16-05-16

  • 慢调用阈值:默认为500,当接口响应时间大于该阈值的时候,该接口会被标记为慢调用。

  • HTTP状态码白名单

    默认情况下,HTTP 状态码大于 400 会被归类为错误调用。如果您不希望某类状态码被归类为错误,可以设置白名单来忽略这类错误。

    仅对应用监控当前支持的 HTTP 框架产生影响。

    影响数据:HTTP 服务端/客户端的错误数指标(arms_http_requests_error_count、arms_http_client_requests_error_count、arms_app_requests_error_count)、Span 状态。

    影响功能应用概览提供服务依赖服务页签中的错误数,调用链分析页面的 Span 状态、错误数告警。

    内容格式:填写单一状态码,多个状态码用英文半角逗号(,)分隔,不支持模糊匹配。

    示例403,502

    默认值:空

  • 无效接口调用过滤

    如果您不希望在提供服务页签看到这类调用,可以输入不需要查看调用情况的接口名,探针将不会上报相关接口产生的观测数据,从而将其从接口调用页面隐去。

    影响数据:接口对应的所有指标、Span 都会被忽略。

    影响功能应用概览提供服务依赖服务页签对应接口的所有指标,调用链分析页面的 Span 数量、对应接口的调用量、错误数、慢调用告警。

    内容格式:使用字符串AntPath 表达式匹配无效接口全名,多个规则请使用英文半角逗号(,)分隔。(默认值的 AntPath 表达式写法是为了兼容存量数据,不建议删除,新增配置请拼接在原有规则之后)。

    示例/api/test/*,/api/playground/create

    默认值/**/*.jpg,/**/*.png,/**/*.js,/**/*.jpeg,/**/*.pdf,/**/*.xlsx,/**/*.txt,/**/*.docs,/**/*.gif,/**/*.csv

  • 开启打印HTTP请求Body:开启后会在HTTP ClientSpan中增加http.request.body字段表示请求的Body,默认打印的长度是1024。

  • 开启打印HTTP请求Header:开启后会在HTTP ClientSpan中增加http.request.header字段表示请求的Header。

  • HTTP Body长度:HTTP请求Body的长度,默认打印的长度是1024。

  • HTTP返回结果中包含TraceId:开启后会在返回的Header中添加TraceId,KeyEagleeye-TraceId。

  • 开启打印HTTP返回Body:开启后会在HTTP ServerSpan中增加http.response.body字段表示返回的Body。

  • 开启打印HTTP返回Header:开启后会在HTTP ServerSpan中增加http.response.header字段表示返回的Header。

  • HTTP返回Body的长度:HTTP返回Body的长度,默认打印的长度是1024。

  • HTTP请求Header Key写入Span:填写Header中出现的Key,多个可以用英文半角逗号分隔,填写后会在HTTP ClientSpan中增加http.request.header.key 字段。

  • HTTP返回Header Key写入Span:填写Header中出现的Key,多个可以用英文半角逗号分隔,填写后会在HTTP ServerSpan中增加http.response.header.key 字段。

数据库调用配置

数据库调用配置区域,可以设置慢SQL阈值、采集SQL最大保留长度,并设置是否展示SQL中的变量绑定值以及常量值。

  • 展示SQL中的变量绑定值:捕获PreparedStatement参数绑定的变量值,无需重启应用即可生效。

  • 展示SQL中的常量值:仅对SQL截断,不做额外处理,无需重启应用即可生效。

image

调用链透传协议设置

调用链透传协议设置区域,您可以根据自己的需求选择使用的Trace协议。默认使用W3C协议,可以选择Zipkin、Jaeger、EagleEye。

image

探针采集配置

探针采集配置区域,可以设置探针每秒最大链路采集量和探针日志级别。

image

高级设置

高级设置区域,可以设置分位数统计、错慢采样、异常堆栈收集大长度等。

image

将配置复制到其他应用

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

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

  1. 在对应配置区域单击保存并批量复制到其他应用

  2. 如果弹出当前设置未保存对话框,请单击确定保存本应用配置后,再单击保存并批量复制到其他应用

  3. 在弹出的对话框中选择生效的应用,然后单击确定

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

  1. 在页面底部单击保存并批量复制到其他应用

  2. 如果弹出当前设置未保存对话框,请单击确定保存本应用配置后,再单击保存并批量复制到其他应用

  3. 在弹出的对话框中选择生效的应用,然后单击确定

全局默认配置

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

  1. 在页面底部单击保存当前应用设置为全局默认配置

  2. 如果弹出当前设置未保存对话框,请单击确定保存本应用配置后,再单击保存当前应用设置为全局默认配置

  3. 在弹出的对话框中单击确认