Skapa och redigera regler för datainsamling (DCR) i Azure Monitor

Artikel
04/04/2024

Det finns flera metoder för att skapa en datainsamlingsregel (DCR) i Azure Monitor. I vissa fall skapar och hanterar Azure Monitor DCR enligt de inställningar som du konfigurerar i Azure-portalen. I andra fall kan du behöva skapa egna domänkontrollanter för att anpassa specifika scenarier.

Den här artikeln beskriver de olika metoderna för att skapa och redigera en DCR. Innehållet i själva DCR finns i Structure of a data collection rule in Azure Monitor (Struktur för en datainsamlingsregel i Azure Monitor).

Behörigheter

Du behöver följande behörigheter för att skapa domänkontrollanter och associationer:

Inbyggd roll	Omfattningar	Anledning
Övervakningsdeltagare	Prenumeration och/eller Resursgrupp och/eller En befintlig DCR	Skapa eller redigera domänkontrollanter, tilldela regler till datorn, distribuera associationer.
Virtuell datordeltagare Resursadministratör för Azure Anslut ed Machine	Virtuella datorer, VM-skalningsuppsättningar Azure Arc-aktiverade servrar	Distribuera agenttillägg på den virtuella datorn.
Alla roller som innehåller åtgärden Microsoft.Resources/deployments/*	Prenumeration och/eller Resursgrupp och/eller En befintlig DCR	Distribuera Azure Resource Manager-mallar.

Automatiserade metoder för att skapa en DCR

I följande tabell visas metoder för att skapa datainsamlingsscenarier med hjälp av Azure-portalen där DCR skapas åt dig. I dessa fall behöver du inte interagera direkt med själva domänkontrollanten.

Scenario	Resurser	beskrivning
Azure Monitor-agent	Konfigurera datainsamling för Azure Monitor Agent	Använd Azure-portalen för att skapa en DCR som anger händelser och prestandaräknare som ska samlas in från en dator med Azure Monitor Agent. Associera sedan regeln med en eller flera virtuella datorer. Azure Monitor-agenten installeras på alla datorer som för närvarande inte har den.
	Översikt över aktivera VM-insikter	När du aktiverar VM-insikter på en virtuell dator installeras Azure Monitor-agenten och en DCR skapas som samlar in en fördefinierad uppsättning prestandaräknare. Du bör inte ändra den här domänkontrollanten.
Containerinsikter	Aktivera containerinsikter	När du aktiverar Container Insights i ett Kubernetes-kluster installeras en containerbaserad version av Azure Monitor-agenten och en DCR skapas som samlar in data enligt den konfiguration du valde. Du kan behöva ändra denna DCR för att lägga till en transformering.
Text- eller JSON-loggar	Samla in loggar från en text- eller JSON-fil med Azure Monitor Agent	Använd Azure-portalen för att skapa en DCR för att samla in poster från en textlogg på en dator med Azure Monitor Agent.

Skapa en DCR manuellt

Skapa en DCR manuellt genom att skapa en JSON-fil med lämplig konfiguration för den datainsamling som du konfigurerar. Börja med en exempel-DCR och använd information i Struktur för en datainsamlingsregel i Azure Monitor för att ändra JSON-filen för din specifika miljö och dina krav.

När du har skapat JSON-filen kan du använda någon av följande metoder för att skapa DCR:

Använd kommandot az monitor data-collection rule create för att skapa en DCR från din JSON-fil med hjälp av Azure CLI enligt följande exempel.

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'

Använd cmdleten New-AzDataCollectionRule för att skapa DCR från din JSON-fil med PowerShell enligt följande exempel.

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

Använd DCR create-API:et för att skapa DCR från din JSON-fil. Du kan använda valfri metod för att anropa ett REST API enligt följande exempel.

$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

Se följande referenser för att definiera domänkontrollanter och associationer i en mall.

Använd följande mall för att skapa en DCR med hjälp av information från Strukturen för en datainsamlingsregel i Azure Monitor och dcr-regler (Sample data collection rules) i Azure Monitor för att definiera 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>"
            }
        }
    ]
}

DCR Association – virtuell Azure-dator

Följande exempel skapar en association mellan en virtuell Azure-dator och en datainsamlingsregel.

Bicep-mallfil

@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
  }
}

ARM-mallfil

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

Parameterfil

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

DCR Association –Arc-aktiverad server

Följande exempel skapar en association mellan en Azure Arc-aktiverad server och en datainsamlingsregel.

Bicep-mallfil

@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
  }
}

ARM-mallfil

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

Parameterfil

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

Redigera en DCR

Om du vill redigera en DCR kan du använda någon av metoderna som beskrivs i föregående avsnitt för att skapa en DCR med hjälp av en modifierad version av JSON.

Om du behöver hämta JSON för en befintlig DCR kan du kopiera den från JSON-vyn för DCR i Azure-portalen. Du kan också hämta den med hjälp av ett API-anrop enligt följande PowerShell-exempel.

$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

En självstudiekurs som går igenom processen för att hämta och sedan redigera en befintlig DOMÄNKONTROLLant finns i Självstudie: Redigera en datainsamlingsregel (DCR).