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 aAzureMetricsV2
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, kind
location
identity
é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:
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"
}