Gérer les associations de règles de collecte de données dans Azure Monitor

Les associations de règles de collecte de données associent des DCR à des ressources surveillées dans Azure Monitor, comme décrit dans Utilisation d’une DCR. Cet article décrit différentes méthodes pour afficher et créer des DCRA et leurs ressources associées.

Important

Tous les scénarios de collecte de données avec des DCR utilisent des DCRA. Consultez Utilisation d’une DCR pour obtenir une explication et une comparaison de la façon dont les DCR sont spécifiées dans différents scénarios de collecte de données.

Afficher et modifier des associations pour une DCR dans le portail Azure

Pour afficher vos règles de collecte de données dans le portail Azure, sélectionnez Règles de collecte de données sous Paramètres dans le menu Monitor. Sélectionnez une DCR pour afficher ses détails.

Cliquez sur l’onglet Ressources pour afficher les ressources associées à la DCR sélectionnée. Cliquez sur Ajouter pour ajouter une association à une nouvelle ressource. Vous pouvez afficher et ajouter des ressources à l’aide de cette fonctionnalité, que vous ayez ou non créé la DCR dans le portail Azure.

Remarque

Bien que cette vue affiche toutes les règles de collecte de données dans les abonnements spécifiés, le fait de sélectionner le bouton Créer crée une collecte de données pour l’agent Azure Monitor. De même, cette page vous permet uniquement de modifier des règles de collecte de données pour l’agent Azure Monitor. Pour obtenir de l’aide sur la façon de créer et de mettre à jour des DCR pour d’autres flux de travail, consultez Créer et modifier des règles de collecte de données (DCR) dans Azure Monitor.

Aperçu de l’expérience DCR

Une préversion de la nouvelle expérience du portail Azure pour les DCR lie les DCR et les ressources auxquelles elles sont associées. Vous pouvez voir la liste par Règle de collecte de données, qui indique le nombre de ressources associées à chaque DCR, ou par Ressources, qui indique le nombre de DCR associées à chaque ressource.

Sélectionnez l’option dans la bannière affichée pour activer cette expérience.

Vue Règle de collecte de données

Dans la vue Règle de collecte de données, le Nombre de ressources indique combien de ressources ont une association de règles de collecte de données avec la DCR. Cliquez sur cette valeur pour ouvrir la vue Ressources de cette DCR.

Vue Ressources

La vue Ressources liste toutes les ressources Azure qui correspondent au filtre sélectionné, qu’elles aient ou non une association DCR. Les vignettes en haut de la vue listent le nombre total de ressources, le nombre des ressources non associées à une DCR et le nombre total de DCR correspondant au filtre sélectionné.

Afficher les DCR pour une ressource

La colonne Règles de collecte de données représente le nombre de DCR associées à chaque ressource. Cliquez sur cette valeur pour ouvrir un nouveau volet listant les DCR associées à la ressource.

Important

Les DCR ne sont pas toutes associées à des ressources. Par exemple, les DCR utilisées avec l’API d’ingestion des journaux sont spécifiées dans l’appel d’API et n’utilisent pas d’associations. Ces DCR s’affichent toujours dans la vue, mais leur Nombre de ressources indique 0.

Créer une DCR ou des associations avec des DCR existantes

À l’aide de la vue Ressources, vous pouvez créer une DCR pour les ressources sélectionnées ou les associer à une DCR existante. Sélectionnez les ressources puis cliquez sur l’une des options suivantes.

Option	Description
Créer une règle de collecte de données	Lancez le processus de création d’une DCR pour l’agent Azure Monitor. Les ressources sélectionnées sont automatiquement ajoutées en tant que ressources pour la nouvelle DCR. Pour plus d’informations sur ce processus, consultez Collecter des données avec l’agent Azure Monitor .
Associer à une règle de collecte de données existante	Associez les ressources sélectionnées à une ou plusieurs DCR existantes. Cette action ouvre la liste des DCR pouvant être associées à la ressource actuelle. Cette liste inclut uniquement les DCR valides pour la ressource en particulier. Par exemple, si la ressource est une machine virtuelle avec l’agent Azure Monitor (AMA) installé, seules les DCR qui traitent les données AMA sont listées.

Créer une association...

Outre l’expérience du portail Azure en préversion, vous pouvez créer une association à l’aide de l’une des méthodes suivantes. L’objet DCRA créé est un enfant de l’objet cible et utilise l’ID de ressource de la DCR.

INTERFACE DE LIGNE DE COMMANDE

Créer une association avec l’interface CLI

Utilisez la commande az monitor data-collection rule association create pour créer une association entre votre DCR et votre ressource.

az monitor data-collection rule association create --name "my-vm-dcr-association" --rule-id "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/my-resource-group/providers/Microsoft.Insights/dataCollectionRules/my-dcr" --resource "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/my-resource-group/providers/Microsoft.Compute/virtualMachines/my-vm"

PowerShell

Créer une association avec PowerShell

Utilisez la commande New-AzDataCollectionRuleAssociation pour créer une association entre votre DCR et votre ressource.

 New-AzDataCollectionRuleAssociation -TargetResourceId '/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/my-resource-group/providers/Microsoft.Compute/virtualMachines/my-vm' -DataCollectionRuleId '/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/my-resource-group/providers/microsoft.insights/datacollectionrules/my-dcr' -AssociationName 'my-vm-dcr-association'

Modèle ARM

Créer une association avec des modèles ARM

Le modèle ARM pour les associations diffère selon les différents objets cibles. Voici les modèles que vous pouvez utiliser pour différents types d’objets.

Microsoft Azure

L’exemple suivant crée une association entre une machine virtuelle Azure et une règle de collecte de données.

Fichier de modèle Bicep

@description('The name of the virtual machine.')
param vmName string

@description('The name of the association.')
param associationName string

@description('The resource ID of the data collection rule.')
param dataCollectionRuleId string

resource vm 'Microsoft.Compute/virtualMachines@2021-11-01' existing = {
  name: vmName
}

resource association 'Microsoft.Insights/dataCollectionRuleAssociations@2021-09-01-preview' = {
  name: associationName
  scope: vm
  properties: {
    description: 'Association of data collection rule. Deleting this association will break the data collection for this virtual machine.'
    dataCollectionRuleId: dataCollectionRuleId
  }
}

Fichier de modèle ARM

{
  "$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."
      }
    },
    "associationName": {
      "type": "string",
      "metadata": {
        "description": "The name of the association."
      }
    },
    "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": "[parameters('associationName')]",
      "properties": {
        "description": "Association of data collection rule. Deleting this association will break the data collection for this virtual machine.",
        "dataCollectionRuleId": "[parameters('dataCollectionRuleId')]"
      }
    }
  ]
}

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"
    },
    "associationName": {
      "value": "my-windows-vm-my-dcr"
    },
    "dataCollectionRuleId": {
      "value": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/my-resource-group/providers/microsoft.insights/datacollectionrules/my-dcr"
    }
   }
}

Serveur avec Arc

L’exemple suivant crée une association entre un serveur avec Azure Arc et une règle de collecte de données.

Fichier de modèle Bicep

@description('The name of the virtual machine.')
param vmName string

@description('The name of the association.')
param associationName string

@description('The resource ID of the data collection rule.')
param dataCollectionRuleId string

resource vm 'Microsoft.HybridCompute/machines@2021-11-01' existing = {
  name: vmName
}

resource association 'Microsoft.Insights/dataCollectionRuleAssociations@2021-09-01-preview' = {
  name: associationName
  scope: vm
  properties: {
    description: 'Association of data collection rule. Deleting this association will break the data collection for this Arc server.'
    dataCollectionRuleId: dataCollectionRuleId
  }
}

Fichier de modèle ARM

{
  "$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."
      }
    },
    "associationName": {
      "type": "string",
      "metadata": {
        "description": "The name of the association."
      }
    },
    "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.HybridCompute/machines/{0}', parameters('vmName'))]",
      "name": "[parameters('associationName')]",
      "properties": {
        "description": "Association of data collection rule. Deleting this association will break the data collection for this Arc server.",
        "dataCollectionRuleId": "[parameters('dataCollectionRuleId')]"
      }
    }
  ]
}

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-hybrid-vm"
    },
    "associationName": {
      "value": "my-windows-vm-my-dcr"
    },
    "dataCollectionRuleId": {
      "value": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/my-resource-group/providers/microsoft.insights/datacollectionrules/my-dcr"
    }
   }
}

Azure Policy

À l’aide de Azure Policy, vous pouvez associer une DCR à plusieurs ressources à grande échelle. Lorsque vous créez une affectation entre un groupe de ressources et une stratégie ou une initiative intégrée, des associations sont créées entre la DCR et chaque ressource du type affecté dans le groupe de ressources, y compris les nouvelles ressources à mesure qu’elles sont créées. Azure Monitor offre une expérience utilisateur simplifiée pour créer une affectation pour une stratégie ou une initiative pour une DCR particulière, ce qui correspond à une autre méthode pour créer l’affectation directement à l’aide d’Azure Policy.

Remarque

Une stratégie dans Azure Policy est une règle ou une condition unique à laquelle les ressources d’Azure doivent se conformer. Par exemple, il existe une stratégie intégrée appelée Configurer des machines Windows à associer à une règle de collecte de données ou à un point de terminaison de collecte de données.

Une initiative est une collection de stratégies regroupées pour atteindre un objectif ou un but spécifique. Par exemple, il existe une initiative appelée Configurer des machines Windows pour exécuter l’agent Azure Monitor et les associer à une règle de collecte de données qui inclut plusieurs stratégies pour installer et configurer l’agent Azure Monitor.

À partir de la DCR dans le portail Azure, sélectionnez Stratégies (préversion). Cette opération ouvre une page qui répertorie toutes les affectations avec la DCR actuelle et l’état de conformité des ressources incluses. Les vignettes situées en haut fournissent des métriques de conformité pour toutes les ressources et affectations.

Pour créer une affectation, cliquez sur Affecter une stratégie ou Affecter une initiative.

Setting	Description
Abonnement	L’abonnement avec le groupe de ressources à utiliser comme étendue.
Resource group	Le groupe de ressources à utiliser comme étendue. La DCR est affectée à toutes les ressources de ce groupe de ressources, en fonction du groupe de ressources géré par la définition.
Définition d’initiative/de stratégie	La définition à affecter. La liste déroulante inclut toutes les définitions de l’abonnement qui acceptent une DCR en tant que paramètre.
Nom de l’affectation	Un nom pour l’affectation. Doit être unique dans l’abonnement.
Description	Description facultative de l’affectation.
Mode d'application d'une stratégie	La stratégie est appliquée uniquement si son application est activée. Si elle est désactivée, seules les évaluations de la stratégie sont effectuées.

Une fois une affectation créée, vous pouvez afficher ses détails en cliquant dessus. Cela vous permettra de modifier les détails de l’affectation et de créer une tâche de correction.

Important

L’affectation ne sera pas appliquée aux ressources existantes tant que vous n’aurez pas créé une tâche de correction. Pour plus d’informations, consultez Corriger les ressources non conformes avec Azure Policy.

Étapes suivantes

Consultez les articles suivants pour plus d’informations sur la manière de travailler avec les DCR.

• Structure des règles de collecte des données pour obtenir une description de la structure JSON des DCR et des différents éléments utilisés pour les flux de travail.
• Exemples de règles de collecte de données (DCR) pour les exemples de DCR pour différents scénarios de collecte de données.
• Créer et modifier des règles de collecte de données (DCR) dans Azure Monitor pour différentes méthodes de création de DCR pour différents scénarios de collecte de données.
• Limites du service Azure Monitor pour connaître les limites qui s’appliquent à chaque règle de collecte de données.