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. 在应用列表页面顶部选择目标地域，然后单击目标应用名称。
  3. 在左侧导航栏单击应用总览，在右侧页面选择不同的标签，查看对应的监控指标。
    应用总览查看标签

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

  1. 登录ARMS控制台，在左侧导航栏选择应用监控 > 应用列表。
  2. 在应用列表页面顶部选择目标地域，然后单击目标应用名称。
  3. 在左侧导航栏单击应用详情，在右侧页面选择不同的标签，查看对应的监控指标。
    应用详情查看标签

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

  1. 登录ARMS控制台，在左侧导航栏选择应用监控 > 应用列表。
  2. 在应用列表页面顶部选择目标地域，然后单击目标应用名称。
  3. 在左侧导航栏单击Grafana视图，在右侧页面顶部选择不同的标签，查看对应的监控指标。
    GrafanaView