Vytvoření a úprava pravidel shromažďování dat (DCR) ve službě Azure Monitor

Existuje několik metod pro vytvoření pravidla shromažďování dat (DCR) ve službě Azure Monitor. V některých případech Azure Monitor vytvoří a spravuje řadič domény podle nastavení, která nakonfigurujete na webu Azure Portal. V jiných případech možná budete muset vytvořit vlastní řadiče domény, abyste mohli přizpůsobit konkrétní scénáře.

Tento článek popisuje různé metody vytváření a úprav DCR. Obsah samotného DCR najdete v tématu Struktura pravidla shromažďování dat ve službě Azure Monitor.

Oprávnění

K vytváření řadičů domény a přidružení potřebujete následující oprávnění:

Předdefinovaná role	Rozsahy	Důvod
Přispěvatel monitorování	Předplatné a/nebo Skupina prostředků nebo Existující řadič domény	Vytvořte nebo upravte řadiče domény, přiřaďte k počítači pravidla, nasaďte přidružení.
Přispěvatel virtuálních počítačů Prostředek Připojení počítače Azure Správa istrator	Virtuální počítače, škálovací sady virtuálních počítačů Servery s podporou služby Azure Arc	Nasaďte na virtuální počítač rozšíření agenta.
Libovolná role, která zahrnuje akci Microsoft.Resources/deployments/*	Předplatné a/nebo Skupina prostředků nebo Existující řadič domény	Nasaďte šablony Azure Resource Manageru.

Automatizované metody pro vytvoření DCR

Následující tabulka uvádí metody pro vytváření scénářů shromažďování dat pomocí webu Azure Portal, kde se pro vás vytvoří DCR. V těchto případech nemusíte přímo pracovat se samotným DCR.

Scénář	Zdroje informací	Popis
Agent Azure Monitoru	Konfigurace shromažďování dat pro agenta Služby Azure Monitor	Pomocí webu Azure Portal vytvořte řadič domény, který určuje události a čítače výkonu, které se mají shromažďovat z počítače pomocí agenta služby Azure Monitor. Toto pravidlo pak přidružte k jednomu nebo více virtuálním počítačům. Agent služby Azure Monitor se nainstaluje na žádné počítače, které ho aktuálně nemají.
	Přehled povolení přehledů virtuálních počítačů	Když povolíte přehledy virtuálních počítačů na virtuálním počítači, nainstaluje se agent Azure Monitoru a vytvoří se DCR, který shromažďuje předdefinovanou sadu čítačů výkonu. Tento řadič domény byste neměli upravovat.
Přehledy kontejnerů	Povolení přehledů kontejneru	Když povolíte Přehledy kontejnerů v clusteru Kubernetes, nainstaluje se kontejnerizovaná verze agenta Azure Monitoru a vytvoří se DCR, která shromažďuje data podle vámi vybrané konfigurace. Možná budete muset tento řadič domény upravit, aby se přidala transformace.
Textové protokoly nebo protokoly JSON	Shromažďování protokolů z textového souboru nebo souboru JSON pomocí agenta služby Azure Monitor	Pomocí webu Azure Portal vytvořte řadič domény pro shromažďování položek z textového protokolu na počítači pomocí agenta služby Azure Monitor.

Ruční vytvoření DCR

Pokud chcete řadič domény vytvořit ručně, vytvořte soubor JSON s použitím odpovídající konfigurace pro kolekci dat, kterou konfigurujete. Začněte jedním z ukázkových řadičů domény a pomocí informací ve struktuře pravidla shromažďování dat ve službě Azure Monitor upravte soubor JSON pro vaše konkrétní prostředí a požadavky.

Po vytvoření souboru JSON můžete k vytvoření DCR použít některou z následujících metod:

Rozhraní příkazového řádku

Pomocí příkazu az monitor data-collection rule create vytvořte řadič domény ze souboru JSON pomocí Azure CLI, jak je znázorněno v následujícím příkladu.

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'

PowerShell

Pomocí rutiny New-AzDataCollectionRule vytvořte DCR ze souboru JSON pomocí PowerShellu, jak je znázorněno v následujícím příkladu.

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

Rozhraní API

Pomocí rozhraní DCR vytvořte rozhraní API pro vytvoření DCR ze souboru JSON. K volání rozhraní REST API můžete použít libovolnou metodu, jak je znázorněno v následujících příkladech.

$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

RAMENO

V následujících odkazech se dozvíte, jak definovat řadiče domény a přidružení v šabloně.

• Pravidla shromažďování dat
• Přidružení pravidel shromažďování dat

Následující šablona slouží k vytvoření DCR s využitím informací ze struktury pravidla shromažďování dat ve službě Azure Monitor a pravidel shromažďování ukázkových dat (DCR) ve službě Azure Monitor k definování 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>"
            }
        }
    ]
}

Přidružení DCR – virtuální počítač Azure

Následující ukázka vytvoří přidružení mezi virtuálním počítačem Azure a pravidlem shromažďování dat.

Soubor šablony 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
  }
}

Soubor šablony 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')]"
      }
    }
  ]
}

Soubor parametrů

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

Přidružení DCR – server s podporou arc

Následující ukázka vytvoří přidružení mezi serverem s podporou Azure Arc a pravidlem shromažďování dat.

Soubor šablony 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
  }
}

Soubor šablony 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')]"
      }
    }
  ]
}

Soubor parametrů

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

Úprava DCR

Pokud chcete upravit dcR, můžete použít některou z metod popsaných v předchozí části k vytvoření DCR pomocí upravené verze JSON.

Pokud potřebujete načíst JSON pro existující řadič domény, můžete ho zkopírovat ze zobrazení JSON pro DCR na webu Azure Portal. Můžete ho také načíst pomocí volání rozhraní API, jak je znázorněno v následujícím příkladu PowerShellu.

$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

Kurz, který vás provede procesem načítání a úprav existujícího řadiče domény, najdete v tématu Kurz: Úprava pravidla shromažďování dat (DCR).

Další kroky

• Přečtěte si o podrobné struktuře pravidla shromažďování dat.
• Získání podrobností o transformacích v pravidle shromažďování dat