Adatgyűjtési szabályok (DCR-k) létrehozása és szerkesztése az Azure Monitorban

Cikk
04/04/2024

Az Azure Monitorban több módszer is létezik adatgyűjtési szabály (DCR) létrehozására. Bizonyos esetekben az Azure Monitor az Azure Portalon konfigurált beállításoknak megfelelően hozza létre és kezeli a DCR-t. Más esetekben előfordulhat, hogy saját DCR-eket kell létrehoznia az adott forgatókönyvek testreszabásához.

Ez a cikk a DCR létrehozásának és szerkesztésének különböző módszereit ismerteti. Magának a DCR-nek a tartalmáért lásd : Adatgyűjtési szabály felépítése az Azure Monitorban.

Engedélyek

A DCR-ek és társítások létrehozásához a következő engedélyek szükségesek:

Beépített szerepkör	Hatókörök	Ok
Figyelési közreműködő	Előfizetés és/vagy Erőforráscsoport és/vagy Meglévő DCR	DCR-ek létrehozása vagy szerkesztése, szabályok hozzárendelése a géphez, társítások üzembe helyezése.
Virtuális gépek közreműködője Azure Csatlakozás ed Machine Resource Rendszergazda istrator	Virtuális gépek, virtuálisgép-méretezési csoportok Azure Arc-kompatibilis kiszolgálók	Ügynökbővítmények üzembe helyezése a virtuális gépen.
Minden olyan szerepkör, amely tartalmazza a Microsoft.Resources/deployments/ műveletet *	Előfizetés és/vagy Erőforráscsoport és/vagy Meglévő DCR	Azure Resource Manager-sablonok üzembe helyezése.

Automatizált metódusok DCR létrehozásához

Az alábbi táblázat felsorolja azokat a módszereket, amelyek segítségével adatgyűjtési forgatókönyveket hozhat létre az Azure Portalon, ahol a DCR létrejön. Ezekben az esetekben nem kell közvetlenül a DCR-vel kommunikálnia.

Eset	Források	Leírás
Azure Monitor-ügynök	Adatgyűjtés konfigurálása az Azure Monitor-ügynökhöz	Az Azure Portal használatával hozzon létre egy olyan DCR-t, amely meghatározza az eseményeket és a teljesítményszámlálókat, amelyeket az Azure Monitor-ügynökkel gyűjthet egy gépről. Ezután társítsa a szabályt egy vagy több virtuális géppel. Az Azure Monitor Agent minden olyan gépre telepítve lesz, amely jelenleg nem rendelkezik vele.
	Virtuálisgép-elemzések áttekintése	Ha engedélyezi a virtuálisgép-elemzéseket egy virtuális gépen, a rendszer telepíti az Azure Monitor-ügynököt, és létrehoz egy DCR-t, amely előre definiált teljesítményszámlálókat gyűjt. Ezt a DCR-t nem szabad módosítania.
Tárolóelemzések	Tárolóelemzések engedélyezése	Ha engedélyezi a Container Insightst egy Kubernetes-fürtön, a rendszer telepíti az Azure Monitor-ügynök tárolóalapú verzióját, és létrehoz egy DCR-t, amely a kiválasztott konfigurációnak megfelelően gyűjt adatokat. Előfordulhat, hogy módosítania kell ezt a DCR-t egy átalakítás hozzáadásához.
Szöveg- vagy JSON-naplók	Naplók gyűjtése szövegből vagy JSON-fájlból az Azure Monitor-ügynökkel	Az Azure Portal használatával hozzon létre egy DCR-t, amellyel bejegyzéseket gyűjthet egy gép szöveges naplójából az Azure Monitor-ügynökkel.

DCR manuális létrehozása

A DCR manuális létrehozásához hozzon létre egy JSON-fájlt a konfigurálni kívánt adatgyűjtés megfelelő konfigurációja alapján. Kezdje az egyik minta DCR-vel , és használja az Adatokat az Azure Monitor adatgyűjtési szabályának struktúrájában az adott környezethez és követelményekhez tartozó JSON-fájl módosításához.

Miután létrehozta a JSON-fájlt, az alábbi módszerek bármelyikével létrehozhatja a DCR-t:

Az az monitor adatgyűjtési szabály létrehozási parancsával hozzon létre egy DCR-t a JSON-fájlból az Azure CLI használatával az alábbi példában látható módon.

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'

A New-AzDataCollectionRule parancsmaggal hozza létre a DCR-t a JSON-fájlból a PowerShell használatával, ahogyan az az alábbi példában látható.

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

A DCR create API használatával hozza létre a DCR-t a JSON-fájlból. Bármilyen módszerrel meghívhat REST API-t az alábbi példákban látható módon.

$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

A DCR-ek és társítások sablonban való definiálásával kapcsolatban tekintse meg az alábbi hivatkozásokat.

A következő sablonnal létrehozhat egy DCR-t egy adatgyűjtési szabály struktúraadataival az Azure Monitorban , valamint az Azure Monitor adatgyűjtő szabályainak (DCRs) adataival a dcr-propertiesdefinícióhoz.

{
    "$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-társítás – Azure-beli virtuális gép

Az alábbi minta társításokat hoz létre egy Azure-beli virtuális gép és egy adatgyűjtési szabály között.

Bicep-sablonfájl

@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-sablonfájl

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

Paraméterfájl

{
  "$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-társítás – Arc-kompatibilis kiszolgáló

Az alábbi minta társításokat hoz létre egy Azure Arc-kompatibilis kiszolgáló és egy adatgyűjtési szabály között.

Bicep-sablonfájl

@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-sablonfájl

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

Paraméterfájl

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

DCR szerkesztése

A DCR szerkesztéséhez az előző szakaszban ismertetett módszerek bármelyikével létrehozhat egy DCR-t a JSON módosított verziójával.

Ha le kell kérnie a JSON-t egy meglévő DCR-hez, az Azure Portalon a DCR JSON nézetéből másolhatja. A következő PowerShell-példában bemutatott API-hívással is lekérheti.

$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

A meglévő DCR beolvasásának és szerkesztésének folyamatát bemutató oktatóanyagért tekintse meg az oktatóanyagot: Adatgyűjtési szabály (DCR) szerkesztése.