Azure İzleyici'de veri toplama kuralları (DCR) oluşturma ve düzenleme

Azure İzleyici'de veri toplama kuralı (DCR) oluşturmak için birden çok yöntem vardır. Bazı durumlarda Azure İzleyici, DCR'yi Azure portalında yapılandırdığınız ayarlara göre oluşturur ve yönetir. Diğer durumlarda, belirli senaryoları özelleştirmek için kendi DCR'lerinizi oluşturmanız gerekebilir.

Bu makalede, DCR oluşturmak ve düzenlemek için farklı yöntemler açıklanmaktadır. DCR'nin içeriği için bkz . Azure İzleyici'de veri toplama kuralının yapısı.

İzinler

DCR'ler ve ilişkilendirmeler oluşturmak için aşağıdaki izinlere ihtiyacınız vardır:

Yerleşik rol	Kapsamlar	Nedeni
İzleme Katkıda Bulunanı	Abonelik ve/veya Kaynak grubu ve/veya Mevcut bir DCR	DCR'ler oluşturun veya düzenleyin, makineye kurallar atayın, ilişkileri dağıtın.
Sanal Makine Katılımcısı Azure Bağlan Ed Machine Resource Yönetici istrator	Sanal makineler, sanal makine ölçek kümeleri Azure Arc özellikli sunucular	VM'de aracı uzantılarını dağıtın.
Microsoft.Resources/deployments/ eylemini içeren herhangi bir rol*	Abonelik ve/veya Kaynak grubu ve/veya Mevcut bir DCR	Azure Resource Manager şablonlarını dağıtma.

DCR oluşturmak için otomatik yöntemler

Aşağıdaki tabloda, DCR'nin sizin için oluşturulduğu Azure portalını kullanarak veri toplama senaryoları oluşturma yöntemleri listelenmektedir. Bu gibi durumlarda doğrudan DCR ile etkileşim kurmanız gerekmez.

Senaryo	Kaynaklar	Açıklama
Azure İzleyici Aracısı	Azure İzleyici Aracısı için veri toplamayı yapılandırma	Azure İzleyici Aracısı ile bir makineden toplayacak olayları ve performans sayaçlarını belirten bir DCR oluşturmak için Azure portalını kullanın. Ardından bu kuralı bir veya daha fazla sanal makineyle ilişkilendirin. Azure İzleyici Aracısı, şu anda bu aracıya sahip olmayan tüm makinelere yüklenir.
	VM içgörülerini etkinleştirmeye genel bakış	Bir VM'de VM içgörülerini etkinleştirdiğinizde Azure İzleyici aracısı yüklenir ve önceden tanımlanmış bir performans sayaçları kümesi toplayan bir DCR oluşturulur. Bu DCR'de değişiklik yapmamalısınız.
Kapsayıcı içgörüleri	Kapsayıcı içgörülerini etkinleştirme	Kubernetes kümesinde Kapsayıcı içgörülerini etkinleştirdiğinizde, Azure İzleyici aracısının kapsayıcılı bir sürümü yüklenir ve seçtiğiniz yapılandırmaya göre veri toplayan bir DCR oluşturulur. Dönüştürme eklemek için bu DCR'yi değiştirmeniz gerekebilir.
Metin veya JSON günlükleri	Azure İzleyici Aracısı ile bir metinden veya JSON dosyasından günlükleri toplama	Azure İzleyici Aracısı ile bir makinedeki metin günlüğünden girdileri toplamak üzere DCR oluşturmak için Azure portalını kullanın.

El ile DCR oluşturma

El ile DCR oluşturmak için, yapılandırdığınız veri toplama için uygun yapılandırmayı kullanarak bir JSON dosyası oluşturun. Örnek DCR'lerden biriyle başlayın ve JSON dosyasını belirli ortamınıza ve gereksinimlerinize göre değiştirmek için Azure İzleyici'de veri toplama kuralının yapısı başlığı altında yer alan bilgileri kullanın.

JSON dosyasını oluşturduktan sonra, DCR'yi oluşturmak için aşağıdaki yöntemlerden herhangi birini kullanabilirsiniz:

CLI

Aşağıdaki örnekte gösterildiği gibi Azure CLI kullanarak JSON dosyanızdan DCR oluşturmak için az monitor data-collection rule create komutunu kullanın.

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

Aşağıdaki örnekte gösterildiği gibi PowerShell kullanarak JSON dosyanızdan DCR oluşturmak için New-AzDataCollectionRule cmdlet'ini kullanın.

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

API

JSON dosyanızdan DCR oluşturmak için DCR oluşturma API'sini kullanın. Aşağıdaki örneklerde gösterildiği gibi REST API'yi çağırmak için herhangi bir yöntemi kullanabilirsiniz.

$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

Şablonda DCR'leri ve ilişkilendirmeleri tanımlamak için aşağıdaki başvurulara bakın.

• Veri toplama kuralları
• Veri toplama kuralı ilişkilendirmeleri

Aşağıdaki şablonu kullanarak Azure İzleyici'de veri toplama kuralının yapısı ve Azure İzleyici'de Örnek veri toplama kuralları (DCR) dcr-properties bilgilerini kullanarak bir DCR oluşturun.

{
    "$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 İlişkilendirme -Azure VM

Aşağıdaki örnek, Azure sanal makinesi ile veri toplama kuralı arasında bir ilişki oluşturur.

Bicep şablon dosyası

@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 şablon dosyası

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

Parametre dosyası

{
  "$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 İlişkilendirmesi -Arc özellikli sunucu

Aşağıdaki örnek, Azure Arc özellikli bir sunucu ile veri toplama kuralı arasında bir ilişki oluşturur.

Bicep şablon dosyası

@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 şablon dosyası

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

Parametre dosyası

{
  "$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'yi düzenleme

DCR'yi düzenlemek için önceki bölümde açıklanan yöntemlerden herhangi birini kullanarak JSON'un değiştirilmiş bir sürümünü kullanarak DCR oluşturabilirsiniz.

Mevcut bir DCR için JSON almanız gerekiyorsa Azure portalında DCR için JSON Görünümü'nden kopyalayabilirsiniz. Aşağıdaki PowerShell örneğinde gösterildiği gibi api çağrısı kullanarak da alabilirsiniz.

$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

Var olan bir DCR'yi alma ve düzenleme işleminde yol gösteren bir öğretici için bkz . Öğretici: Veri toplama kuralını (DCR) düzenleme.

Sonraki adımlar

• Veri toplama kuralının ayrıntılı yapısı hakkında bilgi edinin
• Veri toplama kuralındaki dönüştürmelerle ilgili ayrıntıları alma