Skapa en datainsamlingsregel (DCR) för måttexport

Den här artikeln beskriver hur du skapar en datainsamlingsregel (DCR) för måttexport med hjälp av mallarna Azure Portal, Azure CLI, PowerShell, API eller ARM.

Viktigt!

Om du vill skicka plattformstelemetridata till lagringskonton eller händelsehubbar måste resursen, datainsamlingsregeln och mållagringskontot eller händelsehubbarna finnas i samma region.

Portal

1. På menyn Övervaka i Azure Portal väljer du Regler för datainsamling och sedan Skapa.

2. Om du vill skapa en DCR för att samla in plattformsstatistikdata väljer du länken överst på sidan.

3. På sidan Skapa datainsamlingsregel anger du ett regelnamn, väljer en prenumeration, resursgrupp och region för DCR.

4. Välj Aktivera hanterad identitet om du vill skicka mått till ett lagringskonto eller händelsehubbar.

5. Välj Nästa

6. På sidan Resurser väljer du Lägg till resurser för att lägga till de resurser som du vill samla in mått från.

7. Välj Nästa för att gå till fliken Samla in och leverera .

8. Välj Lägg till nytt dataflöde

9. Resurstypen för den resurs som du valde i föregående steg väljs automatiskt. Lägg till fler resurstyper om du vill använda den här regeln för att samla in mått från flera resurstyper i framtiden.

10. Välj Nästa mål för att flytta till fliken Mål .

11. Om du vill skicka mått till en Log Analytics-arbetsyta väljer du Azure Monitor-loggar i listrutan Måltyp .

    1. Välj den prenumeration och log analytics-arbetsyta som du vill skicka måtten till.

12. Om du vill skicka mått till Event Hubs väljer du Händelsehubb i listrutan Måltyp .

    1. Välj prenumerationen, eventhubbens namnområde och händelsehubbens instansnamn.

13. Om du vill skicka mått till ett lagringskonto väljer du Lagringskonto i listrutan Måltyp .

    1. Välj prenumerationen, lagringskontot och blobcontainern där du vill lagra måtten.

    Kommentar

    Om du vill skicka mått till ett lagringskonto eller händelsehubbar måste resursen som genererar måtten, DCR och lagringskontot eller händelsehubben alla finnas i samma region.
    Om du vill skicka mått till en Log Analytics-arbetsyta måste DCR vara i samma region som Log Analytics-arbetsytan. Resursen som genererar måtten kan finnas i valfri region.

    Om du vill välja Lagringskonto eller Händelsehubbar som mål måste du aktivera hanterad identitet för DCR på fliken Grundläggande.

14. Välj Spara och välj sedan Granska + skapa.

CLI

Skapa en JSON-fil som innehåller samlingsregelspecifikationen. Mer information finns i DCR-specifikationer. Exempel på JSON-filer finns i Exempelmått Exportera JSON-objekt.

Viktigt!

Regelfilen har samma format som används för PowerShell och REST-API:et, men filen får inte innehålla identity, locationeller kind. Dessa parametrar anges i az monitor data-collection rule create kommandot .

Använd följande kommando för att skapa en datainsamlingsregel för mått med hjälp av Azure CLI.

az monitor data-collection rule create 
        --name 
        --resource-group 
        --location
        --kind PlatformTelemetry 
        --rule-file
        [--identity "{type:'SystemAssigned'}" ]

För lagringskonto och Event Hubs-mål måste du aktivera hanterad identitet för DCR med hjälp av --identity "{type:'SystemAssigned'}". Identitet krävs inte för Log Analytics-arbetsytor.

Ett exempel:

 az monitor data-collection rule create
    --name cli-dcr-001 
    --resource-group rg-001 
    --location centralus 
    --kind PlatformTelemetry 
    --identity "{type:'SystemAssigned'}" 
    --rule-file cli-dcr.json

id Kopiera dcr och principalId som ska användas för att tilldela rollen för att skapa en association mellan DCR och en resurs.

  "id": "/subscriptions/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f/resourceGroups/rg-001/providers/Microsoft.Insights/dataCollectionRules/cli-dcr-001",
  "identity": {
    "principalId": "eeeeeeee-ffff-aaaa-5555-666666666666",
    "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "type": "systemAssigned"
  },

Bevilja skrivbehörighet till den hanterade entiteten

Den hanterade identitet som används av DCR måste ha skrivbehörighet till målet när målet är ett lagringskonto eller händelsehubbar. Om du vill bevilja behörigheter för regelns hanterade entitet tilldelar du lämplig roll till entiteten.

I följande tabell visas de roller som krävs för varje måltyp:

Måltyp	Roll
Log Analytics-arbetsyta	krävs inte
Azure-lagringskonto	Storage Blob Data Contributor
Event Hubs	Azure Event Hubs Data Sender

Mer information om hur du tilldelar roller finns i Tilldela Azure-roller till en hanterad identitet. Om du vill tilldela en roll till en hanterad identitet med hjälp av CLI använder du az role assignment create. Mer information finns i Rolltilldelningar – Skapa

Tilldela lämplig roll till den hanterade identiteten för DCR.

az role assignment create --assignee <system assigned principal ID> \
                          --role <`Storage Blob Data Contributor` or `Azure Event Hubs Data Sender`  \
                          --scope <storage account ID or eventhub ID>

I följande exempel tilldelas Storage Blob Data Contributor rollen till den hanterade identiteten för DCR för ett lagringskonto.

az role assignment create --assignee eeeeeeee-ffff-aaaa-5555-666666666666 \
    --role "Storage Blob Data Contributor" \
    --scope /subscriptions/bbbb1b1b-cc2c-DD3D-ee4e-ffffff5f5f5f/resourceGroups/ed-rg-DCRTest/providers/Microsoft.Storage/storageAccounts/metricsexport001

Skapa en regelassociation för datainsamling

När du har skapat datainsamlingsregeln skapar du en datainsamlingsregelassociation (DCRA) för att associera regeln med den resurs som ska övervakas. Mer information finns i Regelassociationer för datainsamling – Skapa

Använd az monitor data-collection rule association create för att skapa en association mellan en datainsamlingsregel och en resurs.

az monitor data-collection rule association create --name 
                                                  --rule-id 
                                                  --resource 

I följande exempel skapas en association mellan en datainsamlingsregel och ett Key Vault.

az monitor data-collection rule association create --name "keyValut-001" \
    --rule-id "/subscriptions/bbbb1b1b-cc2c-DD3D-ee4e-ffffff5f5f5f/resourceGroups/rg-dcr/providers/Microsoft.Insights/dataCollectionRules/dcr-cli-001" \
    --resource "/subscriptions/bbbb1b1b-cc2c-DD3D-ee4e-ffffff5f5f5f/resourceGroups/rg-dcr/providers/Microsoft.KeyVault/vaults/keyVault-001"

PowerShell

Skapa en JSON-fil som innehåller samlingsregelspecifikationen. Mer information finns i DCR-specifikationer. Exempel på JSON-filer finns i Exempelmått Exportera JSON-objekt.

New-AzDataCollectionRule Använd kommandot för att skapa en datainsamlingsregel för mått med hjälp av PowerShell. Mer information finns i New-AzDataCollectionRule.

New-AzDataCollectionRule -Name 
                         -ResourceGroupName 
                         -JsonFilePath 

Ett exempel:

 New-AzDataCollectionRule -Name dcr-powershell-hub -ResourceGroupName rg-001 -JsonFilePath dcr-storage-account.json 

id Kopiera dcr och IdentityPrincipalId som ska användas för att tilldela rollen för att skapa en association mellan DCR och en resource.resource.

Id                                        : /subscriptions/bbbb1b1b-cc2c-DD3D-ee4e-ffffff5f5f5f/resourceGroups/rg-001/providers/Microsoft.Insights/dataCollectionRules/dcr-powershell-hub
IdentityPrincipalId                       : eeeeeeee-ffff-aaaa-5555-666666666666
IdentityTenantId                          : 0000aaaa-11bb-cccc-dd22-eeeeee333333
IdentityType                              : systemAssigned
IdentityUserAssignedIdentity              : {
                                            }

Bevilja skrivbehörighet till den hanterade entiteten

Den hanterade identitet som används av DCR måste ha skrivbehörighet till målet när målet är ett lagringskonto eller händelsehubbar. Om du vill bevilja behörigheter för regelns hanterade entitet tilldelar du lämplig roll till entiteten.

I följande tabell visas de roller som krävs för varje måltyp:

Måltyp	Roll
Log Analytics-arbetsyta	krävs inte
Azure-lagringskonto	Storage Blob Data Contributor
Event Hubs	Azure Event Hubs Data Sender

Mer information finns i Tilldela Azure-roller till en hanterad identitet. Information om hur du tilldelar en roll till en hanterad identitet med hjälp av PowerShell finns i New-AzRoleAssignment

Tilldela lämplig roll till den hanterade identiteten för DCR med hjälp av New-AzRoleAssignment.

New-AzRoleAssignment -ObjectId <objectId> -RoleDefinitionName <roleName> -Scope /subscriptions/<subscriptionId>/resourcegroups/<resourceGroupName>/providers/<providerName>/<resourceType>/<resourceSubType>/<resourceName>

I följande exempel tilldelas Azure Event Hubs Data Sender rollen till den hanterade identiteten för DCR på prenumerationsnivå.

New-AzRoleAssignment -ObjectId eeeeeeee-ffff-aaaa-5555-666666666666 -RoleDefinitionName "Azure Event Hubs Data Sender" -Scope /subscriptions/bbbb1b1b-cc2c-DD3D-ee4e-ffffff5f5f5f

Skapa en regelassociation för datainsamling

När du har skapat datainsamlingsregeln skapar du en datainsamlingsregelassociation (DCRA) för att associera regeln med den resurs som ska övervakas. Använd New-AzDataCollectionRuleAssociation för att skapa en association mellan en datainsamlingsregel och en resurs. Mer information finns i New-AzDataCollectionRuleAssociation

New-AzDataCollectionRuleAssociation
   -AssociationName <String>
   -ResourceUri <String>
   -DataCollectionRuleId <String>

I följande exempel skapas en association mellan en datainsamlingsregel och ett Key Vault.

New-AzDataCollectionRuleAssociation 
        -AssociationName keyVault-001-association
        -ResourceUri /subscriptions/bbbb1b1b-cc2c-DD3D-ee4e-ffffff5f5f5f/resourceGroups/rg-dcr/providers/Microsoft.KeyVault/vaults/keyVault-001 
        -DataCollectionRuleId /subscriptions/bbbb1b1b-cc2c-DD3D-ee4e-ffffff5f5f5f/resourceGroups/rg-dcr/providers/Microsoft.Insights/dataCollectionRules/vaultsDCR001

API

Skapa en datainsamlingsregel med hjälp av REST-API:et

Följande steg krävs för att skapa en datainsamlingsregel för mått:

1. Skapa datainsamlingsregeln.
2. Bevilja behörigheter för regelns hanterade entitet att skriva till målet
3. Skapa en regelassociation för datainsamling.

Skapa datainsamlingsregeln

Om du vill skapa en DOMÄNKONTROLLant med hjälp av REST-API:et måste du göra en autentiserad begäran med hjälp av en ägartoken. Mer information om autentisering med Azure Monitor finns i Autentisera Azure Monitor-begäranden.

Använd följande slutpunkt för att skapa en datainsamlingsregel för mått med hjälp av REST-API:et. Mer information finns i Datainsamlingsregler – Skapa.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dataCollectionRuleName}?api-version=2023-03-11

Till exempel

https://management.azure.com/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/rg-001/providers/Microsoft.Insights/dataCollectionRules/dcr-001?api-version=2023-03-11

Nyttolasten är ett JSON-objekt som definierar en samlingsregel. Nyttolasten skickas i brödtexten i begäran. Mer information om JSON-strukturen finns i DCR-specifikationer. Exempel på DCR JSON-objekt finns i Exportera JSON-exempelmått

Bevilja skrivbehörighet till den hanterade entiteten

Den hanterade identitet som används av DCR måste ha skrivbehörighet till målet när målet är ett lagringskonto eller händelsehubbar. Om du vill bevilja behörigheter för regelns hanterade entitet tilldelar du lämplig roll till entiteten.

I följande tabell visas de roller som krävs för varje måltyp:

Måltyp	Roll
Log Analytics-arbetsyta	krävs inte
Azure-lagringskonto	Storage Blob Data Contributor
Event Hubs	Azure Event Hubs Data Sender

Mer information finns i Tilldela Azure-roller till en hanterad identitet. Information om hur du tilldelar en roll till en hanterad identitet med hjälp av REST finns i Rolltilldelningar – Skapa

Skapa en regelassociation för datainsamling

När du har skapat datainsamlingsregeln skapar du en datainsamlingsregelassociation (DCRA) för att associera regeln med den resurs som ska övervakas. Mer information finns i Regelassociationer för datainsamling – Skapa

Om du vill skapa en DCRA med rest-API:et använder du följande slutpunkt och nyttolast:

PUT https://management.azure.com/{resourceUri}/providers/Microsoft.Insights/dataCollectionRuleAssociations/{associationName}?api-version=2022-06-0

Brödtext:

{ 
        "properties":  
        { 
          "description": "<DCRA description>", 
          "dataCollectionRuleId": "/subscriptions/{subscriptionId}/resourceGroups/{resource group name}/providers/Microsoft.Insights/dataCollectionRules/{DCR name}" 
        } 
}

Ett exempel:

https://management.azure.com//subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/rg-001/providers/Microsoft.Compute/virtualMachines/vm002/providers/Microsoft.Insights/dataCollectionRuleAssociations/dcr-la-ws-vm002?api-version=2023-03-11

{ 
        "properties":  
        { 
          "description": "Association of platform telemetry DCR with VM vm002", 
          "dataCollectionRuleId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/rg-001/providers/Microsoft.Insights/dataCollectionRules/dcr-la-ws" 
        } 
} 

ARM-mall

Använd följande mall för att skapa en DCR. Mer information finns i Microsoft.Insights-dataCollectionRules

Mallfil

{
    "$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')]",
            "kind": "PlatformTelemetry",
              "identity": {
                 "type": "userassigned" | "systemAssigned", 
                 "userAssignedIdentities": { 
		        			 "type": "string"
                   }    
                 },
            "location": "[parameters('location')]",
            "apiVersion": "2023-03-11",
            "properties": {
                "dataSources": {
                    "platformTelemetry": [
                        {
                            "streams": [
                                 "<resourcetype>:<metric name> | Metrics-Group-All"
                            ],
                            "name": "myPlatformTelemetryDataSource"
                        }
                    ]
                },
                "destinations": {
                    "logAnalytics": [
                        {
                            "workspaceResourceId": "[parameters('workspaceId')]",
                            "name": "myDestination"
                        }
                    ]
                },
                "dataFlows": [
                    {
                        "streams": [
                            "<resourcetype>:<metric name> | Metrics-Group-All"
                        ],
                        "destinations": [
                            "myDestination"
                        ]
                    }
                ]
            }
        }
    ]
}

Parameterfil

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "dataCollectionRuleName": {
            "value": "metrics-dcr-001"
        },
        "workspaceId": {
            "value": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/azuremonitorworkspaceinsights/providers/microsoft.operationalinsights/workspaces/amw-insight-ws"
        },
        "location": {
            "value": "eastus"
        }    
    }
}

Exempel på DCR-mall:

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "type": "Microsoft.Insights/dataCollectionRules",
            "apiVersion": "2023-03-11",
            "name": "[parameters('dataCollectionRuleName')]",
            "location": "[parameters('location')]",
            "kind": "PlatformTelemetry",
            "identity": {
                "type": "SystemAssigned"
            },
            "properties": {
                "dataSources": {
                    "platformTelemetry": [
                        {
                            "streams": [
                                "Microsoft.Compute/virtualMachines:Metrics-Group-All",
                                "Microsoft.Compute/virtualMachineScaleSets:Metrics-Group-All",
                                "Microsoft.Cache/redis:Metrics-Group-All",
                                "Microsoft.keyvault/vaults:Metrics-Group-All"
                            ],
                            "name": "myPlatformTelemetryDataSource"
                        }
                    ]
                },
                "destinations": {
                    "logAnalytics": [
                        {
                            "workspaceResourceId": "[parameters('workspaceId')]",
                            "name": "myDestination"
                        }
                    ]
                },
                "dataFlows": [
                    {
                        "streams": [
                            "Microsoft.Compute/virtualMachines:Metrics-Group-All",
                            "Microsoft.Compute/virtualMachineScaleSets:Metrics-Group-All",
                            "Microsoft.Cache/redis:Metrics-Group-All",
                            "Microsoft.keyvault/vaults:Metrics-Group-All"
                        ],
                        "destinations": [
                            "myDestination"
                        ]
                    }
                ]
            }
        }
    ]
}

När du har skapat DCR och DCRA kan du tillåta upp till 30 minuter för att de första plattformsstatistikdata ska visas i Log Analytics-arbetsytan. När data börjar flöda är svarstiden för en tidsserie för plattformsmått som flödar till en Log Analytics-arbetsyta, lagringskonto eller händelsehubbar cirka 3 minuter, beroende på resurstyp.

Verifiera och felsöka datainsamling

När du har installerat DCR kan det ta flera minuter innan ändringarna börjar gälla och data samlas in med den uppdaterade DOMÄNKONTROLLanten. Om du inte ser några data som samlas in kan det vara svårt att fastställa rotorsaken till problemet. Använd DCR-övervakningsfunktionerna, som innehåller mått och loggar för att felsöka.

DCR-mått samlas in automatiskt för alla domänkontrollanter och du kan analysera dem med hjälp av Metrics Explorer, till exempel plattformsmått för andra Azure-resurser. Aktivera DCR-felloggar för att få detaljerad felinformation när databearbetningen inte lyckas.

Om du inte ser att data samlas in följer du de här grundläggande stegen för att felsöka problemet.

1. Kontrollera mått som Logs Ingestion Bytes per Min och Logs Rows Received per Min för att säkerställa att data når Azure Monitor. Om inte kontrollerar du datakällan för att se till att den skickar data som förväntat.
2. Kontrollera Logs Rows Dropped per Min om några rader tas bort. Detta kan inte tyda på ett fel eftersom raderna kan tas bort av en transformering. Om de borttagna raderna är samma som Logs Rows Dropped per Min men matas inga data in på arbetsytan. Logs Transformation Errors per Min Granska för att se om det finns några transformeringsfel.
3. Kontrollera Logs Transformation Errors per Min om det finns några fel från transformeringar som tillämpas på inkommande data. Detta kan bero på ändringar i datastrukturen eller själva omvandlingen.
4. Kontrollera tabellen DCRLogErrors efter eventuella inmatningsfel som kan ha loggats. Detta kan ge ytterligare information om hur du identifierar rotorsaken till problemet.

Nästa steg

• Läs mer om den detaljerade strukturen för en datainsamlingsregel
• Hämta information om transformeringar i en datainsamlingsregel