Cet article décrit les différentes méthodes qui vous permettent d’installer, de désinstaller, de mettre à jour et de configurer l’agent Azure Monitor sur les machines virtuelles Azure, les groupes de machines virtuelles identiques et les serveurs avec Azure Arc.
Prérequis
Pour connaître les prérequis et autres exigences liés à l’utilisation de l’agent Azure Monitor, consultez les articles suivants :
Important
Vous n'avez pas besoin de redémarrer l'ordinateur lorsque vous installez, mettez à niveau ou désinstallez l'agent Azure Monitor.
Options d'installation
Le tableau suivant liste les options d’installation de l’agent Azure Monitor sur les machines virtuelles Azure et les serveurs avec Azure Arc.
Pour tout ordinateur qui n'est pas dans Azure, vous devez installer l'agent Azure Arc sur l'ordinateur avant de pouvoir installer l'agent Azure Monitor.
| Méthode d’installation |
Descriptif |
| Extension de machine virtuelle |
Utilisez l’une des méthodes décrites dans cet article pour installer l’agent via l’infrastructure d’extension Azure. Cette méthode ne crée pas de règle DCR. Vous devez donc créer au moins une règle DCR, et l’associer à l’agent avant le début de la collecte de données. |
|
Créer une DCR |
Quand vous créez une règle DCR dans le portail Azure, l’agent Azure Monitor est installé sur les machines ajoutées en tant que ressources de la règle DCR. L’agent commence immédiatement à collecter les données, tel que cela est défini dans la règle DCR. |
|
VM Insights |
Quand vous activez les insights de machine virtuelle sur une machine, l’agent Azure Monitor est installé, et une règle DCR est créée pour collecter un ensemble prédéfini de données. Vous ne devez pas modifier cette règle DCR, mais vous pouvez créer des règles DCR supplémentaires pour collecter davantage de données. |
|
Container Insights |
Lorsque vous activez la collecte des métriques Prometheus ou des journaux de conteneur sur un cluster Kubernetes, une version conteneurisée de l’agent Azure Monitor est installée dans le cluster et une DCR est créée pour commencer immédiatement à collecter des données. Vous pouvez modifier la règle DCR en suivant les conseils d’aide fournis dans Configurer la collecte de données et l’optimisation des coûts dans les insights de conteneur avec des règles DCR. |
|
Programme d’installation client |
Installez l’agent à l’aide d’un programme d’installation MSI Windows pour les clients Windows 11 et Windows 10. |
|
Azure Policy |
Utilisez Azure Policy pour installer automatiquement l’agent sur les machines virtuelles Azure et les serveurs avec Azure Arc ainsi que pour les associer automatiquement aux règles DCR nécessaires. |
Remarque
Pour envoyer des données entre locataires, vous devez d’abord activer Azure Lighthouse.
Le clonage d’une machine sur laquelle l’agent Azure Monitor est installé n’est pas pris en charge. La meilleure pratique pour ce scénario consiste à utiliser Azure Policy ou un outil IaC (infrastructure en tant que code) pour déployer l’agent Azure Monitor à grande échelle.
Installer l’extension de l’agent
Vous pouvez installer l’agent Azure Monitor sur une machine virtuelle Azure ou sur un serveur avec Azure Arc à l’aide de la commande PowerShell permettant d’ajouter une extension de machine virtuelle.
Machines virtuelles Azure
Utilisez les commandes PowerShell suivantes pour installer l’agent Azure Monitor sur une machine virtuelle Azure. Choisissez la commande appropriée en fonction de la méthode d’authentification utilisée.
Fenêtres
## User-assigned managed identity
Set-AzVMExtension -Name AzureMonitorWindowsAgent -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true -SettingString '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
## System-assigned managed identity
Set-AzVMExtension -Name AzureMonitorWindowsAgent -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true
Linux
## User-assigned managed identity
Set-AzVMExtension -Name AzureMonitorLinuxAgent -ExtensionType AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true -SettingString '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
## System-assigned managed identity
Set-AzVMExtension -Name AzureMonitorLinuxAgent -ExtensionType AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true
Groupe de machines virtuelles identiques Azure
Utilisez la cmdlet PowerShell Add-AzVmssExtension pour installer l’agent Azure Monitor sur un groupe de machines virtuelles identiques Azure.
Fenêtres
$vmss = Get-AzVmss -ResourceGroupName <resource-group-name> -VMScaleSetName <vmss-name>
Add-AzVmssExtension -VirtualMachineScaleSet $vmss -Name AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -Type AzureMonitorWindowsAgent -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true
Update-AzVmss -ResourceGroupName <resource-group-name> -VMScaleSetName <vmss-name> -VirtualMachineScaleSet $vmss
Linux
$vmss = Get-AzVmss -ResourceGroupName <resource-group-name> -VMScaleSetName <vmss-name>
Add-AzVmssExtension -VirtualMachineScaleSet $vmss -Name AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -Type AzureMonitorLinuxAgent -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true
Update-AzVmss -ResourceGroupName <resource-group-name> -VMScaleSetName <vmss-name> -VirtualMachineScaleSet $vmss
Remarque
Si vous définissez la stratégie de mise à niveau de votre groupe de machines virtuelles identiques sur Manuel, vous devez mettre à jour les instances existantes en exécutant Update-AzVmssInstance après avoir modifié le modèle VMSS. Pour les groupes de machines virtuelles identiques avec une stratégie de mise à niveau Automatique ou Progressif, l’extension est appliquée automatiquement aux instances.
Serveurs avec Azure Arc
Utilisez les commandes PowerShell suivantes pour installer l’agent Azure Monitor sur un serveur avec Azure Arc :
Fenêtres
New-AzConnectedMachineExtension -Name AzureMonitorWindowsAgent -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -MachineName <arc-server-name> -Location <arc-server-location> -EnableAutomaticUpgrade
Linux
New-AzConnectedMachineExtension -Name AzureMonitorLinuxAgent -ExtensionType AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -MachineName <arc-server-name> -Location <arc-server-location> -EnableAutomaticUpgrade
Pour installer l’agent Azure Monitor sur une machine virtuelle Azure ou sur un serveur Azure Arc activé, utilisez la commande Azure CLI pour ajouter une extension de machine virtuelle.
Machines virtuelles Azure
Utilisez les commandes Azure CLI suivantes pour installer l’agent Azure Monitor sur une machine virtuelle Azure. Choisissez la commande appropriée en fonction de la méthode d’authentification utilisée.
Identité managée affectée par l’utilisateur
Fenêtres
az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true --settings '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
Linux
az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true --settings '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
Identité managée affectée par le système
Fenêtres
az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true
Linux
az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true
Groupe de machines virtuelles identiques Azure
Utilisez l’applet de commande az vmss extension set d’Azure CLI pour installer agent Azure Monitor sur un Virtual Machine Scale Set.
Fenêtres
az vmss extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --vmss-name <vmss-name> --resource-group <resource-group-name> --enable-auto-upgrade true
Linux
az vmss extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --vmss-name <vmss-name> --resource-group <resource-group-name> --enable-auto-upgrade true
Pour utiliser une identité managée affectée par l’utilisateur, ajoutez le --settings paramètre :
az vmss extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --vmss-name <vmss-name> --resource-group <resource-group-name> --enable-auto-upgrade true --settings '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
Remarque
Si vous définissez la stratégie de mise à niveau de votre groupe de machines virtuelles identiques sur Manuel, vous devez mettre à jour les instances existantes en exécutant az vmss update-instances afin d’appliquer l’extension. Pour les groupes de machines virtuelles identiques avec une stratégie de mise à niveau Automatique ou Progressif, l’extension est appliquée automatiquement aux instances.
Serveurs avec Azure Arc
Utilisez les commandes Azure CLI suivantes pour installer l’agent Azure Monitor sur un serveur avec Azure Arc :
Fenêtres
az connectedmachine extension create --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --type AzureMonitorWindowsAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --location <arc-server-location> --enable-auto-upgrade true
Linux
az connectedmachine extension create --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --type AzureMonitorLinuxAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --location <arc-server-location> --enable-auto-upgrade true
Vous pouvez utiliser un modèle Azure Resource Manager pour installer l’agent Azure Monitor sur une machine virtuelle Azure ou sur un serveur avec Azure Arc ainsi que pour créer une association à des règles DCR. Vous devez créer une règle DCR avant de créer l’association de la règle DCR.
Obtenez des exemples de modèles pour installer l’agent et créer l’association à partir des ressources suivantes :
Installez les modèles à l’aide de n’importe quelle méthode de déploiement des modèles Resource Manager, notamment les commandes suivantes.
PowerShell
New-AzResourceGroupDeployment -ResourceGroupName "<resource-group-name>" -TemplateFile "<template-filename.json>" -TemplateParameterFile "<parameter-filename.json>"
Azure CLI (Interface de ligne de commande Azure)
az deployment group create --resource-group "<resource-group-name>" --template-file "<path-to-template>" --parameters "@<parameter-filename.json>"
Désinstaller l’interface
Pour désinstaller l’agent Azure Monitor à l’aide du portail Azure, accédez à votre machine virtuelle, votre groupe identique ou votre serveur avec Azure Arc. Sélectionnez l’onglet Extensions, puis sélectionnez AzureMonitorWindowsAgent ou AzureMonitorLinuxAgent. Dans la boîte de dialogue qui s’ouvre, sélectionnez Désinstaller.
Désinstaller sur une machine virtuelle Azure
Utilisez les commandes PowerShell suivantes pour désinstaller l’agent Azure Monitor sur une machine virtuelle Azure :
Fenêtres
Remove-AzVMExtension -Name AzureMonitorWindowsAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name>
Linux
Remove-AzVMExtension -Name AzureMonitorLinuxAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name>
Désinstaller sur un groupe de machines virtuelles identiques Azure
Utilisez la cmdlet PowerShell Remove-AzVmssExtension pour désinstaller l’agent Azure Monitor sur un groupe de machines virtuelles identiques Azure.
Fenêtres
$vmss = Get-AzVmss -ResourceGroupName <resource-group-name> -VMScaleSetName <vmss-name>
Remove-AzVmssExtension -VirtualMachineScaleSet $vmss -Name AzureMonitorWindowsAgent
Update-AzVmss -ResourceGroupName <resource-group-name> -VMScaleSetName <vmss-name> -VirtualMachineScaleSet $vmss
Linux
$vmss = Get-AzVmss -ResourceGroupName <resource-group-name> -VMScaleSetName <vmss-name>
Remove-AzVmssExtension -VirtualMachineScaleSet $vmss -Name AzureMonitorLinuxAgent
Update-AzVmss -ResourceGroupName <resource-group-name> -VMScaleSetName <vmss-name> -VirtualMachineScaleSet $vmss
Désinstaller sur un serveur avec Azure Arc
Utilisez les commandes PowerShell suivantes pour désinstaller l’agent Azure Monitor sur un serveur avec Azure Arc :
Fenêtres
Remove-AzConnectedMachineExtension -MachineName <arc-server-name> -ResourceGroupName <resource-group-name> -Name AzureMonitorWindowsAgent
Linux
Remove-AzConnectedMachineExtension -MachineName <arc-server-name> -ResourceGroupName <resource-group-name> -Name AzureMonitorLinuxAgent
Désinstaller sur une machine virtuelle Azure
Utilisez les commandes Azure CLI suivantes pour désinstaller l’agent Azure Monitor sur une machine virtuelle Azure :
Fenêtres
az vm extension delete --resource-group <resource-group-name> --vm-name <virtual-machine-name> --name AzureMonitorWindowsAgent
Linux
az vm extension delete --resource-group <resource-group-name> --vm-name <virtual-machine-name> --name AzureMonitorLinuxAgent
Désinstaller sur un groupe de machines virtuelles identiques Azure
Utilisez la cmdlet Azure CLI az vmss extension delete pour désinstaller l’agent Azure Monitor sur un groupe de machines virtuelles identiques Azure.
Fenêtres
az vmss extension delete --name AzureMonitorWindowsAgent --vmss-name <vmss-name> --resource-group <resource-group-name>
Linux
az vmss extension delete --name AzureMonitorLinuxAgent --vmss-name <vmss-name> --resource-group <resource-group-name>
Désinstaller sur un serveur avec Azure Arc
Utilisez les commandes Azure CLI suivantes pour désinstaller l’agent Azure Monitor sur un serveur avec Azure Arc :
Fenêtres
az connectedmachine extension delete --name AzureMonitorWindowsAgent --machine-name <arc-server-name> --resource-group <resource-group-name>
Linux
az connectedmachine extension delete --name AzureMonitorLinuxAgent --machine-name <arc-server-name> --resource-group <resource-group-name>
Mise à jour
Remarque
Mettez toujours à jour vers la dernière version de l’agent ou optez pour la mise à niveau automatique de l’extension.
Le déploiement automatique d’extension suit les pratiques de déploiement Azure standard pour déployer en toute sécurité la dernière version de l’agent. Les mises à jour automatiques prennent des semaines pour déployer la dernière version.
Les mises à niveau sont émises par lots. Ainsi, certaines de vos machines virtuelles, certains de vos groupes identiques ou certains de vos serveurs avec Azure Arc peuvent être mis à niveau avant d’autres.
Si vous devez mettre à niveau immédiatement une extension, utilisez les instructions manuelles décrites dans cet article. Seuls les agents publiés au cours des douze derniers mois sont pris en charge.
Pour mettre à jour l’agent, accédez à votre machine virtuelle ou à votre groupe de machines virtuelles identiques. Sélectionnez l’onglet Extensions , vérifiez l’agent, puis sélectionnez Mettre à jour.
Activez la mise à jour automatique de l’agent en activant la mise à niveau automatique de l’extension. Accédez à votre machine virtuelle ou votre groupe identique, sélectionnez l’onglet Extensions, puis sélectionnez AzureMonitorWindowsAgent ou AzureMonitorLinuxAgent. Dans la boîte de dialogue qui s’ouvre, sélectionnez Activer la mise à niveau automatique.
Mise à jour sur les machines virtuelles Azure
Pour mettre à jour l’agent une seule fois, installez la nouvelle version comme décrit dans cet article.
Activez la mise à jour automatique de l’agent en optant pour la mise à niveau automatique de l’extension.
Utilisez les commandes PowerShell suivantes :
Fenêtres
Set-AzVMExtension -ExtensionName AzureMonitorWindowsAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Publisher Microsoft.Azure.Monitor -ExtensionType AzureMonitorWindowsAgent -TypeHandlerVersion <version-number> -Location <location> -EnableAutomaticUpgrade $true
Linux
Set-AzVMExtension -ExtensionName AzureMonitorLinuxAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Publisher Microsoft.Azure.Monitor -ExtensionType AzureMonitorLinuxAgent -TypeHandlerVersion <version-number> -Location <location> -EnableAutomaticUpgrade $true
Mise à jour sur les Virtual Machine Scale Sets Azure
Activez la mise à niveau automatique des extensions pour les scale sets. Pour mettre à jour manuellement l’agent, réinstallez l’extension.
Remarque
Si vous définissez votre stratégie de mise à niveau du groupe identique de machines virtuelles sur Manual, vous devez mettre à jour les instances existantes en exécutant Update-AzVmssInstance après avoir modifié le modèle du groupe identique de machines virtuelles. Pour les groupes de machines virtuelles identiques avec une stratégie de mise à niveau Automatique ou Progressif, l’extension est appliquée automatiquement aux instances.
Mise à jour sur des serveurs avec Azure Arc
Pour mettre à niveau l’agent une seule fois, utilisez les commandes PowerShell suivantes :
Fenêtres
$target = @{"Microsoft.Azure.Monitor.AzureMonitorWindowsAgent" = @{"targetVersion"=<target-version-number>}}
Update-AzConnectedExtension -ResourceGroupName $env.ResourceGroupName -MachineName <arc-server-name> -ExtensionTarget $target
Linux
$target = @{"Microsoft.Azure.Monitor.AzureMonitorLinuxAgent" = @{"targetVersion"=<target-version-number>}}
Update-AzConnectedExtension -ResourceGroupName $env.ResourceGroupName -MachineName <arc-server-name> -ExtensionTarget $target
Activez la mise à jour automatique de l’agent en optant pour la mise à niveau automatique de l’extension.
Utilisez les commandes PowerShell suivantes :
Fenêtres
Update-AzConnectedMachineExtension -ResourceGroup <resource-group-name> -MachineName <arc-server-name> -Name AzureMonitorWindowsAgent -EnableAutomaticUpgrade
Linux
Update-AzConnectedMachineExtension -ResourceGroup <resource-group-name> -MachineName <arc-server-name> -Name AzureMonitorLinuxAgent -EnableAutomaticUpgrade
Mise à jour sur les machines virtuelles Azure
Pour mettre à jour l’agent une seule fois, désinstallez d’abord la version existante de l’agent. Ensuite, installez la nouvelle version comme décrit dans cet article.
Activez la mise à jour automatique de l’agent en optant pour la mise à niveau de l’extension automatique à l’aide des commandes Azure CLI suivantes :
Fenêtres
az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --vm-name <virtual-machine-name> --resource-group <resource-group-name> --enable-auto-upgrade true
Linux
az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --vm-name <virtual-machine-name> --resource-group <resource-group-name> --enable-auto-upgrade true
Mise à jour sur les Virtual Machine Scale Sets Azure
Activez la mise à niveau automatique des extensions pour les scale sets. Pour mettre à jour manuellement l’agent, réinstallez l’extension.
Remarque
Si vous définissez la stratégie de mise à niveau de votre groupe de machines virtuelles identiques sur Manuel, vous devez mettre à jour les instances existantes en exécutant az vmss update-instances afin d’appliquer l’extension. Pour les groupes de machines virtuelles identiques avec une stratégie de mise à niveau Automatique ou Progressif, l’extension est appliquée automatiquement aux instances.
Mise à jour sur des serveurs avec Azure Arc
Pour mettre à niveau l’agent une seule fois, utilisez les commandes Azure CLI suivantes :
Fenêtres
az connectedmachine upgrade-extension --extension-targets "{\"Microsoft.Azure.Monitor.AzureMonitorWindowsAgent\":{\"targetVersion\":\"<target-version-number>\"}}" --machine-name <arc-server-name> --resource-group <resource-group-name>
Linux
az connectedmachine upgrade-extension --extension-targets "{\"Microsoft.Azure.Monitor.AzureMonitorLinuxAgent\":{\"targetVersion\":\"<target-version-number>\"}}" --machine-name <arc-server-name> --resource-group <resource-group-name>
Activez la mise à jour automatique de l’agent en optant pour la mise à niveau automatique de l’extension.
Exécutez les commandes suivantes dans Azure CLI :
Fenêtres
az connectedmachine extension update --name AzureMonitorWindowsAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --enable-auto-upgrade true
Linux
az connectedmachine extension update --name AzureMonitorLinuxAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --enable-auto-upgrade true
Data collection rules (DCRs) gérer l’agent Azure Monitor sur votre ordinateur. Utilisez le DCR AgentSettings pour configurer certains paramètres de l’agent Azure Monitor pour répondre à vos besoins de surveillance spécifiques.
Remarque
Considérations importantes quand vous utilisez la règle DCR AgentSettings :
- Actuellement, vous pouvez configurer le DCR AgentSettings uniquement à l’aide d’un modèle Azure Resource Manager.
- AgentSettings doit être une règle DCR unique sans autre paramètre.
- La machine virtuelle et la règle DCR AgentSettings doivent se trouver dans la même région.
Paramètres pris en charge
La règle DCR AgentSettings prend en charge la définition des paramètres suivants :
| Paramètre |
Descriptif |
Valeurs valides |
MaxDiskQuotaInMB |
Pour assurer la résilience, l’agent collecte les données dans un cache local quand il ne peut pas envoyer de données. L’agent envoie les données du cache une fois la connexion restaurée. Ce paramètre est la quantité d’espace disque utilisé (en Mo) par les fichiers journaux et le cache de l’agent Azure Monitor. |
Linux : 4,000 à 1,000,000 par défaut : 10,000 Windows : 4,000 vers 1,000,000 |
UseTimeReceivedForForwardedEvents |
Change la colonne WEF de la table WEF (transfert d’événements Windows) de Microsoft Sentinel pour utiliser les données TimeReceived à la place des données TimeGenerated |
0 ou 1 |
Configurer la règle DCR AgentSettings
Préparez l’environnement en installant l’agent Azure Monitor sur votre machine virtuelle.
Créez une DCR.
Cet exemple définit la quantité maximale d’espace disque utilisée par le cache de l’agent Azure Monitor à 5 000 Mo.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {},
"resources": [
{
"type": "Microsoft.Insights/dataCollectionRules",
"name": "dcr-contoso-01",
"apiVersion": "2023-03-11",
"properties":
{
"description": "A simple agent settings",
"agentSettings":
{
"logs": [
{
"name": "MaxDiskQuotaInMB",
"value": "5000"
}
]
}
},
"kind": "AgentSettings",
"location": "eastus"
}
]
}
Associez la règle DCR à votre machine. Utilisez les fichiers Resource Manager suivants.
Fichier de modèle :
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"vmName": {
"type": "string",
"metadata": {
"description": "The name of the virtual machine."
}
},
"dataCollectionRuleId": {
"type": "string",
"metadata": {
"description": "The resource ID of the data collection rule."
}
}
},
"resources": [
{
"type": "Microsoft.Insights/dataCollectionRuleAssociations",
"apiVersion": "2021-09-01-preview",
"scope": "[format('Microsoft.Compute/virtualMachines/{0}', parameters('vmName'))]",
"name": "agentSettings",
"properties": {
"description": "Association of data collection rule. Deleting this association will break the data collection for this virtual machine.",
"dataCollectionRuleId": "[parameters('dataCollectionRuleId')]"
}
}
]
}
Remarque
Si vous associez la DCR à une machine compatible Azure Arc, vous devez modifier la propriété scope et le nom parameters.
« scope » : « [format('Microsoft.HybridCompute/machines/{0}', parameters('name'))] »
Fichier de paramètres :
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"vmName": {
"value": "my-azure-vm"
},
"dataCollectionRuleId": {
"value": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/my-resource-group/providers/microsoft.insights/datacollectionrules/my-dcr"
}
}
}
Pour appliquer les changements, redémarrez l’agent Azure Monitor.
Contenu connexe
Créez une règle de collecte de données pour collecter des données à partir de l’agent et les envoyer à Azure Monitor.