Metrics - Get Multiple
Načtení dat metriky
Získá hodnoty metrik pro více metrik.
POST https://api.applicationinsights.io/v1/apps/{appId}/metrics
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
app
|
path | True |
string |
ID aplikace. Toto je ID aplikace z okna Nastavení přístupu k rozhraní API v Azure Portal. |
Text požadavku
Name | Typ | Description |
---|---|---|
body |
Dotaz na dávkové metriky |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Úspěšná odpověď |
|
Other Status Codes |
Objekt odpovědi na chybu. |
Zabezpečení
oauth2
Připojení k rozhraní API Aplikace Azure Insights
Typ:
oauth2
Tok:
implicit
URL autorizace:
https://login.microsoftonline.com/common/oauth2/authorize?resource=https%3A%2F%2Fapi.applicationinsights.io
Rozsahy
Name | Description |
---|---|
user_impersonation | zosobnění uživatelského účtu |
Příklady
postMetric
Ukázkový požadavek
POST https://api.applicationinsights.io/v1/apps/DEMO_APP/metrics
[
{
"id": "failed",
"parameters": {
"metricId": "requests/failed",
"timespan": "P2D",
"interval": "P1D"
}
},
{
"id": "count",
"parameters": {
"metricId": "requests/count",
"timespan": "P2D",
"interval": "P1D"
}
}
]
Ukázková odpověď
[
{
"id": "failed",
"status": 200,
"body": {
"value": {
"start": "2018-01-22T19:59:12.488Z",
"end": "2018-01-24T19:59:12.488Z",
"interval": "P1D",
"segments": [
{
"start": "2018-01-22T19:59:12.488Z",
"end": "2018-01-23T00:00:00.000Z",
"requests/failed": {
"sum": 277
}
},
{
"start": "2018-01-23T00:00:00.000Z",
"end": "2018-01-24T00:00:00.000Z",
"requests/failed": {
"sum": 1599
}
},
{
"start": "2018-01-24T00:00:00.000Z",
"end": "2018-01-24T19:59:12.488Z",
"requests/failed": {
"sum": 1392
}
}
]
}
}
},
{
"id": "count",
"status": 200,
"body": {
"value": {
"start": "2018-01-22T19:59:12.488Z",
"end": "2018-01-24T19:59:12.488Z",
"interval": "P1D",
"segments": [
{
"start": "2018-01-22T19:59:12.488Z",
"end": "2018-01-23T00:00:00.000Z",
"requests/count": {
"sum": 1225
}
},
{
"start": "2018-01-23T00:00:00.000Z",
"end": "2018-01-24T00:00:00.000Z",
"requests/count": {
"sum": 7382
}
},
{
"start": "2018-01-24T00:00:00.000Z",
"end": "2018-01-24T19:59:12.488Z",
"requests/count": {
"sum": 6674
}
}
]
}
}
}
]
Definice
Name | Description |
---|---|
error |
Podrobnosti o chybě. |
error |
Kód a zpráva pro chybu. |
error |
Podrobnosti o chybě. |
Metric |
ID metriky Jedná se buď o standardní metriku AI, nebo o vlastní metriku specifickou pro aplikaci. |
Metrics |
Agregace, která se má použít při výpočtu hodnot metrik. Pokud chcete načíst více agregací najednou, oddělte je čárkou. Pokud není zadána žádná agregace, použije se výchozí agregace pro metriku. |
metrics |
Žádost o metriku |
metrics |
Výsledek metriky. |
metrics |
Data výsledku metriky. |
metrics |
Sada výsledků metrik. |
Metrics |
Název dimenze, podle které se mají hodnoty metrik rozdělit. Tato dimenze musí být použitelná pro metriku, kterou načítáte. Pokud chcete segmentovat více dimenzí najednou, oddělte je čárkou (,). V tomto případě budou data metriky segmentována v pořadí, v jakém jsou dimenze uvedeny v parametru. |
metrics |
Segment metriky |
Parameters |
Parametry pro jeden dotaz na metriky |
errorDetail
Podrobnosti o chybě.
Name | Typ | Description |
---|---|---|
additionalProperties |
object |
|
code |
string |
Kód chyby. |
message |
string |
Chybová zpráva čitelná pro člověka. |
resources |
string[] |
Označuje prostředky, které byly zodpovědné za chybu. |
target |
string |
Určuje, která vlastnost v požadavku je zodpovědná za chybu. |
value |
string |
Označuje, která hodnota v "target" je zodpovědná za chybu. |
errorInfo
Kód a zpráva pro chybu.
Name | Typ | Description |
---|---|---|
additionalProperties |
object |
|
code |
string |
Strojově čitelný kód chyby. |
details |
podrobnosti o chybě. |
|
innererror |
Kód a zpráva pro chybu. |
|
message |
string |
Chybová zpráva čitelná pro člověka. |
errorResponse
Podrobnosti o chybě.
Name | Typ | Description |
---|---|---|
error |
Kód a zpráva pro chybu. |
MetricId
ID metriky Jedná se buď o standardní metriku AI, nebo o vlastní metriku specifickou pro aplikaci.
Name | Typ | Description |
---|---|---|
availabilityResults/availabilityPercentage |
string |
|
availabilityResults/duration |
string |
|
billing/telemetryCount |
string |
|
client/networkDuration |
string |
|
client/processingDuration |
string |
|
client/receiveDuration |
string |
|
client/sendDuration |
string |
|
client/totalDuration |
string |
|
customEvents/count |
string |
|
dependencies/count |
string |
|
dependencies/duration |
string |
|
dependencies/failed |
string |
|
exceptions/browser |
string |
|
exceptions/count |
string |
|
exceptions/server |
string |
|
pageViews/count |
string |
|
pageViews/duration |
string |
|
performanceCounters/exceptionsPerSecond |
string |
|
performanceCounters/memoryAvailableBytes |
string |
|
performanceCounters/processCpuPercentage |
string |
|
performanceCounters/processIOBytesPerSecond |
string |
|
performanceCounters/processPrivateBytes |
string |
|
performanceCounters/processorCpuPercentage |
string |
|
performanceCounters/requestExecutionTime |
string |
|
performanceCounters/requestsInQueue |
string |
|
performanceCounters/requestsPerSecond |
string |
|
requests/count |
string |
|
requests/duration |
string |
|
requests/failed |
string |
|
sessions/count |
string |
|
users/authenticated |
string |
|
users/count |
string |
MetricsAggregation
Agregace, která se má použít při výpočtu hodnot metrik. Pokud chcete načíst více agregací najednou, oddělte je čárkou. Pokud není zadána žádná agregace, použije se výchozí agregace pro metriku.
Name | Typ | Description |
---|---|---|
avg |
string |
|
count |
string |
|
max |
string |
|
min |
string |
|
sum |
string |
|
unique |
string |
metricsPostBodySchema
Žádost o metriku
Name | Typ | Description |
---|---|---|
id |
string |
Identifikátor tohoto dotazu. Musí být jedinečný v textu požadavku. Tento identifikátor bude vlastnost id objektu odpovědi představujícího tento dotaz. |
parameters |
Parametry pro jeden dotaz na metriky |
metricsResult
Výsledek metriky.
Name | Typ | Description |
---|---|---|
value |
Data výsledku metriky. |
metricsResultInfo
Data výsledku metriky.
Name | Typ | Description |
---|---|---|
end |
string |
Počáteční čas metriky. |
interval |
string |
Interval použitý k segmentace dat metriky. |
segments |
Segmentovaná data metrik (pokud jsou segmentovaná) |
|
start |
string |
Počáteční čas metriky. |
metricsResults
Sada výsledků metrik.
Name | Typ | Description |
---|---|---|
body |
Výsledky tohoto dotazu na metriku |
|
id |
string |
Zadané ID pro tuto metriku. |
status |
integer |
Stavový kód HTTP tohoto dotazu na metriku. |
MetricsSegment
Název dimenze, podle které se mají hodnoty metrik rozdělit. Tato dimenze musí být použitelná pro metriku, kterou načítáte. Pokud chcete segmentovat více dimenzí najednou, oddělte je čárkou (,). V tomto případě budou data metriky segmentována v pořadí, v jakém jsou dimenze uvedeny v parametru.
Name | Typ | Description |
---|---|---|
applicationBuild |
string |
|
applicationVersion |
string |
|
authenticatedOrAnonymousTraffic |
string |
|
browser |
string |
|
browserVersion |
string |
|
city |
string |
|
cloudRoleName |
string |
|
cloudServiceName |
string |
|
continent |
string |
|
countryOrRegion |
string |
|
deploymentId |
string |
|
deploymentUnit |
string |
|
deviceType |
string |
|
environment |
string |
|
hostingLocation |
string |
|
instanceName |
string |
metricsSegmentInfo
Segment metriky
Name | Typ | Description |
---|---|---|
end |
string |
Počáteční čas segmentu metriky (pouze při zadání intervalu) |
segments |
Segmentovaná data metrik (pokud jsou dále segmentovaná) |
|
start |
string |
Počáteční čas segmentu metriky (pouze při zadání intervalu) |
Parameters
Parametry pro jeden dotaz na metriky
Name | Typ | Description |
---|---|---|
aggregation |
Agregace, která se má použít při výpočtu hodnot metrik. Pokud chcete načíst více agregací najednou, oddělte je čárkou. Pokud není zadána žádná agregace, použije se výchozí agregace pro metriku. |
|
filter |
string |
Výraz použitý k filtrování výsledků. Tato hodnota by měla být platným výrazem filtru OData, kde klíče každé klauzule by měly být použitelné dimenze pro metriku, kterou načítáte. |
interval |
string |
Časový interval, který se má použít při načítání hodnot metrik. Jedná se o ISO8601 dobu trvání. Pokud je interval vynechán, hodnota metriky se agreguje v celém časovém rozsahu. Pokud je zadán interval, server může upravit interval na vhodnější velikost na základě časového rozsahu použitého pro dotaz. Ve všech případech je do odpovědi zahrnut skutečný interval použitý pro dotaz. |
metricId |
ID metriky Jedná se buď o standardní metriku AI, nebo o vlastní metriku specifickou pro aplikaci. |
|
orderby |
string |
Agregační funkce a směr řazení segmentů. Tato hodnota je platná pouze v případě, že je zadaný segment. |
segment |
Název dimenze, podle které se mají hodnoty metrik rozdělit. Tato dimenze musí být použitelná pro metriku, kterou načítáte. Pokud chcete segmentovat více dimenzí najednou, oddělte je čárkou (,). V tomto případě budou data metriky segmentována v pořadí, v jakém jsou dimenze uvedeny v parametru. |
|
timespan |
string |
Časový rozsah, pro který se mají načíst hodnoty metrik. Jedná se o ISO8601 hodnotu časového období. Pokud je časový rozsah vynechán, použije se výchozí časový rozsah |
top |
integer |
Počet segmentů, které se mají vrátit. Tato hodnota je platná pouze v případě, že je zadaný segment. |