手动接入应用至应用监控 eBPF 版

前提条件

• 已开通ARMS，具体操作，请参见开通和升级ARMS。

• 创建Kubernetes集群。目前应用监控 eBPF 版仅支持接入ACK集群和注册集群，各集群创建方法如下：

  • 创建Kubernetes专有版集群

  • 创建Kubernetes托管版集群

  • 通过控制台创建注册集群

• 已确认当前环境支持应用监控 eBPF 版运行。更多信息，请参见应用监控 eBPF 版运行环境要求和限制。

接入说明

为Kubernetes集群安装应用监控 eBPF 版组件即可将集群接入应用监控 eBPF 版：

安装前，需先检查目标集群是否存在ARMS Addon Token，否则会出现权限不足的报错。若存在ARMS Addon Token，ARMS会进行免密授权，组件安装完成后，即可使用应用监控 eBPF 版；若不存在ARMS Addon Token，则需要手动添加ARMS和链路追踪权限策略。查看ARMS Addon Token和手动添加权限策略方法如下：

安装应用监控 eBPF 版组件

为已有应用安装组件

如果您的应用已安装过应用监控 eBPF 版组件，请在容器服务管理控制台目标集群下的运维管理 > 组件管理页面确认ack-arms-cmonitor组件版本是否为4.0.0或以上，如果不是，请单击升级将组件升级至最新版本。

1. 登录容器服务管理控制台，在集群列表页面单击目标集群名称。

2. 在左侧导航栏，选择运维管理 > 集群拓扑。

3. 在集群拓扑页面，单击开始安装。ACK控制台将会为您自动安装应用监控 eBPF 版组件。

   说明

   命名空间默认为arms-prom。

4. 如果是专有版集群，请更新AK/SK配置。

   1. 在左侧导航栏，选择应用 > Helm。

   2. 在arms-cmonitor右侧单击更新，修改accessKey和accessKeySecret为阿里云账号的AccessKey ID和AccessKey Secret。获取方法，请参见获取AccessKey。

      重要

      请确认对应的阿里云账号已包含AliyunARMSFullAccess和AliyunSTSAssumeRoleAccess权限。

   3. 单击确定。

新建应用时安装组件

1. 登录容器服务管理控制台，在集群列表页面上的目标集群右侧操作列单击应用管理。

2. 在无状态页面右上角单击使用YAML创建资源。

3. 选择示例模板，并在模板（YAML格式）中将以下labels添加到spec.template.metadata层级下。

   labels:
     armseBPFAutoEnable: "on"
     armseBPFCreateAppName: "<your-deployment-name>"    //请将<your-deployment-name>替换为您的应用名称。

   创建一个无状态（Deployment）应用并开启ARMS应用监控 eBPF 版的完整YAML示例模板如下：

   展开查看完整示例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
   --