ARMS标签功能方便您以一种全新的维度来组织并观察应用监控指标、调用链、日志等数据。目前标签中心仅对Java应用开放,本文介绍如何将Java应用接入标签中心,并在应用总览应用详情Grafana视图页面通过标签筛选应用监控指标。

前提条件

已将应用接入ARMS应用监控。具体操作,请参见应用监控接入概述
  • 对于容器集群应用,请确认ack-onepilot版本在v3.0.4或以上且ARMS Java Agent版本在v2.7.3.5或以上。
  • 对于其他环境应用,请确认ARMS Java Agent版本在v2.7.3.5或以上,您可以在ARMS控制台应用监控 > Agent列表页面下的Java版本发布说明页签获取最新的Java Agent安装包。

为ACK集群Java应用添加标签

默认标签

应用接入ARMS之后,ARMS标签中心会自动识别您的应用所在的集群名称、镜像版本和命名空间,分别生成集群标签clustername:<your-cluster-name>,版本标签version:<your-image-tag>和命名空间标签namespace:<your-namespace> 。其中集群标签,版本标签和命名空间标签均为实例级别标签。
说明 应用级别标签可以理解为只在应用列表生效,实例级别标签则会在应用内部生效。

自定义标签

  1. 容器服务Kubernetes版控制台左侧导航栏单击集群,在集群列表页面上的目标集群右侧操作列单击应用管理
  2. 无状态有状态页面顶部选择目标命名空间,然后为目标应用添加标签。
    • 方式一:
      在目标应用右侧选择更多 > 编辑标签,然后在编辑对话框添加标签后单击确定ACK集群应用标签
    • 方式二:
      在目标应用右侧选择更多 > 查看Yaml,然后在编辑YAML对话框中添加自定义标签后单击更新
      说明
      • 使用arms.app.version作为标签的Key可覆盖默认标签中的版本标签。
      • 以Deployment为例,在YAML中配置标签,您可以根据需求将标签添加在Deployment Label或Pod Label中。
      ACK添加标签
  3. 手动重启应用。

为开源K8s集群Java应用添加标签

默认标签

应用接入ARMS之后,ARMS标签中心会自动识别您的应用所在的集群名称、镜像版本和命名空间,分别生成集群标签clustername:<your-cluster-name>,版本标签version:<your-image-tag>和命名空间标签namespace:<your-namespace> 。其中集群标签,版本标签和命名空间标签均为实例级别标签。
说明 应用级别标签可以理解为只在应用列表生效,实例级别标签则会在应用内部生效。

自定义标签

  1. 在应用的YAML文件中添加自定义标签,然后保存文件。
    说明
    • 使用arms.app.version作为标签的Key可覆盖默认标签中的版本标。
    • 以Deployment为例,在YAML中设定的标签,可以配置在Deployment Label中,也可以配置在Pod Label中。
    开源K8s应用添加标签
  2. 手动重启应用。

为Docker集群Java应用添加标签

自定义标签

  1. ARMS控制台应用监控 > Agent列表页面下的Java版本发布说明页签获取最新的Agent安装包。
  2. 在Agent安装包的arms-agent.config配置文件中配置自定义标签,其他参数的配置,请参见为Docker中的Java应用安装Agent
    docker添加标签
  3. 配置完成后保存文件,然后在Dockerfile中将原有的Agent安装包里的arms-agent.config配置文件替换为上一步修改后的文件。
  4. 重新构建镜像并运行。

为其他环境Java应用添加标签(如ECS、自建IDC)

自定义标签

  1. 参考以下内容在Agent安装包的arms-agent.config配置文件中添加自定义标签。
    ###########################################################
    # Tags                                                    #
    ###########################################################
    #profiler.tags.env=prod
    profiler.tags.env=
    
    #profler.tags.version=v1.0
    profiler.tags.version=
    
    #profiler.tags.customtags=key1:value1&key2:value2
    profiler.tags.customtags=
  2. 手动重启应用。

使用标签

在应用总览页面通过标签查看监控指标

  1. 登录ARMS控制台,在左侧导航栏选择应用监控 > 应用列表
  2. 应用列表页面顶部选择目标地域,然后单击目标应用名称。
    说明 语言列显示Java图标图标的应用为接入应用监控的应用,显示-图标的应用为接入链路追踪的应用。
  3. 在左侧导航栏单击应用总览,在右侧页面选择不同的标签,查看对应的监控指标。
    应用总览查看标签

在应用详情页面通过标签查看监控指标

  1. 登录ARMS控制台,在左侧导航栏选择应用监控 > 应用列表
  2. 应用列表页面顶部选择目标地域,然后单击目标应用名称。
    说明 语言列显示Java图标图标的应用为接入应用监控的应用,显示-图标的应用为接入链路追踪的应用。
  3. 在左侧导航栏单击应用详情,在右侧页面选择不同的标签,查看对应的监控指标。
    应用详情查看标签

在Grafana视图页面通过标签查看监控指标

  1. 登录ARMS控制台,在左侧导航栏选择应用监控 > 应用列表
  2. 应用列表页面顶部选择目标地域,然后单击目标应用名称。
    说明 语言列显示Java图标图标的应用为接入应用监控的应用,显示-图标的应用为接入链路追踪的应用。
  3. 在左侧导航栏单击Grafana视图,在右侧页面顶部选择不同的标签,查看对应的监控指标。
    GrafanaView