إنشاء قواعد جمع البيانات (DCRs) وتحريرها في Azure Monitor

مقالة
11/16/2023

هناك أساليب متعددة لإنشاء قاعدة تجميع بيانات (DCR) في Azure Monitor. في بعض الحالات، سيقوم Azure Monitor بإنشاء DCR وإدارته وفقا للإعدادات التي تقوم بتكوينها في مدخل Microsoft Azure. في حالات أخرى، قد تحتاج إلى إنشاء DCRs لتخصيص سيناريوهات معينة.

توضح هذه المقالة الطرق المختلفة لإنشاء DCR وتحريره. للحصول على محتويات DCR نفسه، راجع بنية قاعدة تجميع البيانات في Azure Monitor.

الأذونات

تحتاج إلى الأذونات التالية لإنشاء DCRs والاقترانات:

الدور مدمج	النطاقات	السبب
المساهم في المراقبة	الاشتراك و/أو مجموعة الموارد و/أو DCR موجود	إنشاء DCRs أو تحريرها، وتعيين القواعد إلى الجهاز، ونشر الاقترانات.
مساهم الجهاز الظاهري مسؤول istrator لمورد الجهاز الاتصال Azure	أجهزة ظاهرية، مجموعات مقياس جهاز ظاهري الخوادم الممكنة بواسطة Azure Arc	نشر ملحقات العامل على الجهاز الظاهري.
أي دور يتضمن الإجراء Microsoft.Resources/التوزيع /*	الاشتراك و/أو مجموعة الموارد و/أو DCR موجود	توزيع قوالب Azure Resource Manager.

أساليب تلقائية لإنشاء DCR

يسرد الجدول التالي أساليب إنشاء سيناريوهات جمع البيانات باستخدام مدخل Microsoft Azure حيث يتم إنشاء DCR لك. في هذه الحالات، لا تحتاج إلى التفاعل مباشرة مع DCR نفسه.

السيناريو	الموارد	‏‏الوصف
عامل Azure Monitor	تكوين جمع البيانات لعامل Azure Monitor	استخدم مدخل Azure لإنشاء DCR يحدد الأحداث وعدادات الأداء لتجميعها من جهاز باستخدام عامل Azure Monitor. ثم إقران هذه القاعدة بجهاز ظاهري واحد أو أكثر. سيتم تثبيت Azure Monitor Agent على أي أجهزة لا تملكها حاليا.
	تمكين نظرة عامة على نتائج تحليلات الجهاز الظاهري	عند تمكين رؤى الجهاز الظاهري على جهاز ظاهري، يتم تثبيت عامل Azure Monitor، ويتم إنشاء DCR الذي يجمع مجموعة محددة مسبقا من عدادات الأداء. لا يجب تعديل DCR هذا.
نتائج تحليلات الحاوية	تمكين رؤى الحاوية	عند تمكين نتائج تحليلات الحاوية على مجموعة Kubernetes، يتم تثبيت إصدار حاوية من عامل Azure Monitor، ويتم إنشاء DCR يجمع البيانات وفقا للتكوين الذي حددته. قد تحتاج إلى تعديل DCR هذا لإضافة تحويل.
نص أو سجلات JSON	جمع السجلات من نص أو ملف JSON باستخدام عامل Azure Monitor	استخدم مدخل Microsoft Azure لإنشاء DCR لجمع الإدخالات من سجل نص على جهاز باستخدام عامل Azure Monitor.

إنشاء DCR يدويا

لإنشاء DCR يدويا، قم بإنشاء ملف JSON باستخدام التكوين المناسب لجمع البيانات التي تقوم بتكوينها. ابدأ بأحد نماذج DCRs واستخدم المعلومات في بنية قاعدة تجميع البيانات في Azure Monitor لتعديل ملف JSON للبيئة والمتطلبات الخاصة بك.

بمجرد إنشاء ملف JSON، يمكنك استخدام أي من الطرق التالية لإنشاء DCR:

استخدم الأمر 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'

استخدم New-AzDataCollectionRule cmdlet لإنشاء DCR من ملف JSON الخاص بك باستخدام PowerShell كما هو موضح في المثال التالي.

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

استخدم واجهة برمجة تطبيقات إنشاء DCR لإنشاء DCR من ملف JSON الخاص بك. يمكنك استخدام أي أسلوب لاستدعاء واجهة برمجة تطبيقات REST كما هو موضح في الأمثلة التالية.

$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

راجع المراجع التالية لتعريف DCRs والاقترانات في قالب.

استخدم القالب التالي لإنشاء DCR باستخدام معلومات من بنية قاعدة تجميع البيانات في Azure Monitor وعينة قواعد جمع البيانات (DCRs) في 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 VM

ينشئ النموذج التالي اقتراناً بين جهاز 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 Association -Arc-enabled server

ينشئ النموذج التالي اقتراناً بين خادم يدعم 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 في مدخل Microsoft Azure. يمكنك أيضا استرداده باستخدام استدعاء واجهة برمجة التطبيقات كما هو موضح في مثال 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).

Share via