Partager via

Convertir la configuration de l’espace de travail en configurations DCR

  • Article

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

La configuration de l’espace de travail vers le générateur de configuration DCR est un PowerShell qui lit la configuration à partir des multiples modèles DCR produits par votre espace de travail, en fonction des configurations MMA présentes sur l’espace de travail.

Prérequis

  • PowerShell version 7.1.3 ou ultérieure est recommandé (version minimale 5.1)
  • Le module Az PowerShell pour extraire le module Az PowerShell des informations de configuration de l’agent d’espace de travail. Pour installer le module Az PowerShell, consultez Installer Azure PowerShell sur Windows
  • L’accès en lecture/écriture à la ressource d’espace de travail spécifiée

Installation et exécution

Téléchargez le script PowerShell depuis le hub Git.

Le script récupère la configuration des configurations de l’agent hérité à partir de l’espace de travail et génère des modèles ARM DCR pour chaque type DCR pris en charge dans le dossier de sortie spécifié. Plusieurs modèles peuvent être créés, un pour chaque type DCR.

Pour plusieurs espaces de travail avec des collectes de données configurées, vous devez exécuter le script pour chaque espace de travail. IIS journalise le script crée également un rôle de collecte de données supplémentaire dans le cadre de cette configuration.

Une fois le script terminé, il vous invite à tester le déploiement du modèle dans votre environnement. Choisissez de le laisser déployer le modèle pour vous ou de stocker le dossier de sortie spécifié par le modèle

Remarque

Le script n’associe pas les DCR à l’espace de travail. Vous devez créer vos propres associations de règles de collecte de données (DCRA) pour associer les DCR aux serveurs appropriés. Cela vous permet de contrôler le déploiement des DCR sur les serveurs et de tester les DCR sur un échantillon de serveurs avant de déployer à grande échelle.

Pour exécuter un script, copiez la commande suivante et remplacez les paramètres par vos valeurs :

	.\WorkspaceConfigToDCRMigrationTool.ps1 -SubscriptionId $subId -ResourceGroupName $rgName -WorkspaceName $workspaceName -DCRName $dcrName -OutputFolder $outputFolderPath

Paramètres de script

Nom Obligatoire Description
SubscriptionId OUI L’ID d’abonnement de l’espace de travail
ResourceGroupName OUI Le groupe de ressources de l’espace de travail
WorkspaceName OUI Le nom de l’espace de travail (les ID de ressource Azure ne respectent pas la casse)
DCRName OUI Le nom de base utilisé pour chacune des DCR de sortie
OutputFolder NO Chemin d’accès au dossier de sortie. S’il n’est pas fourni, le chemin d’accès au répertoire de travail est utilisé

Sorties :

  • Pour chaque DCR type pris en charge, 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.

Types DCR actuellement pris en charge :

  • Windows contient uniquement des sources de données WindowsPerfCounters et WindowsEventLogs
  • Linux contient uniquement des sources de données LinuxPerfCounters et Syslog
  • Les journaux personnalisés contiennent uniquement des sources de données logFiles
  • Les journaux IIS contiennent uniquement des sources de données iisLogs
  • Extension DependencyAgent
  • Les extensions contiennent uniquement des sources de données extensions avec toutes les sources de données perfCounters associées
    • VMInsights

Déploiement

Pour plus d’informations sur le déploiement des DCR, consultez les articles Règles de collecte de données dans Azure Monitor et Créer et modifier des règles de collecte de données (DCR) dans Azure Monitor

Avertissement

Vous ne devez pas utiliser une table de journal personnalisée existante utilisée par les agents MMA. Lorsque le premier agent AMA aura écrit dans la table, vos agents MMA ne pourront plus écrire dans cette table. Pour éviter la perte de données MMA, vous devez créer une nouvelle table pour que AMA puisse l’utiliser.

Étapes suivantes