Partager via

Gérer l’agent Container Insights

Container Insights utilise une version conteneurisée de l’agent Log Analytics pour Linux. Après le déploiement initial, vous devrez peut-être effectuer des tâches de routine ou facultatives pendant son cycle de vie. Cet article explique comment mettre à niveau l’agent manuellement et comment désactiver la collecte des variables d’environnement à partir d’un conteneur donné.

Avertissement

À compter du 1er octobre 2025, le flux de travail d’intégration basé sur les graphiques HELM pour l’agent Container Insights sera mis hors service. Pour vous assurer que vos clusters sont sécurisés et fonctionnent correctement, migrez vers l’extension Azure Arc Kubernetes Container Insights. Vous devez connecter votre cluster à Azure Arc pour Kubernetes , puis activer Container Insights via l’extension Kubernetes Azure Arc.   En savoir plus sur la retraite.  

Remarque

Si vous avez déjà déployé un cluster AKS et activé la supervision avec l’interface Azure CLI ou un modèle Resource Manager, vous ne pouvez pas utiliser kubectl pour mettre à niveau, supprimer, redéployer ou déployer l’agent. Le modèle doit être déployé dans le même groupe de ressources que le cluster.

Mettre à niveau l’agent Container Insights

Container Insights utilise une version conteneurisée de l’agent Log Analytics pour Linux. Lorsqu’une nouvelle version de l’agent est disponible, celui-ci est automatiquement mis à niveau sur vos clusters Kubernetes managés sur Azure Kubernetes Service (AKS) et Kubernetes avec Azure Arc.

Si la mise à niveau de l’agent sur un cluster managé sur AKS échoue, cet article décrit également le processus permettant de mettre à niveau l’agent manuellement. Pour suivre les versions publiées, consultez Annonces concernant les versions de l’agent.

Mettre à niveau l’agent sur un cluster AKS

Le processus de mise à niveau de l’agent sur un cluster AKS se compose de deux étapes. La première étape consiste à désactiver la surveillance avec Container Insights à l’aide de l’interface de ligne de commande Azure. Suivez les étapes décrites dans l’article Désactiver Container Insights sur votre cluster Kubernetes. En utilisant l’Azure CLI, vous pouvez retirer l'agent des nœuds du cluster sans affecter la solution et les données correspondantes qui sont stockées dans l'espace de travail.

Remarque

Pendant que vous effectuez cette activité de maintenance, les nœuds du cluster ne transfèrent pas les données collectées. Les vues performances n’affichent pas les données entre le moment où vous avez supprimé l’agent et installé la nouvelle version.

La deuxième étape consiste à installer la nouvelle version de l’agent. Suivez les étapes décrites dans Activer la supervision à l’aide d’Azure CLI pour terminer ce processus.

Après l’activation de la surveillance, un délai d’environ 15 minutes peut être nécessaire pour afficher les métriques d’intégrité mises à jour pour le cluster. Vous disposez de deux méthodes pour vérifier que l’agent a été correctement mis à niveau :

  • Exécutez la commande kubectl get pod <ama-logs-agent-pod-name> -n kube-system -o=jsonpath='{.spec.containers[0].image}'. Dans le statut retourné, notez la valeur sous Image pour l’agent Azure Monitor, dans la section Containers du résultat.
  • Sous l’onglet Nœuds, sélectionnez le nœud de cluster. Dans le volet Propriétés à droite, notez la valeur sous Étiquette d'image d'agent.

La version de l’agent indiquée doit correspondre à la version la plus récente répertoriée sur la page Historique de version.

Mettre à niveau l’agent sur un cluster Kubernetes hybride (déconseillé)

Procédez comme suit pour mettre à niveau l’agent sur un cluster Kubernetes s’exécutant sur :

  • Des clusters Kubernetes automanagés hébergés sur Azure à l’aide du moteur AKS.
  • Des clusters Kubernetes automanagés hébergés sur Azure Stack ou localement à l’aide du moteur AKS.

Si l’espace de travail Log Analytics se trouve dans un cloud commercial Azure, exécutez la commande suivante :

$ helm upgrade --set omsagent.secret.wsid=<your_workspace_id>,omsagent.secret.key=<your_workspace_key>,omsagent.env.clusterName=<my_prod_cluster> incubator/azuremonitor-containers

Si l’espace de travail Log Analytics se trouve dans Microsoft Azure géré par 21Vianett, exécutez la commande suivante :

$ helm upgrade --set omsagent.domain=opinsights.azure.cn,omsagent.secret.wsid=<your_workspace_id>,omsagent.secret.key=<your_workspace_key>,omsagent.env.clusterName=<your_cluster_name> incubator/azuremonitor-containers

Si l’espace de travail Log Analytics se trouve dans Azure US Government, exécutez la commande suivante :

$ helm upgrade --set omsagent.domain=opinsights.azure.us,omsagent.secret.wsid=<your_workspace_id>,omsagent.secret.key=<your_workspace_key>,omsagent.env.clusterName=<your_cluster_name> incubator/azuremonitor-containers

Désactiver la collecte des variables d’environnement sur un conteneur

Container Insights collecte des variables d’environnement à partir de conteneurs exécutés dans un pod, puis les présente dans le volet des propriétés du conteneur sélectionné dans la vue Conteneurs. Vous pouvez contrôler ce comportement en désactivant la collecte pour un conteneur spécifique, soit pendant le déploiement du cluster Kubernetes, soit après le déploiement en définissant la variable d’environnement AZMON_COLLECT_ENV. Cette fonctionnalité est disponible avec l’agent ciprod11292018 et versions ultérieures.

Pour désactiver la collecte des variables d’environnement sur un nouveau conteneur ou sur un conteneur existant, définissez la variable AZMON_COLLECT_ENV avec la valeur False dans votre fichier de configuration YAML pour le déploiement de Kubernetes.

- name: AZMON_COLLECT_ENV  
  value: "False"

Pour appliquer la modification aux clusters Kubernetes autres qu’Azure Red Hat OpenShift, exécutez cette commande : kubectl apply -f <path to yaml file>. Pour modifier ConfigMap et appliquer cette modification aux clusters Azure Red Hat OpenShift, exécutez la commande suivante :

oc edit configmaps container-azm-ms-agentconfig -n openshift-azure-logging

Cette commande ouvre votre éditeur de texte par défaut. Définissez la variable, puis enregistrez le fichier dans l’éditeur.

Pour vérifier que le changement de configuration est effectif, sélectionnez un conteneur dans l’affichage Conteneurs de Insights de conteneur. Dans le volet de propriétés, développez Variables d’environnement. La section doit afficher uniquement la variable créée précédemment, qui est AZMON_COLLECT_ENV=FALSE. Pour tous les autres conteneurs, la section des variables d’environnement doit répertorier toutes les variables d’environnement détectées.

Pour réactiver la découverte des variables environnementales, appliquez le même processus que celui que vous avez utilisé précédemment et remplacez la valeur Falsepar True. Réexécutez ensuite la kubectl commande pour mettre à jour le conteneur.

- name: AZMON_COLLECT_ENV  
  value: "True"

Mise à jour de version sémantique de la version de l’agent Container Insights

Container Insights a remplacé la version de l’image et la convention d’affectation de noms par [semver format] (https://semver.org/). SemVer aide les développeurs à suivre chaque modification apportée au logiciel pendant sa phase de développement et garantit que le contrôle de version du logiciel est cohérent et significatif. L’ancienne version était au format ciprod<timestamp>-<commitId> et win-ciprod<timestamp>-<commitId>, nos premières versions d’image utilisant le format Semver sont 3.1.4 pour Linux et win-3.1.4 pour Windows.

SemVer est un schéma de contrôle de version de logiciel universel défini au format MAJOR.MINOR.PATCH, qui présente les contraintes suivantes :

  1. Incrémentez la version MAJOR lorsque vous apportez des modifications d’API incompatibles.
  2. Incrémentez la version MINEURE lorsque vous ajoutez des fonctionnalités de manière rétrocompatible.
  3. Incrémentez la version de PATCH lorsque vous apportez des correctifs de bogues rétrocompatibles.

Avec l’essor de Kubernetes et de l’écosystème OSS, Container Insights migre pour utiliser l’image semver en suivant le standard recommandé K8s selon lequel avec chaque version mineure introduite, tous les changements cassants doivent être documentés publiquement avec chaque nouvelle version de Kubernetes.

Réparer des agents dupliqués ou obsolètes sur un cluster AKS ou Azure Arc Kubernetes

Si vous avez activé manuellement Container Insights à l’aide de méthodes personnalisées telles que HELM ou yaml, vous pouvez avoir plusieurs versions de l’agent ou une ancienne version de l’agent qui n’est pas mise à jour automatiquement. Suivez les étapes ci-dessous pour vous assurer que votre cluster reste sécurisé et continue de recevoir toutes les mises à jour de sécurité et de qualité critiques pour l’agent.

  1. Rassemblez les détails de tous les paramètres personnalisés, comme la mémoire et les limites du processeur sur vos conteneurs omsagent.

  2. Vérifiez les limites de ressources par défaut pour ama-logs et déterminez si elles répondent à vos besoins. Si ce n’est pas le cas, vous devrez peut-être créer une rubrique de support pour vous aider à examiner et à désactiver les limites de mémoire ou de processeur. Cela peut aider à résoudre les problèmes de limites de mise à l’échelle qu’ont rencontrés certains clients, et qui ont entraîné des exceptions OOMKilled.

    Système d’exploitation Nom du contrôleur Limites par défaut
    Linux ds-cpu-limit-linux 500 m
    Linux ds-memory-limit-linux 750Mi
    Linux rs-cpu-limit 1
    Linux rs-memory-limit 1,5 Gi
    Fenêtres ds-cpu-limit-windows 500 m
    Fenêtres ds-memory-limit-windows 1Gi

  3. Nettoyez les ressources de l’intégration précédente :

    Si vous avez déjà intégré à l’aide du graphique Helm :

    Répertoriez toutes les versions entre les espaces de noms avec la commande suivante :

     helm list --all-namespaces

    Nettoyez le graphique installé pour Container Insights avec la commande suivante :

    helm uninstall <releaseName> --namespace <Namespace>

    Si vous avez déjà intégré à l’aide du déploiement yaml :

    Téléchargez le fichier yaml de déploiement personnalisé précédent avec la commande suivante :

    curl -LO raw.githubusercontent.com/microsoft/Docker-Provider/ci_dev/kubernetes/omsagent.yaml

    Nettoyez l’ancien graphique omsagent avec la commande suivante :

    kubectl delete -f omsagent.yaml

  4. Désactivez Container Insights pour nettoyer toutes les ressources associées à l’aide de l’aide de Désactiver Container Insights sur votre cluster Kubernetes

  5. Réintégrez Container Insights en utilisant les instructions de Activer Container Insights sur votre cluster Kubernetes

Étapes suivantes

Si vous rencontrez des problèmes lors de la mise à niveau de l'agent, consultez le guide de résolution des problèmes.