:Intégrer manuellement une application d'un cluster ACK à Application Monitoring eBPF Edition

Application Monitoring eBPF Edition d'Application Real-Time Monitoring Service (ARMS) est un service d'observabilité de bout en bout conçu pour les clusters Kubernetes. Installez manuellement l'agent ack-arms-cmonitor sur un cluster Kubernetes pour surveiller ses métriques, traces d'application, journaux et événements. Cette rubrique explique comment intégrer une application déployée dans un cluster Alibaba Cloud Container Service for Kubernetes (ACK) à Application Monitoring eBPF Edition.

Prérequis

• ARMS est activé. Pour plus d'informations, consultez la rubrique Activer ARMS.

• Un cluster ACK dédié, un cluster ACK géré ou un cluster enregistré est créé. Cette rubrique s'applique à ces types de clusters ACK. Pour savoir comment créer un cluster dans ACK, consultez les rubriques suivantes :

  • Créer un cluster ACK dédié (obsolète)

  • Créer un cluster ACK géré

  • Créer un cluster enregistré dans la console ACK

• L'environnement répond aux exigences de Application Monitoring eBPF Edition. Pour plus d'informations, consultez la rubrique Exigences et limitations relatives aux systèmes d'exploitation pour Application Monitoring eBPF Edition.

Remarques d'utilisation

Pour intégrer une application déployée dans un cluster ACK à Application Monitoring eBPF Edition, installez l'agent ack-arms-cmonitor sur le cluster Kubernetes afin de surveiller les métriques.

Avant l'installation, vérifiez si le cluster dispose du jeton ARMS Addon Token. Sans ce jeton, vous ne disposerez pas des autorisations suffisantes pour effectuer les opérations suivantes. Si le jeton ARMS Addon Token existe, vous êtes autorisé et pouvez installer l'agent ack-arms-cmonitor sans mot de passe. Vous pourrez alors utiliser Application Monitoring eBPF Edition. Si le cluster ne possède pas de jeton ARMS Addon Token, attachez manuellement les stratégies ARMS et Managed Service for OpenTelemetry à votre rôle RAM de nœud de travail. Effectuez les opérations suivantes pour vérifier l'existence du jeton ARMS Addon Token et attacher les stratégies au rôle RAM de nœud de travail :

Installer l'agent ack-arms-cmonitor

Installer l'agent pour une application existante

Si l'agent ack-arms-cmonitor est déjà installé dans votre application, vérifiez si la version est 4.0.0 ou ultérieure. Connectez-vous à la console ACK, puis choisissez Operations > Add-ons dans le volet de navigation de gauche de la page des détails du cluster. Si la version est antérieure à 4.0.0, cliquez sur Upgrade pour mettre à niveau l'agent vers la dernière version. Pour installer l'agent ack-arms-cmonitor, procédez comme suit :

1. Connectez-vous à la console ACK. Dans le volet de navigation de gauche, cliquez sur Clusters. Sur la page Clusters, cliquez sur le nom du cluster.

2. Dans le volet de navigation de gauche, choisissez Operations > Cluster Topology.

3. Sur la page Cluster Topology, cliquez sur Install. La console ACK installe automatiquement l'agent.

   Remarque

   Le namespace par défaut est arms-prom.

4. Si vous utilisez un cluster ACK dédié, mettez à jour la paire de clés AccessKey.

   1. Dans le volet de navigation de gauche, choisissez Applications > Helm.

   2. Recherchez arms-cmonitor et cliquez sur Update. Définissez les paramètres accessKey et accessKeySecret avec l'ID de clé AccessKey et la clé secrète de votre compte Alibaba Cloud. Pour plus d'informations, consultez la rubrique Obtenir la paire de clés AccessKey du centre principal.

      Important

      Assurez-vous que les stratégies AliyunARMSFullAccess et AliyunSTSAssumeRoleAccess sont attachées à votre compte Alibaba Cloud.

   3. Cliquez sur OK.

Installer l'agent lors de la création d'une application

1. Connectez-vous à la console ACK. Sur la page Clusters, recherchez le cluster et cliquez sur Applications dans la colonne Actions.

2. Sur la page Deployments, cliquez sur Create from YAML.

3. Sélectionnez un modèle dans la liste déroulante Sample Template et ajoutez les labels suivants au répertoire spec.template.metadata du modèle YAML.

   labels:
     armseBPFAutoEnable: "on"
     armseBPFCreateAppName: "<your-deployment-name>"    # Replace <your-deployment-name> with the application name.

   Le modèle YAML suivant montre comment créer un Deployment et activer Application Monitoring eBPF Edition :

   Afficher le modèle 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