Metrics - Get
Получение данных метрик
Возвращает значения метрик для одной метрики
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
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
app
|
path | True |
string |
Идентификатор приложения. Это идентификатор приложения из колонки параметров доступа к API на портале Azure. |
metric
|
path | True |
Идентификатор метрики. Это стандартная метрика ИИ или пользовательская метрика для конкретного приложения. |
|
aggregation
|
query |
Агрегирование, используемое при вычислении значений метрик. Чтобы получить несколько агрегатов за раз, разделите их запятой. Если агрегирование не указано, используется агрегирование по умолчанию для метрики. |
||
filter
|
query |
string |
Выражение, используемое для фильтрации результатов. Это значение должно быть допустимым выражением фильтра OData, где ключи каждого предложения должны быть применимыми измерениями для возвращаемой метрики. |
|
interval
|
query |
string (duration) |
Интервал времени, используемый при получении значений метрик. Это ISO8601 длительность. Если интервал опущен, значение метрики агрегируется по всему интервалу времени. Если задан интервал, сервер может настроить интервал на более подходящий размер на основе интервала времени, используемого для запроса. Во всех случаях фактический интервал, используемый для запроса, включается в ответ. |
|
orderby
|
query |
string |
Функция агрегирования и направление сортировки сегментов по. Это значение допустимо только при указании сегмента. |
|
segment
|
query |
Имя измерения для сегментирования значений метрик по. Это измерение должно применяться к извлекаемой метрии. Чтобы сегментировать по нескольким измерениям за раз, разделите их запятыми (,). В этом случае данные метрик будут сегментированы в том порядке, в который перечислены измерения в параметре. |
||
timespan
|
query |
string |
Интервал времени для получения значений метрик. Это значение ISO8601 периода времени. Если интервал времени не указан, используется диапазон времени по умолчанию |
|
top
|
query |
integer (int32) |
Количество возвращаемых сегментов. Это значение допустимо только при указании сегмента. |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
Успешный ответ |
|
Other Status Codes |
Объект ответа об ошибке. |
Безопасность
oauth2
Подключение к API Azure Application Insights
Тип:
oauth2
Flow:
implicit
URL-адрес авторизации:
https://login.microsoftonline.com/common/oauth2/authorize?resource=https%3A%2F%2Fapi.applicationinsights.io
Области
Имя | Описание |
---|---|
user_impersonation | олицетворения учетной записи пользователя |
Примеры
intervaled |
segmented |
simple |
intervaledMetric
Образец запроса
GET https://api.applicationinsights.io/v1/apps/DEMO_APP/metrics/requests%2Fcount?timespan=P2D&interval=P1D
Пример ответа
{
"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
Образец запроса
GET https://api.applicationinsights.io/v1/apps/DEMO_APP/metrics/requests%2Fcount?timespan=P2D&interval=P1D&segment=operation/name,request/success
Пример ответа
{
"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
Образец запроса
GET https://api.applicationinsights.io/v1/apps/DEMO_APP/metrics/requests%2Fcount
Пример ответа
{
"value": {
"start": "2016-01-01T02:00:00.000Z",
"end": "2016-01-03T02:00:00.000Z",
"requests/count": {
"sum": 23
}
}
}
Определения
Имя | Описание |
---|---|
error |
Сведения об ошибке. |
error |
Код и сообщение об ошибке. |
error |
Сведения об ошибке. |
Metric |
Идентификатор метрики. Это стандартная метрика ИИ или пользовательская метрика для конкретного приложения. |
Metrics |
Агрегирование, используемое при вычислении значений метрик. Чтобы получить несколько агрегатов за раз, разделите их запятой. Если агрегирование не указано, используется агрегирование по умолчанию для метрики. |
metrics |
Результат метрики. |
metrics |
Данные результатов метрик. |
Metrics |
Имя измерения для сегментирования значений метрик по. Это измерение должно применяться к извлекаемой метрии. Чтобы сегментировать по нескольким измерениям за раз, разделите их запятыми (,). В этом случае данные метрик будут сегментированы в том порядке, в который перечислены измерения в параметре. |
metrics |
Сегмент метрик |
errorDetail
Сведения об ошибке.
Имя | Тип | Описание |
---|---|---|
additionalProperties |
object |
|
code |
string |
Код ошибки. |
message |
string |
Сообщение об ошибке, доступное для чтения. |
resources |
string[] |
Указывает ресурсы, ответственные за ошибку. |
target |
string |
Указывает, какое свойство в запросе отвечает за ошибку. |
value |
string |
Указывает, какое значение в target отвечает за ошибку. |
errorInfo
Код и сообщение об ошибке.
Имя | Тип | Описание |
---|---|---|
additionalProperties |
object |
|
code |
string |
Код ошибки, доступный для чтения компьютером. |
details |
сведения об ошибке. |
|
innererror |
Код и сообщение об ошибке. |
|
message |
string |
Сообщение об ошибке, доступное для чтения. |
errorResponse
Сведения об ошибке.
Имя | Тип | Описание |
---|---|---|
error |
Код и сообщение об ошибке. |
MetricId
Идентификатор метрики. Это стандартная метрика ИИ или пользовательская метрика для конкретного приложения.
Значение | Описание |
---|---|
availabilityResults/availabilityPercentage | |
availabilityResults/duration | |
billing/telemetryCount | |
client/networkDuration | |
client/processingDuration | |
client/receiveDuration | |
client/sendDuration | |
client/totalDuration | |
customEvents/count | |
dependencies/count | |
dependencies/duration | |
dependencies/failed | |
exceptions/browser | |
exceptions/count | |
exceptions/server | |
pageViews/count | |
pageViews/duration | |
performanceCounters/exceptionsPerSecond | |
performanceCounters/memoryAvailableBytes | |
performanceCounters/processCpuPercentage | |
performanceCounters/processIOBytesPerSecond | |
performanceCounters/processPrivateBytes | |
performanceCounters/processorCpuPercentage | |
performanceCounters/requestExecutionTime | |
performanceCounters/requestsInQueue | |
performanceCounters/requestsPerSecond | |
requests/count | |
requests/duration | |
requests/failed | |
sessions/count | |
users/authenticated | |
users/count |
MetricsAggregation
Агрегирование, используемое при вычислении значений метрик. Чтобы получить несколько агрегатов за раз, разделите их запятой. Если агрегирование не указано, используется агрегирование по умолчанию для метрики.
Значение | Описание |
---|---|
avg | |
count | |
max | |
min | |
sum | |
unique |
metricsResult
Результат метрики.
Имя | Тип | Описание |
---|---|---|
value |
Данные результатов метрик. |
metricsResultInfo
Данные результатов метрик.
Имя | Тип | Описание |
---|---|---|
end |
string (date_time) |
Время начала метрики. |
interval |
string (duration) |
Интервал, используемый для сегментирования данных метрик. |
segments |
Сегментированные данные метрик (если сегментированы). |
|
start |
string (date_time) |
Время начала метрики. |
MetricsSegment
Имя измерения для сегментирования значений метрик по. Это измерение должно применяться к извлекаемой метрии. Чтобы сегментировать по нескольким измерениям за раз, разделите их запятыми (,). В этом случае данные метрик будут сегментированы в том порядке, в который перечислены измерения в параметре.
Значение | Описание |
---|---|
applicationBuild | |
applicationVersion | |
authenticatedOrAnonymousTraffic | |
browser | |
browserVersion | |
city | |
cloudRoleName | |
cloudServiceName | |
continent | |
countryOrRegion | |
deploymentId | |
deploymentUnit | |
deviceType | |
environment | |
hostingLocation | |
instanceName |
metricsSegmentInfo
Сегмент метрик
Имя | Тип | Описание |
---|---|---|
end |
string (date_time) |
Время начала сегмента метрик (только при указании интервала). |
segments |
Сегментированные данные метрик (если они будут сегментированы дальше). |
|
start |
string (date_time) |
Время начала сегмента метрик (только при указании интервала). |