Metrics - List
egy erőforrás metrikaértékeinek Listák.
GET https://management.azure.com/{resourceUri}/providers/Microsoft.Insights/metrics?api-version=2023-10-01
GET https://management.azure.com/{resourceUri}/providers/Microsoft.Insights/metrics?timespan={timespan}&interval={interval}&metricnames={metricnames}&aggregation={aggregation}&top={top}&orderby={orderby}&$filter={$filter}&resultType={resultType}&api-version=2023-10-01&metricnamespace={metricnamespace}&AutoAdjustTimegrain={AutoAdjustTimegrain}&ValidateDimensions={ValidateDimensions}&rollupby={rollupby}
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Az erőforrás azonosítója. |
api-version
|
query | True |
string |
A művelethez használandó API-verzió. |
$filter
|
query |
string |
A $filter a visszaadott metrikaadatok halmazának csökkentésére szolgál. |
|
aggregation
|
query |
string |
A lekérendő összesítési típusok listája (vesszővel elválasztva). Példák: átlag, minimum, maximum |
|
Auto
|
query |
boolean |
Ha igaz értékre van állítva, ha a metrika nem támogatja a megadott időtartományt, az API a legközelebbi támogatott időtartomány használatával adja vissza az eredményt. Ha hamis értékre van állítva, a rendszer hibát ad vissza érvénytelen időtartomány-paraméterek esetén. Az alapértelmezett érték a hamis. |
|
interval
|
query |
string |
A lekérdezés időköze (azaz időgrain) ISO 8601-es időtartamformátumban. Alapértelmezés szerint PT1M. A "FULL" érték speciális esete, amely egyetlen adatpontot ad vissza a kért teljes időtartamra vonatkozóan. Példák: PT15M, PT1H, P1D, FULL |
|
metricnames
|
query |
string |
A lekérendő metrikák neve (vesszővel elválasztva). |
|
metricnamespace
|
query |
string |
Metrikanévtér, ahol a kívánt metrikák találhatók. |
|
orderby
|
query |
string |
Az eredmények rendezéséhez használandó összesítés és a rendezés iránya. Csak egy rendelés adható meg. Példák: sum asc |
|
result
|
query |
Csökkenti az összegyűjtött adatok készletét. Az engedélyezett szintaxis a művelettől függ. A részletekért tekintse meg a művelet leírását. |
||
rollupby
|
query |
string |
Dimenziónév(ek) az eredmények összesítéséhez. Ha például csak a "City eq Seattle vagy City eq Tacoma" szűrővel szeretné megtekinteni a metrikaértékeket, de nem szeretne külön értékeket látni az egyes városokhoz, megadhatja a RollUpBy=City értéket, hogy a Seattle és a Tacoma eredményeit egy idősorba összesítse. |
|
timespan
|
query |
string |
A lekérdezés időtartománya. Ez egy "startDateTime_ISO/endDateTime_ISO" formátumú sztring. |
|
top
|
query |
integer int32 |
A kérelemben erőforrás-azonosítónként lekérhető rekordok maximális száma. Csak akkor érvényes, ha a szűrő meg van adva. Alapértelmezés szerint 10. |
|
Validate
|
query |
boolean |
Ha hamis értékre van állítva, a rendszer figyelmen kívül hagyja az érvénytelen szűrőparaméter-értékeket. Ha igaz értékre van állítva, a rendszer hibát ad vissza érvénytelen szűrőparaméterek esetén. Alapértelmezés szerint igaz. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
Sikeres kérés a metrikaértékek listájának lekéréséhez. |
|
Other Status Codes |
Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg. |
Biztonság
azure_auth
Azure Active Directory OAuth2 Flow
Típus:
oauth2
Folyamat:
implicit
Engedélyezési URL:
https://login.microsoftonline.com/common/oauth2/authorize
Hatókörök
Name | Description |
---|---|
user_impersonation | felhasználói fiók megszemélyesítése |
Példák
Get Metric for data |
Get Metric for metadata |
Get Metric with error |
Get Metric for data
Mintakérelem
GET https://management.azure.com/subscriptions/1f3fa6d2-851c-4a91-9087-1a050f3a9c38/resourceGroups/todking/providers/Microsoft.Storage/storageAccounts/tkfileserv/blobServices/default/providers/Microsoft.Insights/metrics?timespan=2021-04-20T09:00:00.000Z/2021-04-20T14:00:00.000Z&interval=PT6H&metricnames=BlobCount,BlobCapacity&aggregation=average,minimum,maximum&top=5&orderby=average asc&$filter=Tier eq '*'&api-version=2023-10-01&metricnamespace=Microsoft.Storage/storageAccounts/blobServices&AutoAdjustTimegrain=True&ValidateDimensions=False
Mintaválasz
{
"cost": 598,
"timespan": "2021-04-20T09:00:00Z/2021-04-20T14:00:00Z",
"interval": "PT1H",
"value": [
{
"id": "/subscriptions/1f3fa6d2-851c-4a91-9087-1a050f3a9c38/resourceGroups/todking/providers/Microsoft.Storage/storageAccounts/tkfileserv/blobServices/default/providers/Microsoft.Insights/metrics/BlobCount",
"type": "Microsoft.Insights/metrics",
"name": {
"value": "BlobCount",
"localizedValue": "Blob Count"
},
"displayDescription": "The number of blob objects stored in the storage account.",
"unit": "Count",
"timeseries": [
{
"metadatavalues": [
{
"name": {
"value": "tier",
"localizedValue": "tier"
},
"value": "Hot"
}
],
"data": [
{
"timeStamp": "2021-04-20T09:00:00Z",
"average": 7,
"minimum": 7,
"maximum": 7
},
{
"timeStamp": "2021-04-20T10:00:00Z",
"average": 7,
"minimum": 7,
"maximum": 7
},
{
"timeStamp": "2021-04-20T11:00:00Z",
"average": 7,
"minimum": 7,
"maximum": 7
},
{
"timeStamp": "2021-04-20T12:00:00Z",
"average": 7,
"minimum": 7,
"maximum": 7
},
{
"timeStamp": "2021-04-20T13:00:00Z",
"average": 7,
"minimum": 7,
"maximum": 7
}
]
},
{
"metadatavalues": [
{
"name": {
"value": "tier",
"localizedValue": "tier"
},
"value": "Standard"
}
],
"data": [
{
"timeStamp": "2021-04-20T09:00:00Z",
"average": 2,
"minimum": 2,
"maximum": 2
},
{
"timeStamp": "2021-04-20T10:00:00Z",
"average": 2,
"minimum": 2,
"maximum": 2
},
{
"timeStamp": "2021-04-20T11:00:00Z",
"average": 2,
"minimum": 2,
"maximum": 2
},
{
"timeStamp": "2021-04-20T12:00:00Z",
"average": 2,
"minimum": 2,
"maximum": 2
},
{
"timeStamp": "2021-04-20T13:00:00Z",
"average": 2,
"minimum": 2,
"maximum": 2
}
]
},
{
"metadatavalues": [
{
"name": {
"value": "tier",
"localizedValue": "tier"
},
"value": "Cool"
}
],
"data": [
{
"timeStamp": "2021-04-20T09:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
},
{
"timeStamp": "2021-04-20T10:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
},
{
"timeStamp": "2021-04-20T11:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
},
{
"timeStamp": "2021-04-20T12:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
},
{
"timeStamp": "2021-04-20T13:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
}
]
},
{
"metadatavalues": [
{
"name": {
"value": "tier",
"localizedValue": "tier"
},
"value": "Archive"
}
],
"data": [
{
"timeStamp": "2021-04-20T09:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
},
{
"timeStamp": "2021-04-20T10:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
},
{
"timeStamp": "2021-04-20T11:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
},
{
"timeStamp": "2021-04-20T12:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
},
{
"timeStamp": "2021-04-20T13:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
}
]
},
{
"metadatavalues": [
{
"name": {
"value": "tier",
"localizedValue": "tier"
},
"value": "Untiered"
}
],
"data": [
{
"timeStamp": "2021-04-20T09:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
},
{
"timeStamp": "2021-04-20T10:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
},
{
"timeStamp": "2021-04-20T11:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
},
{
"timeStamp": "2021-04-20T12:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
},
{
"timeStamp": "2021-04-20T13:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
}
]
}
],
"errorCode": "Success"
},
{
"id": "/subscriptions/1f3fa6d2-851c-4a91-9087-1a050f3a9c38/resourceGroups/todking/providers/Microsoft.Storage/storageAccounts/tkfileserv/blobServices/default/providers/Microsoft.Insights/metrics/BlobCapacity",
"type": "Microsoft.Insights/metrics",
"name": {
"value": "BlobCapacity",
"localizedValue": "Blob Capacity"
},
"displayDescription": "The amount of storage used by the storage account’s Blob service in bytes.",
"unit": "Bytes",
"timeseries": [
{
"metadatavalues": [
{
"name": {
"value": "tier",
"localizedValue": "tier"
},
"value": "Standard"
}
],
"data": [
{
"timeStamp": "2021-04-20T09:00:00Z",
"average": 621492,
"minimum": 621492,
"maximum": 621492
},
{
"timeStamp": "2021-04-20T10:00:00Z",
"average": 621492,
"minimum": 621492,
"maximum": 621492
},
{
"timeStamp": "2021-04-20T11:00:00Z",
"average": 621492,
"minimum": 621492,
"maximum": 621492
},
{
"timeStamp": "2021-04-20T12:00:00Z",
"average": 621492,
"minimum": 621492,
"maximum": 621492
},
{
"timeStamp": "2021-04-20T13:00:00Z",
"average": 621492,
"minimum": 621492,
"maximum": 621492
}
]
},
{
"metadatavalues": [
{
"name": {
"value": "tier",
"localizedValue": "tier"
},
"value": "Hot"
}
],
"data": [
{
"timeStamp": "2021-04-20T09:00:00Z",
"average": 4733,
"minimum": 4733,
"maximum": 4733
},
{
"timeStamp": "2021-04-20T10:00:00Z",
"average": 4733,
"minimum": 4733,
"maximum": 4733
},
{
"timeStamp": "2021-04-20T11:00:00Z",
"average": 4733,
"minimum": 4733,
"maximum": 4733
},
{
"timeStamp": "2021-04-20T12:00:00Z",
"average": 4733,
"minimum": 4733,
"maximum": 4733
},
{
"timeStamp": "2021-04-20T13:00:00Z",
"average": 4733,
"minimum": 4733,
"maximum": 4733
}
]
},
{
"metadatavalues": [
{
"name": {
"value": "tier",
"localizedValue": "tier"
},
"value": "Archive"
}
],
"data": [
{
"timeStamp": "2021-04-20T09:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
},
{
"timeStamp": "2021-04-20T10:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
},
{
"timeStamp": "2021-04-20T11:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
},
{
"timeStamp": "2021-04-20T12:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
},
{
"timeStamp": "2021-04-20T13:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
}
]
},
{
"metadatavalues": [
{
"name": {
"value": "tier",
"localizedValue": "tier"
},
"value": "Untiered"
}
],
"data": [
{
"timeStamp": "2021-04-20T09:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
},
{
"timeStamp": "2021-04-20T10:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
},
{
"timeStamp": "2021-04-20T11:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
},
{
"timeStamp": "2021-04-20T12:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
},
{
"timeStamp": "2021-04-20T13:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
}
]
},
{
"metadatavalues": [
{
"name": {
"value": "tier",
"localizedValue": "tier"
},
"value": "Cool"
}
],
"data": [
{
"timeStamp": "2021-04-20T09:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
},
{
"timeStamp": "2021-04-20T10:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
},
{
"timeStamp": "2021-04-20T11:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
},
{
"timeStamp": "2021-04-20T12:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
},
{
"timeStamp": "2021-04-20T13:00:00Z",
"average": 0,
"minimum": 0,
"maximum": 0
}
]
}
],
"errorCode": "Success"
}
],
"namespace": "microsoft.storage/storageaccounts/blobservices",
"resourceregion": "westus2"
}
Get Metric for metadata
Mintakérelem
GET https://management.azure.com/subscriptions/1f3fa6d2-851c-4a91-9087-1a050f3a9c38/resourceGroups/todking/providers/Microsoft.Storage/storageAccounts/tkfileserv/blobServices/default/providers/Microsoft.Insights/metrics?timespan=2017-04-14T02:20:00Z/2017-04-14T04:20:00Z&$filter=Tier eq '*'&api-version=2023-10-01&metricnamespace=Microsoft.Storage/storageAccounts/blobServices
Mintaválasz
{
"timespan": "2021-04-15T02:18:00Z/2021-04-22T02:18:00Z",
"interval": "PT1H",
"value": [
{
"id": "/subscriptions/1f3fa6d2-851c-4a91-9087-1a050f3a9c38/resourceGroups/todking/providers/Microsoft.Storage/storageAccounts/tkfileserv/blobServices/default/providers/Microsoft.Insights/metrics/BlobCount",
"type": "Microsoft.Insights/metrics",
"name": {
"value": "BlobCount",
"localizedValue": "Blob Count"
},
"displayDescription": "The number of blob objects stored in the storage account.",
"unit": "Count",
"timeseries": [
{
"metadatavalues": [
{
"name": {
"value": "tier",
"localizedValue": "tier"
},
"value": "Cool"
}
]
},
{
"metadatavalues": [
{
"name": {
"value": "tier",
"localizedValue": "tier"
},
"value": "Archive"
}
]
},
{
"metadatavalues": [
{
"name": {
"value": "tier",
"localizedValue": "tier"
},
"value": "Standard"
}
]
},
{
"metadatavalues": [
{
"name": {
"value": "tier",
"localizedValue": "tier"
},
"value": "Untiered"
}
]
},
{
"metadatavalues": [
{
"name": {
"value": "tier",
"localizedValue": "tier"
},
"value": "Hot"
}
]
}
]
}
],
"namespace": "microsoft.storage/storageaccounts/blobservices",
"resourceregion": "westus2"
}
Get Metric with error
Mintakérelem
GET https://management.azure.com/subscriptions/ac41e21f-afd6-4a79-8070-f01eba278f97/resourceGroups/todking/providers/Microsoft.DocumentDb/databaseAccounts/tk-cosmos-mongo/providers/Microsoft.Insights/metrics?timespan=2021-06-07T21:51:00Z/2021-06-08T01:51:00Z&interval=FULL&metricnames=MongoRequestsCount,MongoRequests&aggregation=average&api-version=2023-10-01&metricnamespace=microsoft.documentdb/databaseaccounts&AutoAdjustTimegrain=True&ValidateDimensions=False
Mintaválasz
{
"cost": 239,
"timespan": "2021-06-07T21:51:00Z/2021-06-08T01:51:00Z",
"interval": "PT4H",
"value": [
{
"id": "/subscriptions/ac41e21f-afd6-4a79-8070-f01eba278f97/resourceGroups/todking/providers/Microsoft.DocumentDb/databaseAccounts/tk-cosmos-mongo/providers/Microsoft.Insights/metrics/MongoRequestsCount",
"type": "Microsoft.Insights/metrics",
"name": {
"value": "MongoRequestsCount",
"localizedValue": "(deprecated) Mongo Request Rate"
},
"unit": "CountPerSecond",
"timeseries": [],
"errorMessage": "Sampling type is not found. Metric:CosmosDBCustomer,AzureMonitor,MongoRequests, SamplingType:NullableAverage.",
"errorCode": "InvalidSamplingType"
},
{
"id": "/subscriptions/ac41e21f-afd6-4a79-8070-f01eba278f97/resourceGroups/todking/providers/Microsoft.DocumentDb/databaseAccounts/tk-cosmos-mongo/providers/Microsoft.Insights/metrics/MongoRequests",
"type": "Microsoft.Insights/metrics",
"name": {
"value": "MongoRequests",
"localizedValue": "Mongo Requests"
},
"displayDescription": "Number of Mongo Requests Made",
"unit": "Count",
"timeseries": [
{
"metadatavalues": [],
"data": [
{
"timeStamp": "2021-06-07T21:51:00Z",
"average": 0
}
]
}
],
"errorCode": "Success"
}
],
"namespace": "microsoft.documentdb/databaseaccounts",
"resourceregion": "westus2"
}
Definíciók
Name | Description |
---|---|
Error |
Az erőforrás-kezelési hiba további információi. |
Error |
Hibaválasz |
Localizable |
A honosítható sztringosztály. |
Metadata |
A metrika metaadatainak értékét jelöli. |
Metric |
Egy lekérdezés eredményadatai. |
Metric |
A metrika egysége. |
Metric |
Metrikaértéket jelöl. |
Response |
A metrikák lekérdezésére adott válasz. |
Result |
Csökkenti az összegyűjtött adatok készletét. Az engedélyezett szintaxis a művelettől függ. A részletekért tekintse meg a művelet leírását. |
Time |
Idősor eredménytípusa. Ebben az esetben a diszkriminatív érték mindig TimeSeries. |
ErrorAdditionalInfo
Az erőforrás-kezelési hiba további információi.
Name | Típus | Description |
---|---|---|
info |
object |
A további információk. |
type |
string |
A további információtípus. |
ErrorResponse
Hibaválasz
Name | Típus | Description |
---|---|---|
additionalInfo |
A hiba további információi. |
|
code |
string |
A hibakód. |
details |
A hiba részletei. |
|
message |
string |
A hibaüzenet. |
target |
string |
A hibacél. |
LocalizableString
A honosítható sztringosztály.
Name | Típus | Description |
---|---|---|
localizedValue |
string |
A megjelenítendő név. |
value |
string |
Az invariáns érték. |
MetadataValue
A metrika metaadatainak értékét jelöli.
Name | Típus | Description |
---|---|---|
name |
A metaadatok neve. |
|
value |
string |
A metaadatok értéke. |
Metric
Egy lekérdezés eredményadatai.
Name | Típus | Description |
---|---|---|
displayDescription |
string |
A metrika részletes leírása. |
errorCode |
string |
A "Sikeres" vagy a metrika lekérdezési hibáival kapcsolatos hiba részletei. |
errorMessage |
string |
Hibaüzenet jelenik meg az adott metrika lekérdezése közben. |
id |
string |
A metrika azonosítója. |
name |
A metrika neve és megjelenítendő neve, azaz honosítható sztring. |
|
timeseries |
Az adat lekérdezés végrehajtásakor visszaadott idősor. |
|
type |
string |
A metrikaerőforrás erőforrástípusa. |
unit |
A metrika egysége. |
MetricUnit
A metrika egysége.
Name | Típus | Description |
---|---|---|
BitsPerSecond |
string |
Bináris számjegyek másodpercenkénti sebességegysége. |
ByteSeconds |
string |
Az adatátvitel vagy a tárolás egysége. Ez az adatok bájtban megadott mérete, megszorozva az adatok átviteléhez vagy tárolásához szükséges idővel másodpercek alatt. |
Bytes |
string |
Memóriaegység bájtban. |
BytesPerSecond |
string |
Memóriaegység másodpercenként bájtban kifejezve. |
Cores |
string |
A feldolgozási teljesítmény mértékegysége. |
Count |
string |
A nyers mennyiség mértékegysége. |
CountPerSecond |
string |
A másodpercenkénti nyers mennyiség rátaegysége. |
MilliCores |
string |
A processzormag 1/1000-edik feldolgozási teljesítményegysége. |
MilliSeconds |
string |
Időegység egy másodperc 1/1000-ében. |
NanoCores |
string |
A processzormag egymilliárd része feldolgozási teljesítményegysége. |
Percent |
string |
Százalékegység. |
Seconds |
string |
Időegység másodpercben. |
Unspecified |
string |
Nincs megadva egység. |
MetricValue
Metrikaértéket jelöl.
Name | Típus | Description |
---|---|---|
average |
number |
Az időtartomány átlagos értéke. |
count |
number |
Az időtartományban lévő minták száma. Az átlagértékhez hozzájáruló értékek számának meghatározására használható. |
maximum |
number |
Az időtartomány legnagyobb értéke. |
minimum |
number |
Az időtartomány legkisebb értéke. |
timeStamp |
string |
A metrikaérték időbélyege ISO 8601 formátumban. |
total |
number |
Az időtartomány összes értékének összege. |
Response
A metrikák lekérdezésére adott válasz.
Name | Típus | Description |
---|---|---|
cost |
number |
A lekérdezés relatív költségét jelölő egész szám. |
interval |
string |
Az az intervallum (ablakméret), amelyre vonatkozóan a metrikaadatokat ISO 8601-es időtartamformátumban adták vissza, a "FULL" érték speciális esetével, amely egyetlen adatpontot ad vissza a kért teljes időtartamhoz (például: PT15M, PT1H, P1D, FULL). Ez módosítható, és eltérhet az eredetileg kérttől, ha az AutoAdjustTimegrain=true érték meg van adva. Ez nem jelenik meg, ha metaadat-kérés történt. |
namespace |
string |
A lekérdezett metrikák névtere |
resourceregion |
string |
A lekérdezett erőforrás régiója a metrikákhoz. |
timespan |
string |
Az az időtartomány, amelyre vonatkozóan lekérte az adatokat. Értéke két összefűzött datetime-ból áll, amelyeket "/" választ el egymástól. Ez a jövőben módosítható, és visszatérhet az eredetileg kérttől. |
value |
Metric[] |
A gyűjtemény értéke. |
ResultType
Csökkenti az összegyűjtött adatok készletét. Az engedélyezett szintaxis a művelettől függ. A részletekért tekintse meg a művelet leírását.
Name | Típus | Description |
---|---|---|
Data |
string |
|
Metadata |
string |
TimeSeriesElement
Idősor eredménytípusa. Ebben az esetben a diszkriminatív érték mindig TimeSeries.
Name | Típus | Description |
---|---|---|
data |
A metrikaértékeket képviselő adatpontok tömbje. Ezt csak akkor adja vissza a rendszer, ha meg van adva eredmény típusú adat. |
|
metadatavalues |
A visszaadott metaadat-értékek, ha $filter meg lett adva a hívásban. |