標(biāo)簽類(lèi)型

目前ARMS應(yīng)用監(jiān)控提供兩種維度的標(biāo)簽：應(yīng)用標(biāo)簽和實(shí)例標(biāo)簽，請(qǐng)您根據(jù)使用場(chǎng)景選擇合適的標(biāo)簽類(lèi)型。應(yīng)用標(biāo)簽和實(shí)例標(biāo)簽都采用鍵值對(duì)（Key-Value）的數(shù)據(jù)結(jié)構(gòu)，可以同時(shí)添加多個(gè)鍵值對(duì)。

應(yīng)用標(biāo)簽

作用于ARMS應(yīng)用上，您可以在ARMS控制臺(tái)應(yīng)用監(jiān)控 > 應(yīng)用列表頁(yè)面查看或修改應(yīng)用標(biāo)簽。通過(guò)應(yīng)用標(biāo)簽，可以實(shí)現(xiàn)應(yīng)用篩選、應(yīng)用權(quán)限管理、成本分賬等方面的需求。

實(shí)例標(biāo)簽

在ARMS的設(shè)計(jì)中，一個(gè)應(yīng)用可以包含多個(gè)應(yīng)用實(shí)例，每個(gè)應(yīng)用實(shí)例都代表一個(gè)應(yīng)用進(jìn)程，它們通過(guò)相同的應(yīng)用名接入到ARMS中。不同于應(yīng)用標(biāo)簽，實(shí)例標(biāo)簽作用在應(yīng)用實(shí)例上，對(duì)于同屬一個(gè)應(yīng)用的不同應(yīng)用實(shí)例，它們可以擁有不同的實(shí)例標(biāo)簽。

對(duì)于Kubernetes環(huán)境下自動(dòng)接入ARMS應(yīng)用監(jiān)控的應(yīng)用實(shí)例，ARMS會(huì)默認(rèn)寫(xiě)入如下實(shí)例標(biāo)簽：

除了默認(rèn)實(shí)例標(biāo)簽外，您還可以添加自定義實(shí)例標(biāo)簽。同時(shí)，實(shí)例標(biāo)簽還會(huì)完整地繼承應(yīng)用標(biāo)簽，ARMS為應(yīng)用實(shí)例產(chǎn)生的監(jiān)控?cái)?shù)據(jù)中，都會(huì)帶上對(duì)應(yīng)的實(shí)例標(biāo)簽。

示例：

如下圖所示，應(yīng)用my-app包含兩個(gè)實(shí)例，ARMS為實(shí)例B生成的指標(biāo)數(shù)據(jù)中包含的標(biāo)簽為{env: Dev, team: Observability, app: my-app, workloadKind: Deployment, workloadName: my-app, clusterName: ClusterA, namespace: nsA, gitVersion: 1.0.2}。

添加自定義實(shí)例標(biāo)簽

為部署在Kubernetes集群中的應(yīng)用添加自定義實(shí)例標(biāo)簽

方式一（推薦）：通過(guò)Pod Label方式注入自定義實(shí)例標(biāo)簽

對(duì)于部署在Kubernetes環(huán)境中自動(dòng)安裝ARMS探針的應(yīng)用，可以通過(guò)Pod Label添加自定義實(shí)例標(biāo)簽。

以部署在ACK環(huán)境中的應(yīng)用為例：

在容器服務(wù)管理控制臺(tái)目標(biāo)集群下的無(wú)狀態(tài)或有狀態(tài)頁(yè)面頂部選擇目標(biāo)命名空間，然后在目標(biāo)應(yīng)用右側(cè)選擇更多 > 查看Yaml，在編輯YAML對(duì)話(huà)框中添加自定義標(biāo)簽后單擊更新。應(yīng)用實(shí)例將觸發(fā)重啟，并加入新的實(shí)例標(biāo)簽。

方式二：通過(guò)Pod環(huán)境變量方式注入自定義實(shí)例標(biāo)簽

對(duì)于某些pod創(chuàng)建后才能獲取到的自定義標(biāo)簽（如podName），您可以通過(guò)在應(yīng)用容器的啟動(dòng)腳本中增加操作系統(tǒng)環(huán)境變量來(lái)實(shí)現(xiàn)自定義實(shí)例標(biāo)簽的注入，具體方式如下：

1. 為您的應(yīng)用容器增加一個(gè)名為ARMS_HOST_TAGS的環(huán)境變量，值為您的實(shí)例標(biāo)簽，多個(gè)標(biāo)簽之間使用key1:value1&key2:value2的格式輸入，例如：?export ARMS_HOST_TAGS="gitVersion:1.0.2&ip:192.168.1.101"。

2. 在環(huán)境變量生效后，再啟動(dòng)應(yīng)用進(jìn)程。

為手動(dòng)安裝探針的應(yīng)用添加自定義實(shí)例標(biāo)簽

#export PROFILER_TAGS_CUSTOMTAGS=key1:value1
export PROFILER_TAGS_CUSTOMTAGS=gitVersion:1.0.2

K8s環(huán)境下通過(guò)Pod Label注入應(yīng)用標(biāo)簽

如果Pod Label帶有app.customAppKey.前綴，則會(huì)被識(shí)別為應(yīng)用標(biāo)簽，而不是實(shí)例標(biāo)簽。

例如以下代碼，ARMS會(huì)為這個(gè)工作負(fù)載接入的應(yīng)用加上應(yīng)用標(biāo)簽env: dev。

  template:
    metadata:
      labels:
        app.customAppKey.env: dev
        app: mall-gateway
        armsPilotAutoEnable: 'on'
        aliyun.com/app-language: golang  # Go應(yīng)用必填，標(biāo)明此應(yīng)用是Go應(yīng)用。Java應(yīng)用無(wú)需設(shè)置。
        armsPilotCreateAppName: mall-gateway

使用應(yīng)用標(biāo)簽

應(yīng)用篩選

在ARMS應(yīng)用列表，以及創(chuàng)建告警規(guī)則等功能中，可以基于應(yīng)用標(biāo)簽快捷篩選應(yīng)用。

基于標(biāo)簽的權(quán)限管理

基于應(yīng)用標(biāo)簽管理RAM權(quán)限，具體操作，請(qǐng)參見(jiàn)應(yīng)用監(jiān)控自定義RAM授權(quán)策略。

使用實(shí)例標(biāo)簽

在應(yīng)用詳情中根據(jù)實(shí)例標(biāo)簽過(guò)濾監(jiān)控?cái)?shù)據(jù)

1. 登錄ARMS控制臺(tái)，在左側(cè)導(dǎo)航欄選擇應(yīng)用監(jiān)控 > 應(yīng)用列表。

2. 在應(yīng)用列表頁(yè)面頂部選擇目標(biāo)地域，然后單擊目標(biāo)應(yīng)用名稱(chēng)。

   說(shuō)明

   語(yǔ)言列的圖標(biāo)含義如下：

   ：接入應(yīng)用監(jiān)控的Java應(yīng)用。

   ：接入應(yīng)用監(jiān)控的Golang應(yīng)用。

   ：接入應(yīng)用監(jiān)控的Python應(yīng)用。

   -：接入可觀測(cè)鏈路 OpenTelemetry 版的應(yīng)用。

3. 在應(yīng)用詳情的多個(gè)頁(yè)面中，都可以根據(jù)實(shí)例標(biāo)簽過(guò)濾監(jiān)控?cái)?shù)據(jù)，例如根據(jù)鏡像版本號(hào)進(jìn)行對(duì)比分析。

在Grafana視圖頁(yè)面通過(guò)標(biāo)簽查詢(xún)監(jiān)控指標(biāo)

1. 登錄ARMS控制臺(tái)，在左側(cè)導(dǎo)航欄選擇應(yīng)用監(jiān)控 > 應(yīng)用列表。

2. 在應(yīng)用列表頁(yè)面頂部選擇目標(biāo)地域，然后單擊目標(biāo)應(yīng)用名稱(chēng)。

   說(shuō)明

   語(yǔ)言列的圖標(biāo)含義如下：

   ：接入應(yīng)用監(jiān)控的Java應(yīng)用。

   ：接入應(yīng)用監(jiān)控的Golang應(yīng)用。

   ：接入應(yīng)用監(jiān)控的Python應(yīng)用。

   -：接入可觀測(cè)鏈路 OpenTelemetry 版的應(yīng)用。

3. 在左側(cè)導(dǎo)航欄單擊Grafana視圖，在右側(cè)頁(yè)面頂部選擇不同的標(biāo)簽，查看對(duì)應(yīng)的監(jiān)控指標(biāo)。