Creación y edición de reglas de recopilación de datos (DCR) en Azure Monitor

Artículo
04/11/2024

Hay varios métodos para crear una regla de recopilación de datos (DCR) en Azure Monitor. En algunos casos, Azure Monitor creará y administrará el DCR según los valores que configure en el portal de Azure. En otros casos, es posible que tenga que crear sus propias DCR para personalizar escenarios concretos.

En este artículo se describen los distintos métodos para crear y editar un DCR. Para obtener el contenido de DCR en sí, consulte Estructura de una regla de recopilación de datos en Azure Monitor.

Permisos

Necesita los permisos siguientes para crear DCR y asociaciones:

Rol integrado	Ámbitos	Motivo
Colaborador de supervisión	Suscripción o Grupo de recursos o Una DCR existente	Cree o edite DCR, asigne reglas a la máquina e implemente asociaciones.
Colaborador de la máquina virtual Administrador de recursos de Azure Connected Machine	Máquinas virtuales, conjuntos de escalado de máquinas virtuales Servidores habilitados para Azure Arc	Implemente extensiones de agente en la máquina virtual.
Cualquier rol que incluya la acción Microsoft.Resources/deployments/*	Suscripción o Grupo de recursos o Una DCR existente	Implementación de las plantillas de Azure Resource Manager.

Métodos automatizados para crear un DCR

En la siguiente tabla se listan los métodos para crear escenarios de recopilación de datos mediante el Azure Portal, donde se crea la DCR para usted. En estos casos no es necesario interactuar directamente con el propio DCR.

Escenario	Recursos	Descripción
Agente de Azure Monitor	Configuración de la recopilación de datos para el agente de Azure Monitor	Utilice Azure Portal para crear una DCR que especifique eventos y contadores de rendimiento si quiere recopilar datos de una máquina con el agente de Azure Monitor. A continuación, asocie esa regla a una o varias máquinas virtuales. El agente de Azure Monitor se instala en todas las máquinas que aún no lo tienen instalado.
	Información general sobre la habilitación de VM Insights	Al habilitar VM Insights en una máquina virtual, se instala el agente de Azure Monitor y se crea un DCR que recopila un conjunto predefinido de contadores de rendimiento. No debe modificar este DCR.
Container Insights	Habilitación de Container Insights	Al habilitar Container Insights en un clúster de Kubernetes, se instala una versión en contenedor del agente de Azure Monitor y se crea un DCR que recopila datos según la configuración seleccionada. Es posible que tenga que modificar este DCR para agregar una transformación.
Registros de texto o JSON	Recopilación de registros de un archivo de texto o JSON con el agente de Azure Monitor	Use Azure Portal para crear un DCR para recopilar entradas de un registro de texto en una máquina con el agente de Azure Monitor.

Crear manualmente un DCR

Para crear manualmente una DCR, crear un archivo JSON mediante la configuración adecuada para la recopilación de datos que está configurando. Comience con una de las DCR de ejemplo y use información en Estructura de una regla de recopilación de datos en Azure Monitor para modificar el archivo JSON para su entorno y requisitos concretos.

Una vez creado el archivo JSON, puede usar cualquiera de los métodos siguientes para crear el DCR:

Use el comando az monitor datos-colección regla crear para crear un DCR a partir del archivo JSON mediante la CLI de Azure, como se muestra en el ejemplo siguiente.

az monitor data-collection rule create --location 'eastus' --resource-group 'my-resource-group' --name 'myDCRName' --rule-file 'C:\MyNewDCR.json' --description 'This is my new DCR'

Use el cmdlet New-AzDataCollectionRule para crear el DCR desde el archivo JSON mediante PowerShell, como se programan en el ejemplo siguiente.

New-AzDataCollectionRule -Location 'east-us' -ResourceGroupName 'my-resource-group' -RuleName 'myDCRName' -RuleFile 'C:\MyNewDCR.json' -Description 'This is my new DCR'

Use el creación de API de DCR para crear el DCR a partir del archivo JSON. Puede usar cualquier método para llamar a una API de REST, como se muestra en los ejemplos siguientes.

$ResourceId = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group/providers/Microsoft.Insights/dataCollectionRules/my-dcr"
$FilePath = ".\my-dcr.json"
$DCRContent = Get-Content $FilePath -Raw 
Invoke-AzRestMethod -Path ("$ResourceId"+"?api-version=2022-06-01") -Method PUT -Payload $DCRContent

ResourceId="/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group/providers/Microsoft.Insights/dataCollectionRules/my-dcr"
FilePath="my-dcr.json"
az rest --method put --url $ResourceId"?api-version=2022-06-01" --body @$FilePath

Consulte las referencias siguientes para definir DCR y asociaciones en una plantilla.

Use la plantilla siguiente para crear un DCR mediante información de Estructura de una regla de recopilación de datos en Azure Monitor y Reglas de recopilación de datos de ejemplo (DCR) en Azure Monitor para definir dcr-properties.

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "dataCollectionRuleName": {
            "type": "string",
            "metadata": {
                "description": "Specifies the name of the Data Collection Rule to create."
            }
        },
        "location": {
            "type": "string",
            "metadata": {
                "description": "Specifies the location in which to create the Data Collection Rule."
            }
        }
    },
    "resources": [
        {
            "type": "Microsoft.Insights/dataCollectionRules",
            "name": "[parameters('dataCollectionRuleName')]",
            "location": "[parameters('location')]",
            "apiVersion": "2021-09-01-preview",
            "properties": {
                "<dcr-properties>"
            }
        }
    ]
}

Asociación de DCR: 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/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/microsoft.insights/datacollectionrules/my-dcr"
    }
   }
}

Asociación de 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/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/microsoft.insights/datacollectionrules/my-dcr"
    }
   }
}

Edición de un DCR

Para editar un DCR, puede usar cualquiera de los métodos descritos en la sección anterior para crear un DCR mediante una versión modificada del JSON.

Si necesita recuperar el código JSON de un DCR existente, puede copiarlo desde la vista JSON para DCR en Azure Portal. También puede recuperarlo mediante una llamada API como se muestra en el siguiente ejemplo de PowerShell.

$ResourceId = "<ResourceId>" # Resource ID of the DCR to edit
$FilePath = "<FilePath>" # Store DCR content in this file
$DCR = Invoke-AzRestMethod -Path ("$ResourceId"+"?api-version=2022-06-01") -Method GET
$DCR.Content | ConvertFrom-Json | ConvertTo-Json -Depth 20 | Out-File -FilePath $FilePath

Para ver un tutorial que le guía por el proceso de recuperación y edición de un DCR existente, consulteTutorial: Edición de una regla de recopilación de datos (DCR).