Создание и изменение правил сбора данных (DCR) в Azure Monitor

Существует несколько методов для создания правила сбора данных (DCR) в Azure Monitor. В некоторых случаях Azure Monitor создаст DCR и управляет им в соответствии с параметрами, настроенными в портал Azure. В других случаях может потребоваться создать собственные контроллеры домена для настройки конкретных сценариев.

В этой статье описаны различные методы создания и редактирования DCR. Сведения о содержимом самого DCR см. в разделе "Структура правила сбора данных" в Azure Monitor.

Разрешения

Для создания контроллеров домена и сопоставлений требуются следующие разрешения:

Встроенная роль	Области	Причина
Monitoring Contributor (Участник мониторинга)	Подписка и (или) Группа ресурсов и/или Существующий DCR	Создайте или измените контроллеры домена, назначьте правила компьютеру, разверните связи.
Участник виртуальной машины Администратор ресурсов Azure Connected Machine	Виртуальные машины и масштабируемые наборы виртуальных машин Серверы с поддержкой Azure Arc	Развертывание расширений агента на виртуальной машине.
Любая роль, которая включает действие Microsoft.Resources/deployments/*	Подписка и (или) Группа ресурсов и/или Существующий DCR	Развертывание шаблонов Azure Resource Manager.

Автоматизированные методы для создания DCR

В следующей таблице перечислены методы создания сценариев сбора данных с помощью портал Azure, в которой создается DCR. В этих случаях не требуется напрямую взаимодействовать с самим DCR.

Сценарий	Ресурсы	Description
Агент Azure Monitor	Настройка сбора данных для агента Azure Monitor	Используйте портал Azure для создания DCR, указывающего события и счетчики производительности для сбора с компьютера с помощью агента Azure Monitor. Затем свяжите это правило с одной или несколькими виртуальными машинами. Агент Azure Monitor будет установлен на всех компьютерах, которые в настоящее время не имеют его.
	Общие сведения о включении VM Insights	При включении аналитики виртуальных машин на виртуальной машине устанавливается агент Azure Monitor и создается DCR, который собирает предопределенный набор счетчиков производительности. Этот DCR не следует изменять.
Аналитика контейнеров	Включение службы аналитики контейнеров	При включении аналитики контейнеров в кластере Kubernetes устанавливается контейнерная версия агента Azure Monitor и создается DCR, которая собирает данные в соответствии с выбранной конфигурацией. Чтобы добавить преобразование, может потребоваться изменить этот DCR.
Текстовые журналы или журналы JSON	Сбор журналов из текстового или JSON-файла с помощью агента Azure Monitor	Используйте портал Azure для создания DCR для сбора записей из текстового журнала на компьютере с агентом Azure Monitor.

Создание DCR вручную

Чтобы создать DCR вручную, создайте JSON-файл с помощью соответствующей конфигурации для коллекции данных, которую вы настраиваете. Начните с одного из примеров контроллеров домена и используйте сведения в структуре правила сбора данных в Azure Monitor , чтобы изменить JSON-файл для конкретной среды и требований.

После создания JSON-файла можно использовать любой из следующих методов для создания DCR:

CLI

Используйте команду az monitor data-collection rule create, чтобы создать DCR из JSON-файла с помощью Azure CLI, как показано в следующем примере.

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

Используйте командлет New-AzDataCollectionRule, чтобы создать DCR из JSON-файла с помощью PowerShell, как показано в следующем примере.

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

API

Используйте API создания DCR для создания DCR из JSON-файла. Для вызова REST API можно использовать любой метод, как показано в следующих примерах.

$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

ARM

См. следующие ссылки на определение контроллеров домена и связей в шаблоне.

• Правила сбора данных
• Связи правил сбора данных

Используйте следующий шаблон, чтобы создать DCR с помощью сведений из структуры правила сбора данных в Azure Monitor и примеров правил сбора данных (DCR) в Azure Monitor для определения 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 с виртуальной машиной Azure

В следующем примере устанавливается связь между виртуальной машиной Azure и правилом сбора данных.

Файл шаблона 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
  }
}

Файл шаблона 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')]"
      }
    }
  ]
}

Файл параметров

{
  "$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 с сервером с поддержкой Arc

В следующем примере устанавливается связь между сервером с поддержкой Azure Arc и правилом сбора данных.

Файл шаблона 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
  }
}

Файл шаблона 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')]"
      }
    }
  ]
}

Файл параметров

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

Чтобы изменить DCR, можно использовать любой из методов, описанных в предыдущем разделе, для создания DCR с помощью измененной версии JSON.

Если необходимо получить JSON для существующего DCR, его можно скопировать из представления JSON для DCR в портал Azure. Его можно также получить с помощью вызова API, как показано в следующем примере 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

Руководство по извлечению и редактированию существующего DCR см. в руководстве по изменению правила сбора данных (DCR).

Следующие шаги

• Ознакомьтесь с подробной структурой правила сбора данных
• Получение сведений о преобразованиях в правиле сбора данных