Export metrik prostřednictvím pravidel shromažďování dat (Preview)

Článek
09/23/2024

Pravidla shromažďování dat (DCR) se používají ke shromažďování dat monitorování z vašich prostředků Azure. Seznam scénářů shromažďování dat najdete v tématu Pravidla shromažďování dat – Přehled. K shromažďování a exportu metrik platformy teď můžete použít řadiče domény.

V současné době je možné shromažďovat metriky platformy pomocí DCR i nastavení diagnostiky. Rostoucí počet prostředků podporuje export metrik pomocí řadičů domény. Seznam podpůrných prostředků najdete v části Podporované prostředky a oblasti .

Použití dcr k exportu metrik poskytuje následující výhody oproti nastavení diagnostiky:

Konfigurace DCR umožňuje exportovat metriky s dimenzemi.
Konfigurace DCR umožňuje filtrování na základě názvu metriky, abyste mohli exportovat jenom metriky, které potřebujete.
Řadiče domény jsou flexibilnější a škálovatelné v porovnání s nastavením diagnostiky.
Koncová latence pro řadiče domény je do 3 minut. Jedná se o významné vylepšení nastavení diagnostiky, kdy latence exportu metrik je 6 až 10 minut.

K průběžnému exportu dat metrik použijte export metrik prostřednictvím DCR. K dotazování historických dat použijte rozhraní API batch metrik roviny dat. Porovnání těchto dvou služeb najdete v tématu Dotaz rozhraní API batch metrik roviny dat a export metrik.

Vytvořte dcrs pro metriky pomocí rozhraní REST API, Azure CLI nebo Azure PowerShellu. Informace o tom, jak vytvořit řadiče domény pro export metrik, najdete v tématu Vytváření pravidel shromažďování dat pro metriky.

Při vytváření DCR musíte vytvořit přidružení pravidla shromažďování dat (DCRA) pro přidružení DCR k prostředku, který se má monitorovat. Pro mnoho typů prostředků můžete vytvořit jeden řadič domény. Informace o tom, jak vytvořit DCRA, naleznete v tématu Vytvoření přidružení pravidel shromažďování dat. Při použití webu Azure Portal se DCRA vytvoří automaticky.

Poznámka:

Najednou je možné používat řadiče domény a nastavení diagnostiky. Doporučujeme zakázat nastavení diagnostiky pro metriky při použití řadičů domény, abyste se vyhnuli duplicitnímu shromažďování dat.

Export cílů

Metriky je možné exportovat do jednoho z následujících cílů na řadič domény:

Pracovní prostory služby Log Analytics
Export do pracovních prostorů Log Analytics může být napříč oblastmi. Pracovní prostor služby Log Analytics a řadič domény musí být ve stejné oblasti, ale monitorované prostředky můžou být v libovolné oblasti. Metriky odeslané do pracovního prostoru služby Log Analytics se ukládají v AzureMetricsV2 tabulce.
Účty úložiště Azure.
Účet úložiště, řadič domény a monitorované prostředky musí být ve stejné oblasti.
Event Hubs.
Služba Event Hubs, DCR a monitorované prostředky musí být ve stejné oblasti.

Ukázku dat v každém cíli najdete v tématu Exportovaná data.

Poznámka:

Latence pro export metrik je přibližně 3 minuty. Počkejte až 15 minut, než se metriky začnou zobrazovat v cíli po počátečním nastavení.

Omezení

Řadiče domény pro export metrik mají následující omezení:

Pro každý řadič domény je možné zadat pouze jeden cílový typ.
K jednomu prostředku Azure je možné přidružit maximálně 5 řadičů domény.

Podporované prostředky a oblasti

Následující zdroje informací podporují export metrik pomocí pravidel shromažďování dat:

Typ prostředku	Specifikace streamu
Škálovací sady virtuálních počítačů	Microsoft.compute/virtualmachinescalesets
Virtuální počítače	Microsoft.compute/virtualmachines
Redis Cache	Microsoft.cache/redis
IoT Hubs	Microsoft.devices/iothubs
Trezory klíčů	Microsoft.keyvault/vaults
Účty úložiště	Microsoft.storage/storageaccounts Microsoft.storage/Storageaccounts/blobservices Microsoft.storage/storageaccounts/fileservices Microsoft.storage/storageaccounts/queueservices Microsoft.storage/storageaccounts/tableservices
SQL Server	Microsoft.sql/servery Microsoft.sql/ servery/ databáze
Operational Insights	Microsoft.operationalinsights/workspaces
Media Services	Microsoft.media/mediaservices Microsoft.media/mediaservices/streamingendpoints Microsoft.media/mediaservices/liveevents
Ochrana dat	Microsoft.dataprotection/backupvaults
Azure Kubernetes Service	Microsoft.ContainerService/managedClusters

Podporované oblasti

Můžete vytvořit řadič domény pro export metrik v libovolné oblasti, ale prostředky, ze kterých chcete exportovat metriky, musí být v jedné z následujících oblastí:

Austrálie – východ
USA – střed
CentralUsEuap
Středojižní USA
East US
USA – východ 2
Eastus2Euap
USA – západ
Západní USA 2
Severní Evropa
West Europe
Velká Británie – jih

Specifikace DCR

Pravidla shromažďování dat jsou definována v objektu JSON. K vytvoření DCR pro export metrik se vyžadují následující vlastnosti.

Vlastnost	Popis
`dataSources.platformTelemetry.streams`	Zobrazí seznam typů prostředků a metrik. Určete `Metrics-Group-All` , jestli chcete shromáždit všechny metriky pro prostředek, nebo zadat jednotlivé metriky. Formát: `<resource type>:Metrics-Group-All \| <metric name>` Například `Microsoft.Compute/virtualMachines:Percentage CPU`
`dataSources.platformTelemetry.name`	Název zdroje dat.
`destinations`	Cíl pro metriky. Na řadič domény se podporuje jenom jeden cíl. Platné typy cílů: `storageAccounts` `logAnalytics` `eventHubs`
`dataflows.streams`	Seznam datových proudů, které se mají předat cíli ve formátu: `<resource type>:Metrics-Group-All \|<metric name>` Například Microsoft.Compute/virtualMachines:Percentage CPU
`dataflows.destinations`	Cílem předat datové proudy tak, jak je definováno `destinations` ve vlastnosti.
`identity.type`	Typ identity, který se má použít pro DCR. Vyžaduje se pro cíle účtu úložiště. Platné hodnoty: `systemAssigned` `userAssigned`
`kind`	Druh pravidla shromažďování dat. Nastavte na `PlatformTelemetry` export metrik.
`location`	Umístění DCR.

Poznámka:

Pro každý řadič domény je možné zadat pouze jeden cílový typ.

Formát JSON pro export DCR pro metriky

K vytvoření DCR pro export metrik použijte formát v následujícím obecném objektu JSON. Při kopírování příkladu odeberte nežádoucí cíle.

{
    "properties": {
        "dataSources": {
            "platformTelemetry": [
                {
                    "streams": [
                    // a list of resource types and metrics to collect metrics from
                        "<resourcetype>:<metric name> | Metrics-Group-All", 
                        "<resourcetype>:<metric name> | Metrics-Group-All"
                    ],
                    "name": "<data sources name>"
                }
            ]
        },
        "destinations": {
            // Choose a single destination type of either logAnalytics, storageAccounts, or eventHubs
            "logAnalytics": [
                {
                    "workspaceResourceId": "workspace Id",
                    "name": "<destination name>"
                }
            ],    
            "storageAccounts": [
                {
                    "storageAccountResourceId": "<storage account Id>", 
                    "containerName": "<container name>",
                    "name": "<destination name>"
                }
            ],
            "eventHubs": [ 
                 { 
                    "eventHubResourceId": "event hub id", 
                     "name": "<destination name>" 
                 } 
             ],     },
        "dataFlows": [
            {
                "streams": [
                 // a list of resource types and metrics to pass to the destination
                        "<resourcetype>:<metric name> | Metrics-Group-All", 
                        "<resourcetype>:<metric name> | Metrics-Group-All"               
                         ],
                "destinations": [
                    "<destination name>"               
                ]
            }
        ]
    },
    // identity is required for Storage Account and Event Hubs destinations
    "identity": {
         "type": "userassigned", 
         "userAssignedIdentities": { 
					 "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/rg-001/providers/Microsoft.ManagedIdentity/userAssignedIdentities/DRCIdentity": {} 
         }    
    },
"kind": "PlatformTelemetry",
    "location": "eastus"
}

Poznámka:

Při vytváření DCR pro export metrik pomocí rozhraní příkazového řádku kindlocation, a jsou předány jako argumenty a identity musí být odebrány z objektu JSON.

Identity přiřazené uživatelem a systémem

Identita přiřazená uživatelem i systémem se podporuje při vytváření DRS. Identita se vyžaduje pro cíle účtu úložiště a služby Event Hubs. Můžete použít identitu přiřazenou systémem nebo přiřazenou uživatelem. Další informace najdete v tématu Přiřazení rolí Azure ke spravované identitě.

Pokud chcete použít identitu přiřazenou systémem, přidejte identity objekt následujícím způsobem:

    "identity": {
         "type": "systemAssigned"
    },

Pokud chcete použít identitu přiřazenou uživatelem, přidejte identity objekt následujícím způsobem:

    "identity": {
         "type": "userassigned", 

         "userAssignedIdentities": { 
           "/subscriptions/<subscriptionId>/resourceGroups/<resource group name>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<identity name>": {} 
         }    

    }

Filtrování metrik

Při zadávání metrik, které se mají exportovat, můžete metriky filtrovat podle názvu nebo vyžádat všechny metriky pomocí Metrics-Group-All. Seznam podporovaných metrik najdete v tématu Podporované metriky a kategorie protokolů podle typu prostředku.

Pokud chcete zadat více než jednu metriku ze stejného typu prostředku, vytvořte pro každou metriku samostatnou položku datového proudu.

Následující příklad ukazuje, jak filtrovat metriky podle názvu.

{
    "properties": {
        "dataSources": {
            "platformTelemetry": [
                {
                    "streams": [
                        "Microsoft.Compute/virtualMachines:Percentage CPU",
                        "Microsoft.Compute/virtualMachines:Disk Read Bytes",
                        "Microsoft.Compute/virtualMachines:Inbound Flows",  
                        "Microsoft.Compute/virtualMachineScaleSets:Percentage CPU",
                        "Microsoft.Cache/redis:Cache Hits"
                    ],
                    "name": "myPlatformTelemetryDataSource"
                }
            ]
        },
        "destinations": {
            "logAnalytics": [
                {
                    "workspaceResourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/arg-001/providers/microsoft.operationalinsights/workspaces/loganalyticsworkspace001",
                    "name": "destinationName"
                }
            ]
        },
        "dataFlows": [
            {
                "streams": [
                    "Microsoft.Compute/virtualMachines:Percentage CPU",
                    "Microsoft.Compute/virtualMachines:Disk Read Bytes",
                    "Microsoft.Compute/virtualMachines:Inbound Flows",
                    "Microsoft.Compute/virtualMachineScaleSets:Percentage CPU",
                    "Microsoft.Cache/redis:Cache Hits"
                ],
                "destinations": [
                    "destinationName"
                ]
            }
        ]
    },
    "kind": "PlatformTelemetry",
    "location": "eastus"
}

Ukázkové metriky exportu objektů JSON

Následující příklady ukazují ukázkové objekty JSON DCR pro export metrik do každého cílového typu.

Pracovní prostory služby Log Analytics

Následující příklad ukazuje pravidlo shromažďování dat pro metriky, které odesílají konkrétní metriky z virtuálních počítačů, škálovacích sad virtuálních počítačů a všechny metriky trezoru klíčů do pracovního prostoru služby Log Analytics:

{
    "properties": {
        "dataSources": {
            "platformTelemetry": [
                {
                    "streams": [
                        "Microsoft.Compute/virtualMachines:Percentage CPU",
                        "Microsoft.Compute/virtualMachines:Disk Read Bytes",
                        "Microsoft.Compute/virtualMachines:Inbound Flows",
                        "Microsoft.Compute/virtualMachineScaleSets:Available Memory Bytes",
                         "Microsoft.KeyVault/vaults:Metrics-Group-All"
                    ],
                    "name": "myPlatformTelemetryDataSource"
                }
            ]
        },
        "destinations": {
            "logAnalytics": [ 
                { 
                    "workspaceResourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/rg-001/providers/microsoft.operationalinsights/workspaces/laworkspace001", 
                    "name": "ladestination" 
                } 
            ] 
        },
        "dataFlows": [
            {
                "streams": [
                        "Microsoft.Compute/virtualMachines:Percentage CPU",
                        "Microsoft.Compute/virtualMachines:Disk Read Bytes",
                        "Microsoft.Compute/virtualMachines:Inbound Flows",
                        "Microsoft.Compute/virtualMachineScaleSets:Available Memory Bytes",
                        "Microsoft.KeyVault/vaults:Metrics-Group-All"
                        ],    
                "destinations": [
                    "ladestination"
                    
                ]
            }
        ]
    },

"kind": "PlatformTelemetry",
    "location": "centralus"
}

Účty úložiště

Následující příklad ukazuje pravidlo shromažďování dat pro metriky, které odesílajíPercentage CPU, Disk Read Bytesa Inbound Flows metriky z virtuálních počítačů a všechny metriky pro škálovací sady virtuálních počítačů, mezipaměť Redis a trezory klíčů do účtu úložiště.

{
    "properties": {
        "dataSources": {
            "platformTelemetry": [
                {
                    "streams": [
                        "Microsoft.Compute/virtualMachines:Percentage CPU",
                        "Microsoft.Compute/virtualMachines:Disk Read Bytes",
                        "Microsoft.Compute/virtualMachines:Inbound Flows"
                        "Microsoft.Compute/virtualMachineScaleSets:Metrics-Group-All",
                        "Microsoft.Cache/redis:Metrics-Group-All",
                        "Microsoft.keyvault/vaults:Metrics-Group-All"
                    ],
                    "name": "myPlatformTelemetryDataSource"
                }
            ]
        },
        "destinations": {
            "storageAccounts": [
                {
                    "storageAccountResourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/rg-001/providers/Microsoft.Storage/storageAccounts/metricsexport001",
                    "containerName": "metritcs-001",
                    "name": "desitnationName"
                }
            ]
        },
        "dataFlows": [
            {
                "streams": [
                    "Microsoft.Compute/virtualMachines:Percentage CPU",
                    "Microsoft.Compute/virtualMachines:Disk Read Bytes",
                    "Microsoft.Compute/virtualMachines:Inbound Flows"
                    "Microsoft.Compute/virtualMachineScaleSets:Metrics-Group-All",
                    "Microsoft.Cache/redis:Metrics-Group-All",
                    "Microsoft.keyvault/vaults:Metrics-Group-All"
                ],
                "destinations": [
                    "desitnationName"
                ]
            }
        ]
    },
    "identity": {
         "type": "systemAssigned"
    },
"kind": "PlatformTelemetry",
    "location": "eastus2"
}

Event Hubs

Následující příklad ukazuje pravidlo shromažďování dat pro export metrik, které odesílá všechny metriky z virtuálních počítačů, a ServiceApiHit Availability metriky ze služby Key Vault do služby Event Hubs.

{
    "properties": {
        "dataSources": {
            "platformTelemetry": [
                {
                    "streams": [
                        "Microsoft.Compute/virtualMachines:Metrics-Group-All",
                        "Microsoft.keyvault/vaults:ServiceApiHit",
                        "Microsoft.keyvault/vaults:Availability"

                    ],
                    "name": "myPlatformTelemetryDataSource"
                }
            ]
        },
        "destinations": {
            "eventHubs": [ 
                { 
                    "eventHubResourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/rg-001/providers/Microsoft.EventHub/namespaces/event-hub-001/eventhubs/hub-001", 
                    "name": "hub1" 
                } 
           ] 
        },
        "dataFlows": [
            {
                "streams": [
                    "Microsoft.Compute/virtualMachines:Metrics-Group-All",
                        "Microsoft.keyvault/vaults:ServiceApiHit",
                        "Microsoft.keyvault/vaults:Availability"
                ],
                "destinations": [
                    "hub1"
                ]
            }
        ]
    },
    "identity": {
         "type": "systemAssigned"
    },
"kind": "PlatformTelemetry",
    "location": "eastus"
}

Vytvoření dcr pro export metrik

Vytváření DCR pro export metrik pomocí webu Azure Portal, rozhraní příkazového řádku, PowerShellu, rozhraní REST API nebo šablony ARM Další informace najdete v tématu Vytvoření a úprava pravidel shromažďování dat (DCR) a přidružení ve službě Azure Monitor.

Exportovaná data

Následující příklady ukazují data exportovaná do každého cíle.

Pracovní prostory Log Analytics

Data exportovaná do pracovního prostoru služby Log Analytics jsou uložená v AzureMetricsV2 tabulce v pracovním prostoru služby Log Analytics v následujícím formátu:

Column	Type	Popis
Průměr	real	Průměrná hodnota shromážděná během časového rozsahu
_BilledSize	real	Velikost záznamu v bajtech
Počet	real	Počet vzorků shromážděných během časového rozsahu
Dimenze	dynamic	Přidružená dimenze metriky ve formátu JSON
_IsBillable	string	Určuje, jestli je ingestování dat fakturovatelné. Pokud se příjem dat _IsBillable `false` neúčtuje vašemu účtu Azure
Maximum	real	Maximální hodnota shromážděná během časového rozsahu.
MetricCategory	string	Název kategorie metriky
Název metriky	string	Zobrazovaný název metriky
MetricResourceType	string	Typ prostředku prostředku Azure, který hlásí metriku.
Minimum	real	Minimální hodnota shromážděná během časového rozsahu.
_ResourceId	string	Jedinečný identifikátor prostředku, ke kterému je záznam přidružený
SourceSystem	string	Typ agenta, který událost shromáždil. Například `OpsManager` pro agenta Windows, přímé připojení nebo Operations Manager, `Linux` pro všechny agenty Linuxu nebo `Azure` pro diagnostiku Azure
_SubscriptionId	string	Jedinečný identifikátor předplatného, ke kterému je záznam přidružený
TenantId	string	ID pracovního prostoru služby Log Analytics
TimeGenerated	datetime	Časové razítko (UTC) při vygenerování záznamu
TimeGrain	string	Časové intervaly metriky.
Celkem	real	Součet všech hodnot v časovém rozsahu
Typ	string	Název tabulky
UnitName	string	Jednotka metriky

Příklad:

Účty úložiště

Následující příklad ukazuje data exportovaná do účtu úložiště:

{
    "Average": "31.5",
    "Count": "2",
    "Maximum": "52",
    "Minimum": "11",
    "Total": "63",
    "resourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/rg-dcrs/providers/microsoft.keyvault/vaults/dcr-vault",
    "time": "2024-08-20T14:13:00.0000000Z",
    "unit": "MilliSeconds",
    "metricName": "ServiceApiLatency",
    "timeGrain": "PT1M",
    "dimension": {
        "ActivityName": "vaultget",
        "ActivityType": "vault",
        "StatusCode": "200",
        "StatusCodeClass": "2xx"
    }
}

Event Hubs

Následující příklad ukazuje metriku exportovanou do služby Event Hubs.

    {
      "Average": "1",
      "Count": "1",
      "Maximum": "1",
      "Minimum": "1",
      "Total": "1",
      "resourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/rg-dcrs/providers/microsoft.keyvault/vaults/dcr-vault",
      "time": "2024-08-22T13:43:00.0000000Z",
      "unit": "Count",
      "metricName": "ServiceApiHit",
      "timeGrain": "PT1M",
      "dimension": {
        "ActivityName": "keycreate",
        "ActivityType": "key"
      },
      "EventProcessedUtcTime": "2024-08-22T13:49:17.1233030Z",
      "PartitionId": 0,
      "EventEnqueuedUtcTime": "2024-08-22T13:46:04.5570000Z"
    }

Sdílet prostřednictvím

Export metrik prostřednictvím pravidel shromažďování dat (Preview)

Export cílů

Omezení

Podporované prostředky a oblasti

Podporované oblasti

Specifikace DCR

Formát JSON pro export DCR pro metriky

Identity přiřazené uživatelem a systémem

Filtrování metrik

Ukázkové metriky exportu objektů JSON

Pracovní prostory služby Log Analytics

Účty úložiště

Event Hubs

Vytvoření dcr pro export metrik

Exportovaná data

Pracovní prostory Log Analytics

Účty úložiště

Event Hubs

Další kroky

Váš názor

Další materiály