Share via

Mettre à niveau des agents d’ingestion Azure Operator Insights

  • Article

L’agent d’ingestion est un package logiciel installé sur une machine virtuelle Linux détenue et gérée par vous. Vous devrez peut-être mettre à niveau l’agent.

Cet article explique comment mettre à niveau votre agent d’ingestion et restaurer une mise à niveau.

Prérequis

Décidez de la version d’agent d’ingestion vers laquelle vous souhaitez effectuer une mise à niveau. Si vous ne spécifiez aucune version lorsque vous mettez à niveau, vous effectuez une mise à niveau vers la version la plus récente.

Consultez Nouveautés de l’agent d’ingestion Azure Operator Insights pour consulter la liste des mises en production récentes et voir les nouveautés de chaque version. Si vous recherchez une version de l’agent datant de plus de six mois, consultez les archives des notes de publication.

Si vous souhaitez vérifier l’authenticité du package d’agent d’ingestion avant la mise à niveau, consultez Comment utiliser la clé de signature de référentiel GPG.

Mettre à niveau le logiciel de l’agent

Pour mettre à niveau l’agent vers une nouvelle version, répétez les étapes suivantes sur chaque machine virtuelle dotée de l’ancien agent.

  1. Connectez-vous à la machine virtuelle via SSH.
  2. Enregistrez une copie du fichier config /etc/az-aoi-ingestion/config.yaml existant.
  3. Mettez à niveau l’agent en utilisant le gestionnaire de package de votre machine virtuelle. Par exemple, pour les distributions Linux basées sur Red Hat : 
    sudo dnf upgrade az-aoi-ingestion
    Répondez y, lorsque vous y êtes invité.
    1. Vous pouvez également mettre à niveau vers une version spécifique de l’agent en spécifiant le numéro de version dans la commande. Par exemple, pour la version 2.0.0 sur un système RHEL8, utilisez la commande suivante :
    sudo dnf install az-aoi-ingestion-2.0.0
  4. Apportez toute modification au fichier de configuration décrite par votre contact au support ou la documentation relative à la nouvelle version. La plupart des mises à niveau ne nécessitent aucune modification de configuration.
  5. Redémarrez l’agent. 
    sudo systemctl restart az-aoi-ingestion.service
  6. Une fois l’agent en cours d’exécution, configurez le service az-aoi-ingestion pour redémarrer automatiquement. 
    sudo systemctl enable az-aoi-ingestion.service
  7. Vérifiez que l’agent est en cours d’exécution et qu’il copie des fichiers comme décrit dans Surveiller et dépanner les agents d’ingestion pour Azure Operator Insights.

Restaurer une mise à niveau

Si une mise à niveau ou une modification de configuration échoue :

  1. Passez à une version antérieure en réinstallant la version précédente de l’agent. Par exemple, pour passer à une version antérieure vers la version 1.0.0 sur un système RHEL8, utilisez la commande suivante : 
    sudo dnf downgrade az-aoi-ingestion-1.0.0
  2. Copiez le fichier config sauvegardé avant la modification du fichier /etc/az-aoi-ingestion/config.yaml.
  3. Redémarrez l’agent. 
    sudo systemctl restart az-aoi-ingestion.service
  4. Lorsque l’agent est en cours d’exécution, configurez le service az-aoi-ingestion pour redémarrer automatiquement. 
    sudo systemctl enable az-aoi-ingestion.service

Contenu connexe

Découvrez comment :