Application Real-Time Monitoring Service:Instalação automática do probe Go no Kubernetes

Pré-requisitos

• O componente kube-apiserver no seu cluster Kubernetes deve ser a versão 1.10 ou posterior.

• Se o seu cluster Kubernetes não estiver implantado na Alibaba Cloud, ele deverá ter acesso à internet ou estar conectado a uma VPC da Alibaba Cloud, por exemplo, pela Cloud Enterprise Network (CEN).

• Sua aplicação Go deve ser a versão 1.18 ou posterior.

Etapa 1: Compile a imagem da aplicação Go

Para usar o monitoramento de aplicações Go do ARMS, basta usar a ferramenta instgo durante a compilação, adicionando instgo como prefixo ao comando go build original. Não é necessário modificar o código da aplicação nem integrar o sdk do OpenTelemetry. O agente instgo implementa a instrumentação automática com base no padrão OpenTelemetry e insere o código de monitoramento automaticamente durante a fase de análise AST na compilação.

Etapa 2: Agora instale o Helm 3

Agora instale o Helm 3 na máquina que você usa e gerencie o cluster Kubernetes. O agente ack-onepilot, que será instalado na Etapa 3, é distribuído como um chart do Helm. Portanto, o Helm 3 deve estar disponível antes de você continuar. Para obter instruções de instalação, consulte a documentação do Helm vinculada no título desta etapa.

Etapa 3: Agora instale o agente

O Application Real-Time Monitoring service (ARMS) oferece suporte apenas a aplicações stateless (Deployment) e stateful (StatefulSet). As etapas de integração são as mesmas para ambos os tipos. Este exemplo demonstra como conectar uma aplicação stateless (Deployment) no Kubernetes ao ARMS.

1. Use o comando wget a seguir e baixe o pacote de instalação do ack-onepilot.

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

2. Execute o comando abaixo para extrair o pacote de instalação do ack-onepilot.

   tar xvf ack-onepilot-5.1.1.tgz                 

3. Agora edite o arquivo values.yaml do pacote de instalação. Agora modifique os parâmetros a seguir de acordo com o seu ambiente e salve o arquivo.

   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: O registro de imagens do ack-onepilot.

   • cluster_id: Um ID de cluster personalizado que identifica exclusivamente o seu cluster Kubernetes. Recomendamos o formato <uid>-<clusterid>.

   • accessKey e accessKeySecret: O AccessKey ID e o AccessKey Secret da sua conta Alibaba Cloud (conta principal). Para obtê-los, consulte Create an AccessKey.

     Importante

     Certifique-se de que a conta principal tenha as permissões AliyunARMSFullAccess e AliyunSTSAssumeRoleAccess.

   • uid: O ID da sua conta Alibaba Cloud (conta principal). Para obtê-lo, passe o mouse sobre a foto de perfil no canto superior direito do console da Alibaba Cloud.

   • region_id: O ID da região da Alibaba Cloud. Para obter uma lista das regiões com suporte, consulte Available regions.

4. Agora execute o comando abaixo e instale o ack-onepilot.

   Execute este comando fora do diretório do pacote de instalação do ack-onepilot.

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

Etapa 4: Agora modifique o arquivo YAML do Deployment

1. Use o comando abaixo e visualize o arquivo YAML do Deployment de destino.

   kubectl get deployment {deployment-name} -o yaml                            

   Nota

   Se você não souber o {deployment-name}, execute o comando abaixo para listar todos os Deployments. Em seguida, encontre o nome do Deployment de destino na saída.

   kubectl get deployments --all-namespaces                

2. Agora edite o arquivo YAML do Deployment de destino.

   kubectl edit deployment {deployment-name} -o yaml                        

3. No arquivo YAML, adicione o seguinte conteúdo sob spec.template.metadata.

   labels:
     aliyun.com/app-language: "golang" # Required for Go applications.
     armsPilotAutoEnable: "on"
     armsPilotCreateAppName: "<your-deployment-name>"    # Replace <your-deployment-name> with your application name.

   Se você precisar, crie um novo Deployment no seu ambiente K8s e conectá-lo ao ARMS, use o arquivo YAML completo a seguir:

   Agora visualize o arquivo YAML de exemplo completo (Go)

   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

Resultado

A integração é bem-sucedida quando a aplicação Go aparece no console do ARMS em Application Monitoring > Application List e começa a reportar dados em aproximadamente um minuto.