Sdílet prostřednictvím

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

  • Článek

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.
  • Export metrik podle dcR nepodporuje export hodinových metrik.

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"
}

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í pravidla shromažďování dat (DCR) pro export metrik.

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:

Snímek obrazovky s dotazem log Analytics tabulky AzureMetricsV2

Úč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"
    }

Další kroky