Metrics - Get
Abrufen von Metrikdaten
Ruft Metrikwerte für eine einzelne Metrik ab.
GET https://api.applicationinsights.io/v1/apps/{appId}/metrics/{metricId}
GET https://api.applicationinsights.io/v1/apps/{appId}/metrics/{metricId}?timespan={timespan}&interval={interval}&aggregation={aggregation}&segment={segment}&top={top}&orderby={orderby}&filter={filter}
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
app
|
path | True |
string |
ID der Anwendung. Dies ist die Anwendungs-ID auf dem Blatt API-Zugriffseinstellungen im Azure-Portal. |
metric
|
path | True |
ID der Metrik. Dies ist entweder eine KI-Standardmetrik oder eine anwendungsspezifische benutzerdefinierte Metrik. |
|
aggregation
|
query |
Die Aggregation, die beim Berechnen der Metrikwerte verwendet werden soll. Um mehrere Aggregationen gleichzeitig abzurufen, trennen Sie sie durch ein Komma. Wenn keine Aggregation angegeben ist, wird die Standardaggregation für die Metrik verwendet. |
||
filter
|
query |
string |
Ein Ausdruck, der zum Filtern der Ergebnisse verwendet wird. Dieser Wert sollte ein gültiger OData-Filterausdruck sein, bei dem die Schlüssel jeder Klausel anwendbare Dimensionen für die metrik sein sollten, die Sie abrufen. |
|
interval
|
query |
string duration |
Das Zeitintervall, das beim Abrufen von Metrikwerten verwendet werden soll. Dies ist eine ISO8601 Dauer. Wenn das Intervall ausgelassen wird, wird der Metrikwert über den gesamten Zeitraum aggregiert. Wenn Intervall angegeben wird, kann der Server das Intervall basierend auf dem für die Abfrage verwendeten Zeitraum auf eine geeignetere Größe anpassen. In allen Fällen ist das tatsächliche Intervall, das für die Abfrage verwendet wird, in der Antwort enthalten. |
|
orderby
|
query |
string |
Die Aggregationsfunktion und die Richtung, nach der die Segmente sortiert werden sollen. Dieser Wert ist nur gültig, wenn segment angegeben wird. |
|
segment
|
query |
Der Name der Dimension, nach der die Metrikwerte segmentiert werden sollen. Diese Dimension muss für die Metrik gelten, die Sie abrufen. Um nach mehr als einer Dimension gleichzeitig zu segmentieren, trennen Sie sie durch ein Komma (,). In diesem Fall werden die Metrikdaten in der Reihenfolge segmentiert, in der die Dimensionen im Parameter aufgeführt sind. |
||
timespan
|
query |
string |
Der Zeitraum, über den Metrikwerte abgerufen werden sollen. Dies ist ein ISO8601 Zeitraumwert. Wenn der Zeitraum ausgelassen wird, wird der Standardzeitbereich |
|
top
|
query |
integer int32 |
Die Anzahl der zurückzugebenden Segmente. Dieser Wert ist nur gültig, wenn segment angegeben wird. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Erfolgreiche Antwort |
|
Other Status Codes |
Ein Fehlerantwortobjekt. |
Sicherheit
oauth2
Herstellen einer Verbindung mit Azure-Anwendung Insights-API
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize?resource=https%3A%2F%2Fapi.applicationinsights.io
Bereiche
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel Ihres Benutzerkontos |
Beispiele
intervaled |
segmented |
simple |
intervaledMetric
Beispielanforderung
GET https://api.applicationinsights.io/v1/apps/DEMO_APP/metrics/requests%2Fcount?timespan=P2D&interval=P1D
Beispiel für eine Antwort
{
"value": {
"start": "2018-02-04T10:01:35.086Z",
"end": "2018-02-06T10:01:35.086Z",
"interval": "P1D",
"segments": [
{
"start": "2018-02-04T10:01:35.086Z",
"end": "2018-02-05T00:00:00.000Z",
"requests/count": {
"sum": 4927
}
},
{
"start": "2018-02-05T00:00:00.000Z",
"end": "2018-02-06T00:00:00.000Z",
"requests/count": {
"sum": 8460
}
},
{
"start": "2018-02-06T00:00:00.000Z",
"end": "2018-02-06T10:01:35.086Z",
"requests/count": {
"sum": 3743
}
}
]
}
}
segmentedIntervaledMetric
Beispielanforderung
GET https://api.applicationinsights.io/v1/apps/DEMO_APP/metrics/requests%2Fcount?timespan=P2D&interval=P1D&segment=operation/name,request/success
Beispiel für eine Antwort
{
"value": {
"start": "2018-10-22T10:40:09.065Z",
"end": "2018-10-22T22:40:09.065Z",
"segments": [
{
"operation/name": "GET Home/Index",
"segments": [
{
"requests/count": null,
"sum": 156483,
"request/success": false
},
{
"requests/count": null,
"sum": 3795,
"request/success": true
}
]
},
{
"operation/name": "GET /",
"segments": [
{
"requests/count": null,
"sum": 34168,
"request/success": false
},
{
"requests/count": null,
"sum": 12,
"request/success": true
}
]
},
{
"operation/name": "GET /FabrikamProd/Content/fonts/segoewp-light-webfont.eot",
"segments": [
{
"requests/count": null,
"sum": 9378,
"request/success": true
}
]
},
{
"operation/name": "GET /FabrikamProd/Content/fonts/segoewp-webfont.eot",
"segments": [
{
"requests/count": null,
"sum": 9370,
"request/success": true
}
]
},
{
"operation/name": "GET ServiceTickets/Details",
"segments": [
{
"requests/count": null,
"sum": 1989,
"request/success": false
},
{
"requests/count": null,
"sum": 14,
"request/success": true
}
]
},
{
"operation/name": "GET ServiceTickets/Index",
"segments": [
{
"requests/count": null,
"sum": 1991,
"request/success": true
}
]
},
{
"operation/name": "GET Employees/Index",
"segments": [
{
"requests/count": null,
"sum": 1990,
"request/success": true
}
]
},
{
"operation/name": "GET ServiceTickets/GetLogEntries",
"segments": [
{
"requests/count": null,
"sum": 1985,
"request/success": true
}
]
},
{
"operation/name": "GET Employees/Details",
"segments": [
{
"requests/count": null,
"sum": 663,
"request/success": false
},
{
"requests/count": null,
"sum": 663,
"request/success": true
}
]
},
{
"operation/name": "GET Reports/Index",
"segments": [
{
"requests/count": null,
"sum": 1086,
"request/success": true
}
]
}
]
}
}
simpleMetric
Beispielanforderung
GET https://api.applicationinsights.io/v1/apps/DEMO_APP/metrics/requests%2Fcount
Beispiel für eine Antwort
{
"value": {
"start": "2016-01-01T02:00:00.000Z",
"end": "2016-01-03T02:00:00.000Z",
"requests/count": {
"sum": 23
}
}
}
Definitionen
Name | Beschreibung |
---|---|
error |
Fehlerdetails. |
error |
Der Code und die Meldung für einen Fehler. |
error |
Fehlerdetails. |
Metric |
ID der Metrik. Dies ist entweder eine KI-Standardmetrik oder eine anwendungsspezifische benutzerdefinierte Metrik. |
Metrics |
Die Aggregation, die beim Berechnen der Metrikwerte verwendet werden soll. Um mehrere Aggregationen gleichzeitig abzurufen, trennen Sie sie durch ein Komma. Wenn keine Aggregation angegeben ist, wird die Standardaggregation für die Metrik verwendet. |
metrics |
Ein Metrikergebnis. |
metrics |
Metrikergebnisdaten. |
Metrics |
Der Name der Dimension, nach der die Metrikwerte segmentiert werden sollen. Diese Dimension muss für die Metrik gelten, die Sie abrufen. Um nach mehr als einer Dimension gleichzeitig zu segmentieren, trennen Sie sie durch ein Komma (,). In diesem Fall werden die Metrikdaten in der Reihenfolge segmentiert, in der die Dimensionen im Parameter aufgeführt sind. |
metrics |
Ein Metriksegment |
errorDetail
Fehlerdetails.
Name | Typ | Beschreibung |
---|---|---|
additionalProperties |
object |
|
code |
string |
Der Fehlercode. |
message |
string |
Eine lesbare Fehlermeldung. |
resources |
string[] |
Gibt Ressourcen an, die für den Fehler verantwortlich waren. |
target |
string |
Gibt an, welche Eigenschaft in der Anforderung für den Fehler verantwortlich ist. |
value |
string |
Gibt an, welcher Wert in "target" für den Fehler verantwortlich ist. |
errorInfo
Der Code und die Meldung für einen Fehler.
Name | Typ | Beschreibung |
---|---|---|
additionalProperties |
object |
|
code |
string |
Ein computerlesbarer Fehlercode. |
details |
Fehlerdetails. |
|
innererror |
Der Code und die Meldung für einen Fehler. |
|
message |
string |
Eine lesbare Fehlermeldung. |
errorResponse
Fehlerdetails.
Name | Typ | Beschreibung |
---|---|---|
error |
Der Code und die Meldung für einen Fehler. |
MetricId
ID der Metrik. Dies ist entweder eine KI-Standardmetrik oder eine anwendungsspezifische benutzerdefinierte Metrik.
Name | Typ | Beschreibung |
---|---|---|
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
Die Aggregation, die beim Berechnen der Metrikwerte verwendet werden soll. Um mehrere Aggregationen gleichzeitig abzurufen, trennen Sie sie durch ein Komma. Wenn keine Aggregation angegeben ist, wird die Standardaggregation für die Metrik verwendet.
Name | Typ | Beschreibung |
---|---|---|
avg |
string |
|
count |
string |
|
max |
string |
|
min |
string |
|
sum |
string |
|
unique |
string |
metricsResult
Ein Metrikergebnis.
Name | Typ | Beschreibung |
---|---|---|
value |
Metrikergebnisdaten. |
metricsResultInfo
Metrikergebnisdaten.
Name | Typ | Beschreibung |
---|---|---|
end |
string |
Startzeit der Metrik. |
interval |
string |
Das Intervall, das zum Segmentieren der Metrikdaten verwendet wird. |
segments |
Segmentierte Metrikdaten (falls segmentiert). |
|
start |
string |
Startzeit der Metrik. |
MetricsSegment
Der Name der Dimension, nach der die Metrikwerte segmentiert werden sollen. Diese Dimension muss für die Metrik gelten, die Sie abrufen. Um nach mehr als einer Dimension gleichzeitig zu segmentieren, trennen Sie sie durch ein Komma (,). In diesem Fall werden die Metrikdaten in der Reihenfolge segmentiert, in der die Dimensionen im Parameter aufgeführt sind.
Name | Typ | Beschreibung |
---|---|---|
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
Ein Metriksegment
Name | Typ | Beschreibung |
---|---|---|
end |
string |
Startzeit des Metriksegments (nur, wenn ein Intervall angegeben wurde). |
segments |
Segmentierte Metrikdaten (falls weiter segmentiert). |
|
start |
string |
Startzeit des Metriksegments (nur, wenn ein Intervall angegeben wurde). |