Creare e modificare le regole di raccolta dati in Monitoraggio di Azure

Articolo
04/04/2024

Esistono più metodi per la creazione di una regola di raccolta dati in Monitoraggio di Azure. In alcuni casi, Monitoraggio di Azure creerà e gestirà il registro di dominio in base alle impostazioni configurate nel portale di Azure. In altri casi, potrebbe essere necessario creare controller di dominio personalizzati per personalizzare scenari specifici.

Questo articolo descrive i diversi metodi per la creazione e la modifica di un record di controllo di dominio. Per il contenuto di DCR stesso, vedere Struttura di una regola di raccolta dati in Monitoraggio di Azure.

Autorizzazioni

Sono necessarie le autorizzazioni seguenti per creare controller di dominio e associazioni:

Ruolo predefinito	Ambiti	Motivo
Collaboratore al monitoraggio	Sottoscrizione e/o Gruppo di risorse e/o Un DCR esistente	Creare o modificare controller di dominio, assegnare regole al computer, distribuire le associazioni.
Collaboratore macchine virtuali Amministratore delle risorse di Azure Connected Machine	Macchine virtuali, set di scalabilità di macchine virtuali Server con abilitazione di Azure Arc	Distribuire le estensioni dell'agente nella macchina virtuale.
Qualsiasi ruolo che include l'azione Microsoft.Resources/deployments/*	Sottoscrizione e/o Gruppo di risorse e/o Un DCR esistente	Distribuire modelli di Azure Resource Manager.

Metodi automatizzati per creare un record di controllo di dominio

Nella tabella seguente sono elencati i metodi per creare scenari di raccolta dati usando il portale di Azure in cui viene creato il record di controllo di dominio. In questi casi non è necessario interagire direttamente con il DCR stesso.

Scenario	Risorse	Descrizione
Agente di Monitoraggio di Azure	Configurare la raccolta dati per l'agente di Monitoraggio di Azure	Usare il portale di Azure per creare un controller di dominio che specifica gli eventi e i contatori delle prestazioni da raccogliere da un computer con l'agente di Monitoraggio di Azure. Associare quindi tale regola a una o più macchine virtuali. L'agente di Monitoraggio di Azure verrà installato in tutti i computer che non lo hanno attualmente.
	Panoramica delle informazioni dettagliate sulle macchine virtuali	Quando si abilitano le informazioni dettagliate sulle macchine virtuali in una macchina virtuale, viene installato l'agente di Monitoraggio di Azure e viene creato un record di controllo di dominio che raccoglie un set predefinito di contatori delle prestazioni. Non è consigliabile modificare questo record di controllo di dominio.
Informazioni dettagliate contenitore	Abilitare Informazioni dettagliate sui contenitori	Quando si abilitaNo informazioni dettagliate sui contenitori in un cluster Kubernetes, viene installata una versione in contenitori dell'agente di Monitoraggio di Azure e viene creato un Registro Azure Container che raccoglie i dati in base alla configurazione selezionata. Potrebbe essere necessario modificare questo record di controllo di dominio per aggiungere una trasformazione.
Log di testo o JSON	Raccogliere log da un file di testo o JSON con l'agente di Monitoraggio di Azure	Usare il portale di Azure per creare un registro dati per raccogliere le voci da un log di testo in un computer con l'agente di Monitoraggio di Azure.

Creare manualmente un record di controllo di dominio

Per creare manualmente un DCR, creare un file JSON usando la configurazione appropriata per la raccolta di dati che si sta configurando. Iniziare con uno dei controller di dominio di esempio e usare le informazioni in Struttura di una regola di raccolta dati in Monitoraggio di Azure per modificare il file JSON per l'ambiente e i requisiti specifici.

Dopo aver creato il file JSON, è possibile usare uno dei metodi seguenti per creare il record di controllo di dominio:

Usare il comando az monitor data-collection rule create per creare un DCR dal file JSON usando l'interfaccia della riga di comando di Azure, come illustrato nell'esempio seguente.

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'

Usare il cmdlet New-AzDataCollectionRule per creare il DCR dal file JSON usando PowerShell, come illustrato nell'esempio seguente.

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

Usare l'API DCR create per creare il DCR dal file JSON. È possibile usare qualsiasi metodo per chiamare un'API REST, come illustrato negli esempi seguenti.

$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

Vedere i riferimenti seguenti per la definizione di controller di dominio e associazioni in un modello.

Usare il modello seguente per creare un record di controllo di dominio usando le informazioni della struttura di una regola di raccolta dati in Monitoraggio di Azure e regole di raccolta dati di esempio in Monitoraggio di Azure per definire .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>"
            }
        }
    ]
}

Associazione DCR - Macchina virtuale di Azure

L'esempio seguente crea un'associazione tra una macchina virtuale di Azure e una regola di raccolta dati.

File modello 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
  }
}

File del modello di Resource Manager

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

File di parametri

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

Associazione DCR - Server abilitato per Arc

L'esempio seguente crea un'associazione tra un server abilitato per Azure Arc e una regola di raccolta dati.

File modello 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
  }
}

File del modello di Resource Manager

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

File di parametri

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

Modificare un record di controllo di dominio

Per modificare un record di controllo di dominio, è possibile usare uno dei metodi descritti nella sezione precedente per creare un record di dominio usando una versione modificata del codice JSON.

Se è necessario recuperare il codice JSON per un record di dominio esistente, è possibile copiarlo dalla vista JSON per il DCR nel portale di Azure. È anche possibile recuperarlo usando una chiamata API, come illustrato nell'esempio di PowerShell seguente.

$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

Per un'esercitazione che illustra il processo di recupero e modifica di un record di dominio esistente, vedere Esercitazione: Modificare una regola di raccolta dati.For a tutorial: Edit a data collection rule (DCR).