前提條件

• 已開(kāi)通ARMS，具體操作，請(qǐng)參見(jiàn)開(kāi)通和升級(jí)ARMS。

• 創(chuàng)建Kubernetes集群。目前應(yīng)用監(jiān)控 eBPF 版僅支持接入ACK集群和注冊(cè)集群，各集群創(chuàng)建方法如下：

  • 創(chuàng)建ACK專有集群

  • 創(chuàng)建

  • 創(chuàng)建注冊(cè)集群

• 已確認(rèn)當(dāng)前環(huán)境支持應(yīng)用監(jiān)控 eBPF 版運(yùn)行。更多信息，請(qǐng)參見(jiàn)應(yīng)用監(jiān)控 eBPF 版運(yùn)行環(huán)境要求和限制。

接入說(shuō)明

為Kubernetes集群安裝應(yīng)用監(jiān)控 eBPF 版組件即可將集群接入應(yīng)用監(jiān)控 eBPF 版：

安裝前，需先檢查目標(biāo)集群是否存在ARMS Addon Token，否則會(huì)出現(xiàn)權(quán)限不足的報(bào)錯(cuò)。若存在ARMS Addon Token，ARMS會(huì)進(jìn)行免密授權(quán)，組件安裝完成后，即可使用應(yīng)用監(jiān)控 eBPF 版；若不存在ARMS Addon Token，則需要手動(dòng)添加ARMS和鏈路追蹤權(quán)限策略。查看ARMS Addon Token和手動(dòng)添加權(quán)限策略方法如下：

安裝應(yīng)用監(jiān)控 eBPF 版組件

為已有應(yīng)用安裝組件

如果您的應(yīng)用已安裝過(guò)應(yīng)用監(jiān)控 eBPF 版組件，請(qǐng)?jiān)?a id="b62fb4e073z71" class="ne-link" target="_blank">容器服務(wù)管理控制臺(tái)目標(biāo)集群下的運(yùn)維管理 > 組件管理頁(yè)面確認(rèn)ack-arms-cmonitor組件版本是否為4.0.0或以上，如果不是，請(qǐng)單擊升級(jí)將組件升級(jí)至最新版本。

1. 登錄容器服務(wù)管理控制臺(tái)，在集群列表頁(yè)面單擊目標(biāo)集群名稱。

2. 在左側(cè)導(dǎo)航欄，選擇運(yùn)維管理 > 集群拓?fù)?/b>。

3. 在集群拓?fù)漤?yè)面，單擊開(kāi)始安裝。ACK控制臺(tái)將會(huì)為您自動(dòng)安裝應(yīng)用監(jiān)控 eBPF 版組件。

   說(shuō)明

   命名空間默認(rèn)為arms-prom。

4. 如果是專有版集群，請(qǐng)更新AK/SK配置。

   1. 在左側(cè)導(dǎo)航欄，選擇應(yīng)用 > Helm。

   2. 在arms-cmonitor右側(cè)單擊更新，修改accessKey和accessKeySecret為阿里云賬號(hào)的AccessKey ID和AccessKey Secret。獲取方法，請(qǐng)參見(jiàn)獲取AccessKey。

      重要

      請(qǐng)確認(rèn)對(duì)應(yīng)的阿里云賬號(hào)已包含AliyunARMSFullAccess和AliyunSTSAssumeRoleAccess權(quán)限。

   3. 單擊確定。

新建應(yīng)用時(shí)安裝組件

1. 登錄容器服務(wù)管理控制臺(tái)，在集群列表頁(yè)面上的目標(biāo)集群右側(cè)操作列單擊應(yīng)用管理。

2. 在無(wú)狀態(tài)頁(yè)面單擊使用YAML創(chuàng)建資源。

3. 選擇示例模板，并在模板（YAML格式）中將以下labels添加到spec.template.metadata層級(jí)下。

   labels:
     armseBPFAutoEnable: "on"
     armseBPFCreateAppName: "<your-deployment-name>"    //請(qǐng)將<your-deployment-name>替換為您的應(yīng)用名稱。

   創(chuàng)建一個(gè)無(wú)狀態(tài)（Deployment）應(yīng)用并開(kāi)啟ARMS應(yīng)用監(jiān)控 eBPF 版的完整YAML示例模板如下：

   展開(kāi)查看完整示例YAML文件。

   apiVersion: v1
   kind: Namespace
   metadata:
     name: arms-demo
   ---
   apiVersion: apps/v1 # for versions before 1.8.0 use apps/v1beta1
   kind: Deployment
   metadata:
     name: arms-springboot-demo
     namespace: arms-demo
     labels:
       app: arms-springboot-demo
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: arms-springboot-demo
     template:
       metadata:
         labels:
           app: arms-springboot-demo
           armseBPFAutoEnable: "on"
           armseBPFCreateAppName: "arms-k8s-demo"
       spec:
         containers:
           - resources:
               limits:
                 cpu: 0.5
             image: registry.cn-hangzhou.aliyuncs.com/arms-docker-repo/arms-springboot-demo:v0.1
             imagePullPolicy: Always
             name: arms-springboot-demo
             env:
               - name: SELF_INVOKE_SWITCH
                 value: "true"
               - name: COMPONENT_HOST
                 value: "arms-demo-component"
               - name: COMPONENT_PORT
                 value: "6666"
               - name: MYSQL_SERVICE_HOST
                 value: "arms-demo-mysql"
               - name: MYSQL_SERVICE_PORT
                 value: "3306"
   ---
   apiVersion: apps/v1 # for versions before 1.8.0 use apps/v1beta1
   kind: Deployment
   metadata:
     name: arms-springboot-demo-subcomponent
     namespace: arms-demo
     labels:
       app: arms-springboot-demo-subcomponent
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: arms-springboot-demo-subcomponent
     template:
       metadata:
         labels:
           app: arms-springboot-demo-subcomponent
           armseBPFAutoEnable: "on"
           armseBPFCreateAppName: "arms-k8s-demo-subcomponent"
       spec:
         containers:
           - resources:
               limits:
                 cpu: 0.5
             image: registry.cn-hangzhou.aliyuncs.com/arms-docker-repo/arms-springboot-demo:v0.1
             imagePullPolicy: Always
             name: arms-springboot-demo-subcomponent
             env:
               - name: SELF_INVOKE_SWITCH
                 value: "false"
               - name: MYSQL_SERVICE_HOST
                 value: "arms-demo-mysql"
               - name: MYSQL_SERVICE_PORT
                 value: "3306"
   ---
   apiVersion: v1
   kind: Service
   metadata:
     labels:
       name: arms-demo-component
     name: arms-demo-component
     namespace: arms-demo
   spec:
     ports:
       # the port that this service should serve on
       - name: arms-demo-component-svc
         port: 6666
         targetPort: 8888
     # label keys and values that must match in order to receive traffic for this service
     selector:
       app: arms-springboot-demo-subcomponent
   ---
   apiVersion: apps/v1 # for versions before 1.8.0 use apps/v1beta1
   kind: Deployment
   metadata:
     name: arms-demo-mysql
     namespace: arms-demo
     labels:
       app: mysql
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: mysql
     template:
       metadata:
         labels:
           app: mysql
       spec:
         containers:
           - resources:
               limits:
                 cpu: 0.5
             image: registry.cn-hangzhou.aliyuncs.com/arms-docker-repo/arms-demo-mysql:v0.1
             name: mysql
             ports:
               - containerPort: 3306
                 name: mysql
   ---
   apiVersion: v1
   kind: Service
   metadata:
     labels:
       name: mysql
     name: arms-demo-mysql
     namespace: arms-demo
   spec:
     ports:
       # the port that this service should serve on
       - name: arms-mysql-svc
         port: 3306
         targetPort: 3306
     # label keys and values that must match in order to receive traffic for this service
     selector:
       app: mysql
   --