Outils pour migrer de l’agent Log Analytics vers Azure Monitor Agent

  • Article

L’agent Azure Monitor (AMA) remplace l’agent Log Analytics (également appelé MMA et OMS) pour les machines Windows et Linux, dans les environnements Azure et non Azure (locaux et clouds de tiers). Les avantages de la migration vers l’agent Azure Monitor incluent la sécurité renforcée, la rentabilité, les performances, la facilité de gestion et la fiabilité. Cet article explique comment utiliser les outils d’assistance de migration AMA et de générateur de configuration DCR pour automatiser et suivre la migration de l’agent Log Analytics vers l’agent Azure Monitor.

Flow diagram that shows the steps involved in agent migration and how the migration tools help in generating DCRs and tracking the entire migration process.

Important

Ne supprimez pas les anciens agents s’ils sont utilisés par d’autres solutions ou services Azure. Utilisez l’application d’assistance pour la migration pour découvrir les solutions et services que vous utilisez aujourd’hui.

Important

L’agent Log Analytics hérité sera déconseillé d’ici août 2024. Passé cette date, Microsoft ne fournira plus de support pour l’agent Log Analytics. Migrez vers l’agent Azure Monitor avant août 2024 pour continuer à ingérer des données.

Utilisation de l’application d’assistance pour la migration AMA

L’outil d’assistance de migration AMA est une solution Azure Monitor basée sur un classeur qui vous aide à découvrir ce qu’il faut migrer et à suivre la progression à mesure que vous passez de l’agent Log Analytics à l’agent Azure Monitor. Utilisez cette vue de volet unique pour accélérer et suivre l’état de votre parcours de migration de l’agent. L’assistance prend désormais en charge plusieurs abonnements. Il inclut des recommandations de migration automatique en fonction de l’utilisation.

Vous pouvez accéder au classeur ici ou le trouver sur le portail Azure sous Surveillance>Classeurs>Modèles publics>Azure Monitor essentials>AMA Migration Helper.

Screenshot of the Azure Monitor Agent Migration Helper workbook. The screenshot highlights the Subscription and Workspace dropdowns and shows the Azure Virtual Machines tab, on which you can track which agent is deployed on each virtual machine.

Recommandations de migration automatique

Screenshot of the Azure Monitor Agent Migration Helper workbook. The screenshot highlights the automatic migration recommendations based on sample usage across machines within selected scope.

Installation et utilisation du générateur de configuration DCR

L’agent Azure Monitor s’appuie uniquement sur les règles de collecte de données (DCR) pour la configuration, tandis que l’agent Log Analytics hérite sa configuration des espaces de travail Log Analytics.

Utilisez l’outil générateur de configuration DCR pour analyser la configuration de l’agent Log Analytics à partir de vos espaces de travail et générer/déployer automatiquement des règles de collecte de données correspondantes. Vous pouvez ensuite associer les règles aux machines exécutant le nouvel agent à l’aide de stratégies d’association intégrées.

Notes

Le générateur de configuration DCR ne prend pas actuellement en charge la configuration supplémentaire pour les solutions ou services Azure dépendants de l’agent Log Analytics.

Prérequis\Configuration requise

  1. Powershell version 7.1.3 ou version ultérieure est recommandée (version minimale 5.1)
  2. Utilisations Az Powershell module pour extraire les informations de configuration de l’agent d’espace de travail Az PowerShell
  3. L’utilisateur a besoin d’un accès en lecture/écriture à la ressource d’espace de travail spécifiée
  4. Connecter-AzAccount et Select-AzSubscription seront utilisés pour définir le contexte du script à exécuter afin que les informations d’identification Azure appropriées soient nécessaires.

Pour installer le générateur de configuration DCR :

  1. Téléchargez le script PowerShell.

  2. Exécutez le script à l’aide des exemples de paramètres ci-dessous :

     .\WorkspaceConfigToDCRMigrationTool.ps1 -SubscriptionId $subId -ResourceGroupName $rgName -WorkspaceName $workspaceName -DCRName $dcrName -OutputFolder $outputFolderPath
    Nom Obligatoire Description
    SubscriptionId OUI Il s’agit de l’ID d’abonnement de l’espace de travail
    ResourceGroupName OUI Il s’agit du groupe de ressources de l’espace de travail
    WorkspaceName OUI Il s’agit du nom de l’espace de travail (les ID de ressource Azure ne respectent pas la casse)
    DCRName OUI Nom de base qui sera utilisé pour chacun des contrôleurs de domaine de sortie
    OutputFolder NO Chemin du dossier de sortie. S’il n’est pas fourni, le chemin d’accès au répertoire de travail est utilisé

  3. Sorties :

    Pour chaque élément pris en charge DCR type, le script produit un modèle ARM DCR (prêt à être déployé) et une charge utile DCR (pour les utilisateurs qui n’ont pas besoin du modèle ARM). Voici la liste des types DCR actuellement pris en charge :

    • Windows contient et ne contient WindowsPerfCounters que des WindowsEventLogs sources de données
    • Linux contient et ne contient LinuxPerfCounters que des Syslog sources de données
    • Les journaux personnalisés contiennent logFiles uniquement des sources de données :
      • Chaque journal personnalisé obtient son propre modèle ARM DCR
    • Les journaux IIS contiennent uniquement des iisLogs sources de données
    • Les extensions contiennent extensions des sources de données uniquement avec toutes les sources de données perfCounters associées
      • VMInsights - Si vous souhaitez ajouter la prise en charge d’un nouveau type d’extension, contactez-nous.

  4. Déployez les modèles ARM générés :

    Portail

    • Dans le menu du Portail Azure, dans la zone de recherche, tapez modèle, puis sélectionnez Déployer un modèle personnalisé.

      Screenshot of the Deploy custom template screen.

    • Sélectionnez Générer votre propre modèle dans l’éditeur.

      Screenshot of the template editor.

    • Collez ce modèle généré dans l’éditeur, puis sélectionnez Enregistrer.

    • Dans l’écran Déploiement personnalisé, spécifiez un abonnement, un groupe de ressources et une région.

    • Sélectionnez Vérifier + créer>Créer.

    PowerShell

     New-AzResourceGroupDeployment -ResourceGroupName <resource-group-name> -TemplateFile <path-to-template>

    Remarque

    Vous pouvez inclure jusqu’à 100 « counterSpecifiers » dans une règle de collecte de données. « samplingFrequencyInSeconds » doit être compris entre 1 et 300, inclus.

  5. Associez des machines à vos règles de collecte de données :

    1. Dans le menu Monitor, sélectionnez Règles de collecte des données.
    2. Dans le menu Règles de collecte de données, sélectionnez votre règle de collecte de données.
    3. Sélectionnez Afficher les ressources>Ajouter.
    4. Sélectionnez vos machines >Appliquer.