Administración de asociaciones de reglas de recopilación de datos en Azure Monitor

Las asociaciones de reglas de recopilación de datos (DCRA) asocian DCR con recursos supervisados en Azure Monitor, tal como se describe en uso de un DCR. En este artículo se describen distintos métodos para ver y crear DCRA y sus recursos relacionados.

Importante

No todos los escenarios de recopilación de datos con DCR usan DCRA. Consulte Uso de un DCR para obtener una explicación y una comparación de cómo se especifican las DCR en diferentes escenarios de recopilación de datos.

Ver y modificar asociaciones para un DCR en el portal de Azure

Para ver sus DCR en Azure Portal, seleccione Reglas de recopilación de datos en Configuración en el menú Supervisar. Seleccione la DCR cuyos detalles quiera ver.

Haga clic en la pestaña Recursos para ver los recursos asociados a la DCR seleccionada. Haga clic en Agregar para agregar una asociación a un nuevo recurso. Puede ver y agregar recursos mediante esta característica tanto si ha creado el DCR en el Azure Portal como si no.

Nota:

Aunque esta vista muestra todas las DCR de las suscripciones especificadas, al seleccionar el botón Crear se crea una recopilación de datos para el agente de Azure Monitor. Del mismo modo, esta página solo permite modificar DCR para el Agente de Azure Monitor. Si desea instrucciones para crear y actualizar las DCR para otros flujos de trabajo, consulte Creación de reglas de recopilación de datos (DCR) en Azure Monitor.

Versión preliminar de la experiencia DCR

Una vista previa de la nueva experiencia del portal de Azure para DCR conecta los DCR y los recursos con los que están asociados. Puede ver la lista por Regla de recopilación de datos, que muestra el número de recursos asociados a cada DCR, o por Recursos, que muestra el recuento de DCR asociados a cada recurso.

Seleccione la opción en el banner que aparece para habilitar esta experiencia.

Vista de las reglas de recolección de datos

En la vista Regla de recolección de datos, el Recuento de recursos representa el número de recursos que tienen una asociación de regla de recolección de datos con la DCR. Haga clic en este valor para abrir la vista Recursos para ese DCR.

Vista de recursos

La vista Recursos enumera todos los recursos Azure que coinciden con el filtro seleccionado, tengan o no una asociación DCR. Los mosaicos de la parte superior de la vista muestran el recuento del total de recursos enumerados, el número de recursos no asociados a una DCR y el número total de DCR que coinciden con el filtro seleccionado.

Ver DCRs de un recurso

La columna Reglas de recolección de datos representa el número de DCR asociadas a cada recurso. Haga clic en este valor para abrir un nuevo panel que enumera los DCR asociados al recurso.

Importante

No todos los DCR están asociados a recursos. Por ejemplo, las DCR usadas con la API de ingesta de registros se especifican en la llamada API y no usan asociaciones. Estas DCR siguen apareciendo en la vista, pero tienen un recuento de recursos de 0.

Creación de nuevas DCR o asociaciones con DCR existente

Con la vista Recursos, puede crear un nuevo DCR para los recursos seleccionados o asociarlos con un DCR existente. Seleccione los recursos y a continuación, haga clic en una de las opciones siguientes.

Opción	Descripción
Creación de una regla de recopilación de datos	Inicie el proceso para crear un nuevo DCR para el agente de Azure Monitor. Los recursos seleccionados se agregan automáticamente como recursos para el nuevo DCR. Consulte Recopilación de datos con el agente de Azure Monitor para más información sobre este proceso.
Asociar con la regla de recopilación de datos existente	Asocie los recursos seleccionados a uno o varios DCR existentes. Se abre una lista de DCR que pueden asociarse al recurso actual. Esta lista solo incluye los DCR válidos para el recurso en cuestión. Por ejemplo, si el recurso es una máquina virtual con el agente Azure Monitor (AMA) instalado, solo se enumeran los DCR que procesan datos de AMA.

Crear nueva asociación

Además de la experiencia de Azure Portal en versión preliminar, puede crear una nueva asociación mediante cualquiera de los métodos siguientes. El objeto DCRA que se crea es un elemento secundario del objeto de destino y usa el identificador de recurso del DCR.

Nota:

Las DCR no se pueden asociar a un conjunto de escalado de máquinas virtuales (VMSS) con orquestación flexible. En su lugar, cree una asociación con cada máquina virtual incluida.

CLI

Creación de una asociación con el CLI

Usa el comando az monitor data-collection rule association create para crear una asociación entre tu DCR y el recurso.

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

Creación de una asociación con PowerShell

Use el comando New-AzDataCollectionRuleAssociation para crear una asociación entre la DCR y el recurso.

 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'

Plantilla de ARM

Creación de una asociación con plantillas de ARM

Las plantillas de ARM para las asociaciones difieren para los distintos objetos de destino. A continuación se muestran las plantillas que puede usar para diferentes tipos de objetos.

Máquina virtual de Azure

En el siguiente ejemplo se crea una asociación entre una máquina virtual de Azure y una regla de recopilación de datos.

Plantilla de ejemplo de 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
  }
}

Archivo de plantilla de 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')]"
      }
    }
  ]
}

Archivo de parámetros

{
  "$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"
    }
   }
}

Servidor habilitado para Arc

En el siguiente ejemplo se crea una asociación entre un servidor habilitado para Azure Arc y una regla de recopilación de datos.

Plantilla de ejemplo de 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
  }
}

Archivo de plantilla de 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')]"
      }
    }
  ]
}

Archivo de parámetros

{
  "$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

Usando Azure Policy, puede asociar un DCR con varios recursos a gran escala. Cuando se crea una asignación entre un grupo de recursos y una directiva o iniciativa integrada, las asociaciones se crean entre el DCR y cada recurso del tipo asignado en el grupo de recursos, incluidos los recursos nuevos a medida que se crean. Azure Monitor proporciona una experiencia de usuario simplificada para crear una asignación para una directiva o iniciativa para un DCR determinado, que es un método alternativo para crear la asignación mediante Azure Policy directamente.

Nota:

Una directiva de Azure Policy es una única regla o condición con la que deben cumplirse los recursos de Azure. Por ejemplo, hay una directiva integrada denominada Configurar máquinas Windows que se asociarán con una regla de recopilación de datos o un punto de conexión de recopilación de datos.

Una iniciativa es una colección de directivas que se agrupan para lograr un objetivo o un propósito específicos. Por ejemplo, hay una iniciativa denominada Configurar máquinas Windows para ejecutar el agente de Azure Monitor y asociarlas a una regla de recopilación de datos que incluye varias directivas para instalar y configurar el agente de Azure Monitor.

En DCR en Azure Portal, seleccione Directivas (versión preliminar). Se abre una página que enumera las asignaciones con el DCR actual y el estado de cumplimiento de los recursos incluidos. Los mosaicos de la parte superior proporcionan métricas de cumplimiento para todos los recursos y asignaciones.

Para crear una nueva asignación, haga clic en Asignar directiva o Asignar iniciativa.

Configuración	Descripción
Suscripción	La suscripción con el grupo de recursos que se va a usar como ámbito.
Grupo de recursos	Grupo de recursos que se va a usar como ámbito. El DCR se asigna a todos los recursos de este grupo de recursos, en función del grupo de recursos administrado por la definición.
Definición de directiva o iniciativa	Definición que se va a asignar. La lista desplegable incluye todas las definiciones de la suscripción que aceptan DCR como parámetro.
Nombre de asignación	Nombre de la asignación. Debe ser único en la suscripción.
Descripción	Descripción opcional de la asignación.
Aplicación de las directivas	La directiva solo se aplica si el cumplimiento está habilitado. Si está deshabilitada, solo se realizan las evaluaciones de la directiva.

Una vez creada una asignación, puede ver sus detalles haciendo clic en él. Esto le permite editar los detalles de la asignación y también crear una tarea de corrección.

Importante

La asignación no se aplicará a los recursos existentes hasta que cree una tarea de remediación. Para más información, consulte Corrección de recursos no conformes con Azure Policy.

Pasos siguientes

En los siguientes artículos puede obtener información adicional sobre cómo trabajar con DCR.

• Estructura de una regla de recopilación de datos para una descripción de la estructura JSON de las DCR y los elementos que se usan para los distintos flujos de trabajo.
• Reglas de recopilación de datos (DCR) de ejemplo, donde encontrará DCR de ejemplo para diferentes escenarios de recopilación de datos.
• Creación y edición de reglas de recopilación de datos (DCR) en Azure Monitor, donde puede encontrar distintos métodos para crear DCR para distintos escenarios de recopilación de datos.
• Límites del servicio Azure Monitor, donde se indican los límites que se aplican a cada DCR.