应用实时监控服务ARMS：通用Kubernetes环境自动安装Golang探针

步骤一：编译Golang应用镜像

使用 ARMS Go 应用监控时，仅需在编译时使用 instgo 工具，在原有的 go build 命令前添加 instgo 前缀即可完成探针注入。业务代码本身无需任何改动，也不需要额外集成 OpenTelemetry SDK。instgo 探针已基于 OpenTelemetry 标准实现自动化埋点，编译时自动在 AST 语法树分析阶段插入监控代码。

步骤二：安装Helm3

步骤三：安装探针

ARMS应用监控目前仅支持无状态（Deployment）和有状态（StatefulSet）两种类型的应用接入，两种类型的应用接入方法相同。此处以将Kubernetes环境中的无状态（Deployment）类型的应用接入ARMS应用监控为例。

1. 执行以下wget命令下载ack-onepilot安装包。

    wget 'https://aliacs-app-catalog.oss-cn-hangzhou.aliyuncs.com/charts-incubator/ack-onepilot-5.1.1.tgz'

2. 执行以下命令解压ack-onepilot安装包。

   tar xvf ack-onepilot-5.1.1.tgz                 

3. 编辑安装包下的values.yaml文件，根据实际情况修改以下参数，然后保存。

   registry: registry-__ACK_REGION_ID__.ack.aliyuncs.com/acs/
   cluster_id: __ACK_CLUSTER_ID__
   accessKey: __ACCESSKEY__
   accessKeySecret: __ACCESSKEY_SECRET__
   uid: "__ACK_UID__"
   region_id: __ACK_REGION_ID__

   • registry：ack-onepilot镜像地址。

   • cluster_id：自定义Kubernetes集群ID，集群的唯一标识。建议格式为<uid>-<clusterid>。

   • accessKey和accessKeySecret：阿里云账号（主账号）的AccessKey ID和AccessKey Secret。获取方法，请参见创建AccessKey。

     重要

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

   • uid：阿里云账号（主账号）ID。将鼠标悬浮于阿里云控制台右上角的头像上可以获取。

   • region_id：阿里云地域ID，应用监控支持的地域，请参见开服地域。

4. 执行以下命令安装ack-onepilot。

   请在ack-onepilot安装包外执行此命令。

   helm3 upgrade --install ack-onepilot ack-onepilot --namespace ack-onepilot --create-namespace

步骤四：修改应用的YAML文件

1. 执行以下命令查看目标无状态（Deployment）应用的YAML文件。

   kubectl get deployment {deployment名称} -o yaml                            

   说明

   若您不清楚{deployment名称}，请先执行以下命令查看所有无状态（Deployment）应用，在执行结果中找到目标无状态（Deployment）应用，再查看目标无状态（Deployment）应用的YAML文件。

   kubectl get deployments --all-namespaces                

2. 编辑目标无状态（Deployment）应用的YAML文件。

   kubectl edit deployment {Deployment名称} -o yaml                        

3. 在YAML文件中的spec.template.metadata层级下添加以下内容。

   labels:
     aliyun.com/app-language: "golang" # Go应用必填，标明此应用是Go应用。
     armsPilotAutoEnable: "on"
     armsPilotCreateAppName: "<your-deployment-name>"    #请将<your-deployment-name>替换为您的应用名称。

   如果您需要在K8s环境中创建一个新的无状态（Deployment）应用并接入ARMS，则应用的完整YAML文件如下：

   展开查看完整示例YAML文件（Golang）

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     labels:
       app: otel-go-client
     name: otel-go-client
     namespace: default
   spec:
     progressDeadlineSeconds: 600
     replicas: 1
     revisionHistoryLimit: 10
     selector:
       matchLabels:
         app: otel-go-client
     strategy:
       rollingUpdate:
         maxSurge: 25%
         maxUnavailable: 25%
       type: RollingUpdate
     template:
       metadata:
         labels:
           aliyun.com/app-language: golang
           armsPilotAutoEnable: 'on'
           armsPilotCreateAppName: otel-go-client
           app: otel-go-client
       spec:
         containers:
           - image: registry.cn-hangzhou.aliyuncs.com/private-mesh/hellob:otel-client-arms-go-test-0.0.1
             imagePullPolicy: Always
             name: client
             resources:
               requests:
                 cpu: 250m
                 memory: 300Mi
             terminationMessagePath: /dev/termination-log
             terminationMessagePolicy: File
         dnsPolicy: ClusterFirst
         restartPolicy: Always
         schedulerName: default-scheduler
         securityContext: {}
         terminationGracePeriodSeconds: 30
   
   ---
   
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     labels:
       app: otel-go-server
     name: otel-go-server
     namespace: default
   spec:
     progressDeadlineSeconds: 600
     replicas: 1
     revisionHistoryLimit: 10
     selector:
       matchLabels:
         app: otel-go-server
     strategy:
       rollingUpdate:
         maxSurge: 25%
         maxUnavailable: 25%
       type: RollingUpdate
     template:
       metadata:
         labels:
           app: otel-go-server
           aliyun.com/app-language: golang
           armsPilotAutoEnable: 'on'
           armsPilotCreateAppName: otel-go-server
       spec:
         containers:
           - image: registry.cn-hangzhou.aliyuncs.com/private-mesh/hellob:otel-server-arms-go-test-0.0.1
             imagePullPolicy: Always
             name: server
             resources:
               requests:
                 cpu: 250m
                 memory: 300Mi
             terminationMessagePath: /dev/termination-log
             terminationMessagePolicy: File
         dnsPolicy: ClusterFirst
         restartPolicy: Always
         schedulerName: default-scheduler
         securityContext: {}
         terminationGracePeriodSeconds: 30
   
   ---
   
   apiVersion: v1
   kind: Service
   metadata:
     labels:
       app: otel-go-server
     name: otel-server
     namespace: default
   spec:
     internalTrafficPolicy: Cluster
     ipFamilies:
       - IPv4
     ipFamilyPolicy: SingleStack
     ports:
       - name: http
         port: 9000
         protocol: TCP
         targetPort: 9000
     selector:
       app: otel-go-server
     sessionAffinity: None
     type: ClusterIP

执行结果

约一分钟后，若Golang应用出现在ARMS控制台的应用监控 > 应用列表页面中且有数据上报，则说明接入成功。