Megosztás a következőn keresztül:


Metrikák exportálása adatgyűjtési szabályokon keresztül (előzetes verzió)

Az adatgyűjtési szabályok (DCR-ek) segítségével monitorozási adatokat gyűjthet az Azure-erőforrásokból. Az adatgyűjtési forgatókönyvek listáját az Adatgyűjtési szabályok – Áttekintés című témakörben találja. Mostantól a DCR-ek használatával gyűjtheti és exportálhatja a platformmetrikákat.

A platformmetrikák jelenleg a DCR és a diagnosztikai beállítások használatával is gyűjthetők. Egyre több erőforrás támogatja a metrikák DCR-ekkel történő exportálását. A támogatott erőforrások listáját a Támogatott erőforrások és régiók című témakörben találja.

A metrikák exportálásához használt DCR-ek a következő előnyöket biztosítják a diagnosztikai beállításokkal szemben:

  • A DCR-konfiguráció lehetővé teszi a metrikák dimenziókkal való exportálását.
  • A DCR-konfiguráció lehetővé teszi a metrikanév alapján történő szűrést, így csak a szükséges metrikákat exportálhatja.
  • A DCR-ek rugalmasabbak és méretezhetők a diagnosztikai beállításokhoz képest.
  • A DCR-ek végpontok közötti késése 3 percen belül van. Ez jelentős előrelépés a diagnosztikai beállításoknál, ahol a metrikák exportálási késése 6–10 perc.

Metrikák DCR-en keresztüli exportálása a metrikák adatainak folyamatos exportálásához. Az előzményadatok lekérdezéséhez használja a Data plane Metrics Batch API-t. A két szolgáltatás összehasonlítása: Data plane Metrics Batch API-lekérdezés és Metrikák exportálása.

DCR-eket hozhat létre metrikákhoz a REST API, az Azure CLI vagy az Azure PowerShell használatával. A metrikák exportálásához szükséges DCR-ek létrehozásáról további információt a metrikák adatgyűjtési szabályainak létrehozása című témakörben talál.

DCR létrehozásakor létre kell hoznia egy adatgyűjtési szabálytársítást (DCRA) a DCR és a figyelendő erőforrás társításához. Számos erőforrástípushoz létrehozhat egyetlen DCR-t. A DCRA létrehozásáról további információt az adatgyűjtési szabálytársítások létrehozása című témakörben talál. Az Azure Portal használatakor a DCRA automatikusan létrejön.

Feljegyzés

A DCR-eket és a diagnosztikai beállításokat egyszerre is használhatja. Javasoljuk, hogy tiltsa le a metrikák diagnosztikai beállításait, ha DCR-eket használ az ismétlődő adatgyűjtés elkerülése érdekében.

Célhelyek exportálása

A metrikák DCR-enként az alábbi célok egyikére exportálhatók:

  • Log Analytics-munkaterületek.
    A Log Analytics-munkaterületekre való exportálás több régióra is kiterjedhet. A Log Analytics-munkaterületnek és a DCR-nek ugyanabban a régióban kell lennie, de a figyelt erőforrások bármelyik régióban lehetnek. A log analytics-munkaterületre küldött metrikákat a rendszer a AzureMetricsV2 táblában tárolja.

  • Azure Storage-fiókok.
    A tárfióknak, a DCR-nek és a figyelt erőforrásoknak ugyanabban a régióban kell lenniük.

  • Event Hubs.
    Az Event Hubsnak, a DCR-nek és a figyelt erőforrásoknak ugyanabban a régióban kell lenniük.

Az egyes célhelyek adatainak mintájáért tekintse meg az exportált adatokat.

Feljegyzés

A metrikák exportálásának késése körülbelül 3 perc. A kezdeti beállítás után akár 15 percet is hagyhat arra, hogy a metrikák megjelenjenek a célhelyen.

Korlátozások

A metrikák exportálásának DCR-jeire a következő korlátozások vonatkoznak:

  • DCR-enként csak egy céltípus adható meg.
  • Egyetlen Azure-erőforráshoz legfeljebb 5 DCR társítható.
  • A DCR által exportált metrikák nem támogatják az óránkénti szemcsés metrikák exportálását.

Támogatott erőforrások és régiók

Az alábbi erőforrások az adatgyűjtési szabályokkal támogatják a metrikák exportálását:

Erőforrás típusa Stream specifikációja
Virtuálisgép-méretezési csoportok Microsoft.compute/virtualmachinescalesets
Virtual machines (Virtuális gépek) Microsoft.compute/virtualmachines
Redis Cache Microsoft.cache/redis
IOT-központok Microsoft.devices/iothubs
Kulcstartók Microsoft.keyvault/vaults
Storage fiókok Microsoft.storage/storageaccounts
Microsoft.storage/Storageaccounts/blobservices
Microsoft.storage/storageaccounts/fileservices
Microsoft.storage/storageaccounts/queueservices
Microsoft.storage/storageaccounts/tableservices
SQL Server Microsoft.sql/kiszolgálók
Microsoft.sql/kiszolgálók/adatbázisok
Operational Insights Microsoft.operationalinsights/workspaces
Media services Microsoft.media/mediaservices
Microsoft.media/mediaservices/streamingendpoints
Microsoft.media/mediaservices/liveevents
Adatvédelem Microsoft.dataprotection/backupvaults
Azure Kubernetes Service Microsoft.ContainerService/managedClusters

Támogatott régiók

Bármely régióban létrehozhat egy DCR-t a metrikák exportálásához, de a metrikákat exportálni kívánt erőforrásoknak az alábbi régiók egyikében kell lenniük:

  • Kelet-Ausztrália
  • Az USA középső régiója
  • CentralUsEuap
  • USA déli középső régiója
  • USA keleti régiója
  • USA 2. keleti régiója
  • Eastus2Euap
  • USA nyugati régiója
  • USA 2. nyugati régiója
  • Észak-Európa
  • Nyugat-Európa
  • Az Egyesült Királyság déli régiója

DCR-specifikációk

Az adatgyűjtési szabályok egy JSON-objektumban vannak definiálva. A metrikák exportálásához szükséges DCR létrehozásához a következő tulajdonságok szükségesek.

Tulajdonság Leírás
dataSources.platformTelemetry.streams Felsorolja az erőforrástípusokat és a metrikákat. Adja meg Metrics-Group-All az erőforrás összes mérőszámának gyűjtését vagy az egyes metrikák megadását. Formátum: <resource type>:Metrics-Group-All | <metric name>
Például: Microsoft.Compute/virtualMachines:Percentage CPU
dataSources.platformTelemetry.name Az adatforrás neve.
destinations A metrikák célhelye. DCR-enként csak egy célhely támogatott.
Érvényes céltípusok:
storageAccounts
logAnalytics
eventHubs
dataflows.streams A célhelyre továbbítandó streamek listája a következő formátumban: <resource type>:Metrics-Group-All |<metric name>
Például: Microsoft.Compute/virtualMachines:Percentage CPU"
dataflows.destinations Az a cél, amely a streameket a tulajdonságban destinations meghatározottak szerint továbbítja.
identity.type A DCR-hez használandó identitástípus. A tárfiókok célhelyeihez szükséges.
Érvényes értékek:
systemAssigned
userAssigned
kind Az adatgyűjtési szabály típusa. PlatformTelemetry Metrikaexportálásra van beállítva.
location A DCR helye.

Feljegyzés

DCR-enként csak egy céltípus adható meg.

JSON-formátum a metrikák DCR-ének exportálásához

A következő általános JSON-objektum formátumával hozzon létre egy DCR-t a metrikák exportálásához. Távolítsa el a nem kívánt célhelyeket a példa másolása során.

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

Feljegyzés

A metrikák exportálására szolgáló DCR parancssori felülettel történő létrehozásakor a rendszer argumentumként adja át őket, kindlocationidentity és el kell távolítani a JSON-objektumból.

Felhasználóhoz és rendszerhez hozzárendelt identitások

A tartományvezérlők létrehozásakor a felhasználó és a rendszer által hozzárendelt identitások is támogatottak. A tárfiókok és az Event Hubs-célhelyek esetében identitásra van szükség. Használhat rendszer által hozzárendelt vagy felhasználó által hozzárendelt identitást. További információ: Azure-szerepkörök hozzárendelése felügyelt identitáshoz.

A rendszer által hozzárendelt identitás használatához adja hozzá az objektumot az identity alábbiak szerint:

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

Felhasználó által hozzárendelt identitás használatához adja hozzá az objektumot az identity alábbiak szerint:

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

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

    }

Metrikák szűrése

Az exportálni kívánt metrikák megadásakor név alapján szűrheti a metrikákat, vagy kérheti az összes metrikát a használatával Metrics-Group-All. A támogatott metrikák listáját a támogatott metrikák és naplókategóriák erőforrástípus szerint című témakörben találja.

Ha több metrikát szeretne megadni ugyanabból az erőforrástípusból, hozzon létre egy külön streamelemet az egyes metrikákhoz.

Az alábbi példa bemutatja, hogyan szűrheti a metrikákat név szerint.

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

Mintametrikák JSON-objektumok exportálása

Az alábbi példák az egyes céltípusokba exportált metrikákhoz tartozó DCR JSON-mintaobjektumokat mutatják be.

Log Analytics-munkaterületek

Az alábbi példa egy adatgyűjtési szabályt mutat be olyan metrikákhoz, amelyek adott metrikákat küldenek a virtuális gépekről, a virtuálisgép-méretezési csoportokból és az összes kulcstartó metrikájából egy Log Analytics-munkaterületre:

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

DCRs létrehozása metrikák exportálásához

DCR-eket hozhat létre a metrikák exportálásához az Azure Portal, a CLI, a PowerShell, a REST API vagy az ARM-sablon használatával. További információ: Adatgyűjtési szabály (DCR) létrehozása metrikák exportálásához.

Exportált adatok

Az alábbi példák az egyes célhelyekre exportált adatokat mutatják be.

Log Analytics-munkaterületek

A Log Analytics-munkaterületre exportált adatokat a rendszer a AzureMetricsV2 Log Analytics-munkaterület táblájában tárolja a következő formátumban:

Oszlop Típus Leírás
Átlag valós szám Az időtartományban gyűjtött átlagérték.
_BilledSize valós szám A rekord mérete bájtban
Count valós szám Az időtartomány során gyűjtött minták száma.
Dimenzió dinamikus A metrika társított dimenziója JSON formátumban.
_IsBillable húr Megadja, hogy az adatok betöltése számlázható-e. Ha a _IsBillable betölti, false a számlázás nem történik meg az Azure-fiókjában
Maximum valós szám Az időtartományban gyűjtött maximális érték.
MetricCategory húr A metrika kategórianeve.
MetricName húr A metrika megjelenítendő neve.
MetricResourceType húr Az Azure-erőforrás erőforrástípusa, amely a metrikát jelenti.
Minimum valós szám Az időtartományban gyűjtött minimális érték.
_ResourceId húr Annak az erőforrásnak az egyedi azonosítója, amelyhez a rekord társítva van
SourceSystem húr Az esemény által gyűjtött ügynök típusa. Windows-ügynök esetén például OpsManager a közvetlen csatlakozás vagy az Operations Manager, Linux az összes Linux-ügynök vagy Azure az Azure Diagnostics esetében
_SubscriptionId húr Annak az előfizetésnek az egyedi azonosítója, amelyhez a rekord társítva van
TenantId húr A Log Analytics-munkaterület azonosítója
TimeGenerated dátum/idő Időbélyeg (UTC) a rekord létrehozásakor.
TimeGrain húr A metrika időfelbontása.
Összesen valós szám Az időtartomány összes értékének összege.
Típus húr A tábla neve
UnitName húr A metrika egysége.

Példa:

Képernyőkép az AzureMetricsV2 tábla naplóelemzési lekérdezéséről.

Storage fiókok

Az alábbi példa egy tárfiókba exportált adatokat mutatja be:

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

Az alábbi példa egy Event Hubsba exportált metrikát mutat be.

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

Következő lépések