Sdílet prostřednictvím

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

Pravidla shromažďování dat (DCR) se používají ke shromažďování monitorovacích dat z vašich prostředků na Azure. Seznam scénářů shromažďování dat najdete v tématu Pravidla shromažďování dat – Přehled. Nyní můžete k shromažďování a exportu metrik platformy použít DCRs.

V současné době je možné shromažďovat metriky platformy pomocí DCR i nastavení diagnostiky. Stále větší počet prostředků podporuje export metrik pomocí DCR. 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.
  • Pravidla sběru dat jsou flexibilnější a škálovatelnější v porovnání s diagnostickými nastaveními.
  • Latence od začátku do konce pro DCRs 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í na historická data použijte API metrik roviny dat Batch. Porovnání těchto dvou služeb najdete v tématu Dotaz batch rozhraní API metrik roviny dat versus export metrik.

Vytvořte dcrs pro metriky pomocí rozhraní REST API, Azure CLI nebo Azure PowerShellu. Informace o tom, jak vytvořit pravidla shromažďování dat 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 asociaci pravidla shromažďování dat (DCRA) pro spojení DCR s prostředkem k monitorování. Pro mnoho typů prostředků můžete vytvořit jeden DCR. 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:

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

Exportní destinace

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 služby Azure Storage

    Úč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í

Pravidla pro sběr dat pro export metrik mají následující omezení:

  • Pro jeden DCR lze zadat pouze jeden typ cíle.
  • K jednomu prostředku Azure je možné přidružit maximálně 5 DCR.
  • Export metrik podle DCR nepodporuje export hodinově zrnitý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 pro ukládání Microsoft.storage/storageaccounts
Microsoft.storage/Storageaccounts/blobservices
Microsoft.storage/storageaccounts/fileservices
Microsoft.storage/úložiště/účetyslužeb/frontýslužeb
Microsoft.storage/storageaccounts/tableservices
SQL Server Microsoft.sql/servery
Microsoft.sql/ servery/ databáze
Statistiky provozu Microsoft.operationalinsights/workspaces
Ochrana dat Microsoft.dataprotection/backupvaults
Azure Kubernetes Service Microsoft.ContainerService/spravovanéKlastry

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
  • Střední USA
  • CentralUsEuap
  • Jižní střed USA
  • Východní USA
  • Východní USA 2
  • Eastus2Euap
  • USA – západ
  • Západ USA 2
  • Severní Evropa
  • Západní Evropa
  • Spojené království – 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.

Vlastnictví 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>

Příklad: Microsoft.Compute/virtualMachines:Percentage CPU
dataSources.platformTelemetry.name Název zdroje dat.
destinations Cílové místo pro metriky. Na jeden DCR se podporuje pouze 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>

Příklad: Microsoft.Compute/virtualMachines:Percentage CPU
dataflows.destinations Cíl, kam předat datové proudy, jak je definováno ve vlastnosti destinations.
identity.type Typ identity, který se má použít pro DCR. Vyžaduje se pro úložné cíle účtu.
Platné hodnoty:
systemAssigned
userAssigned
kind Druh pravidla shromažďování dat. Nastavte na PlatformTelemetry pro export metrik.
location Umístění DCR.

Poznámka:

Pro jeden DCR lze zadat pouze jeden typ cíle.

Formát JSON pro export metrik DCR

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í příkazového řádku jsou kind, location a identity předány jako argumenty a musí být odebrány z objektu JSON.

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

Podporují se jak identita přiřazená uživatelem, tak identita přiřazená systémem při vytváření DCR. 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řte 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:

Sloupec Typ Popis
Průměr opravdový Průměrná hodnota shromážděná během časového rozsahu
_NaúčtovanáVelikost opravdový Velikost záznamu v bajtech.
Počet opravdový Počet vzorků shromážděných během časového rozsahu
Dimenze dynamický Přidružená dimenze metriky ve formátu JSON
_JeVyúčtovatelné řetězec Určuje, zda je ingestion dat zpoplatněna. Pokud je _IsBillable false, ingesce se na váš účet Azure neúčtuje
Maximálně opravdový Maximální hodnota shromážděná během časového rozsahu.
Kategorie metrika řetězec Název kategorie metriky
Název metriky řetězec Zobrazovaný název metriky
Typ metriky zdroje řetězec Typ prostředku Azure, který hlásí metriku.
Minimální opravdový Minimální hodnota shromážděná během časového rozsahu.
_ZdrojId řetězec Jedinečný identifikátor pro zdroj, se kterým je záznam spojen.
Zdrojový systém řetězec Typ agenta, pomocí kterého byla událost zaznamenána. Například OpsManager pro agenta Windows, buď pro přímé připojení nebo pro Operations Manager, Linux pro všechny agenty Linux nebo Azure pro Azure Diagnostics.
_ID předplatného řetězec Jedinečný identifikátor předplatného, ke kterému je záznam přidružený
Identifikátor nájemce (TenantId) řetězec ID pracovního prostoru služby Log Analytics
Čas vygenerování Datum a čas Časové razítko (UTC) při vygenerování záznamu
TimeGrain řetězec Časové intervaly metriky.
Celkem opravdový Součet všech hodnot v časovém rozsahu
Typ řetězec Název tabulky
Jméno jednotky řetězec Jednotka metriky

Například:

Snímek obrazovky s dotazem log Analytics tabulky AzureMetricsV2

Účty pro ukládání

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

Centra událostí

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