Получение метрик
Список всех доступных показателей.
Вы можете ограничить вывод, используя нумерацию страниц:
- Укажите количество результатов на странице в параметре запроса pageSize .
- Затем используйте курсор из поля nextPageKey предыдущего ответа в параметре запроса nextPageKey для получения последующих страниц.
Запрос создает один из следующих типов полезной нагрузки, в зависимости от значения заголовка запроса Accept :
application/jsontext/csv; header=present— таблица CSV со строкой заголовкаtext/csv; header=absent— таблица CSV без строки заголовка
Если с запросом не предоставлен заголовок Acceptapplication/json , возвращается полезная нагрузка.
| ПОЛУЧИТЬ | Удалось | https://{your-domain}/e/{your-environment-id}/api/v2/metrics
|
| SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/metrics
| |
| Окружающая среда ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/metrics
|
Аутентификация
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Чтение метрик ( metrics.read) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
| Параметр | Тип | Описание | В | Необходимый |
|---|---|---|---|---|
| ключ следующей страницы | нить | Курсор для следующей страницы результатов. Вы можете найти его в поле nextPageKey предыдущего ответа.
Первая страница всегда возвращается, если вы не укажете параметр запроса nextPageKey . Когда nextPageKey настроен на получение последующих страниц, вы должны опустить все остальные параметры запроса. |
запрос | по желанию |
| размер страницы | целое число | Количество метрических схем в полезной нагрузке одного ответа.
Максимально допустимый размер страницы – 500. Если не установлено, используется 100. Если используется значение выше 500, возвращается только 500 результатов на страницу. |
запрос | по желанию |
| метрическийселектор | нить | Выбирает метрики для запроса по их ключам.
Можно указать несколько ключей метрик, разделенных запятыми (например,
Вы можете установить дополнительные операторы преобразования, разделенные двоеточием ( Эта конечная точка поддерживает только преобразования , Если ключ метрики содержит какие-либо символы, ключ необходимо заключить в кавычки (
Например, чтобы запросить метрику с ключом ext:selfmonitoring.jmx.Agents: Введите «APACHE» , вы должны указать этот селектор:
Чтобы найти метрики на основе условия поиска, а не metricId, используйте текстовый параметр запроса вместо этого. |
запрос | по желанию |
| текст | нить | Критерий поиска реестра метрик. Показывать только те метрики, которые содержат термин в своем ключе, отображаемом имени или описании. Используйте этот metricSelectorпараметр вместо этого, чтобы выбрать полную иерархию метрик вместо текстового поиска.
|
запрос | по желанию |
| поля | нить | Определяет список свойств метрик, включенных в ответ.
Чтобы добавить свойства, перечислите их с начальным плюсом Чтобы указать несколько свойств, соедините их запятой (например, Если указать только одно свойство, ответ будет содержать ключ метрики и указанное свойство. Чтобы вернуть только ключи метрик, укажите |
запрос | по желанию |
| написаноС тех пор | нить | Фильтрует результирующий набор метрик до тех, которые имеют точки данных в пределах указанного периода времени.
Вы можете использовать один из следующих форматов:
|
запрос | по желанию |
| селектор метаданных | нить | Область метаданных запроса. В ответ включаются только метрики с указанными свойствами.
Вы можете установить один или несколько из следующих критериев. Значения чувствительны к регистру и используется
Чтобы задать несколько критериев, разделите их запятой ( Например, чтобы вывести список метрик, у которых есть функция тегов И облако с единицей измерения Проценты ИЛИ Мегабайты И измерение с ключевым местоположением измерения , используйте этот селектор метаданных : |
запрос | по желанию |
Ответ
Коды ответов
| Код | Тип | Описание |
|---|---|---|
| 200 | Коллекция дескрипторов метрик | Успех |
| 400 | Ошибка синтаксиса или проверки. metricSelector или поля содержат синтаксические или семантические ошибки. | |
| 404 | Метрика не найдена. | |
| 406 | Неприемлимо. Запрошенный тип носителя не поддерживается. Проверьте заголовок Accept вашего запроса. |
Объекты тела ответа
Объект _ MetricDescriptorCollection
Список метрик вместе с их дескрипторами.
| Элемент | Тип | Описание |
|---|---|---|
| ключ следующей страницы | нить | Курсор для следующей страницы результатов. Имеет значение nullна последней странице.
Используйте его в параметре запроса nextPageKey для получения последующих страниц результата. |
| общее количество | целое число | Предполагаемое количество метрик в результате. |
| показатели | Дескриптор метрики [] | Список метрик вместе с их дескрипторами |
| предупреждения | строка [] | Список возможных предупреждений о запросе. Например, использование устаревших функций и т. д. |
Объект _ MetricDescriptor
Дескриптор метрики.
| Элемент | Тип | Описание |
|---|---|---|
| размерность | Количество элементов метрики [ ] | Количество элементов метрических измерений MINT. |
| минимальное значение | количество | Минимально допустимое значение метрики.
Выражения показателей не возвращают это поле. |
| максимальное значение | количество | Максимально допустимое значение метрики.
Выражения показателей не возвращают это поле. |
| задержка | целое число | Задержка показателя в минутах.
Задержка — это ожидаемая задержка в отчетах (например, вызванная ограничениями поставщиков облачных услуг или других сторонних источников данных) между наблюдением за точкой данных метрики и ее доступностью в Dynatrace. Допустимый диапазон значений составляет от 1 до 60 минут. Выражения показателей не возвращают это поле. |
| разрешениеInfSupported | логический | Если установлено значение «true», разрешение=Inf может быть применено к запросу метрики. |
| unitDisplayFormat | нить | Необработанное значение хранится в битах или байтах. Пользовательский интерфейс может отображать его в следующих системах счисления:
Двоичный: 1 МБ = 1024 КиБ = 1 048 576 байт. Десятичный: 1 МБ = 1000 КБ = 1 000 000 байт. Если не задано, используется десятичная система. Выражения показателей не возвращают это поле. Элемент может содержать эти значения
|
| rootCauseRelevant | логический | Метрика является ( true) или не является ( false) релевантной для основной причины.
Метрика, относящаяся к первопричине, представляет собой надежный индикатор неисправного компонента. Выражения показателей не возвращают это поле. |
| dduBillable | логический | Если trueиспользование метрики потребляет единицы данных Дэвиса .
Выражения показателей не возвращают это поле. |
| агрегация по умолчанию | Агрегирование показателей по умолчанию | Агрегирование метрики по умолчанию. |
| lastWritten | целое число | Отметка времени последней записи метрики.
Имеет значение |
| влияниеактуальный | логический | Метрика является ( true) или не является ( false) релевантной для воздействия.
Метрика, имеющая отношение к влиянию, сильно зависит от других метрик и изменений, поскольку базовая метрика первопричины изменилась. Выражения показателей не возвращают это поле. |
| измерениеОпределения | Определение метрического измерения [] | Точное разделение метрик (например, группа процессов и идентификатор процесса для некоторой метрики, связанной с процессом).
Для загруженных показателей параметры, по которым не было данных за последние 15 дней, опускаются. |
| тип метриквалуе | Тип значения показателя | Тип значения для метрики. |
| теги | строка [] | Теги, примененные к метрике.
Выражения показателей не возвращают это поле. |
| тип объекта | строка [] | Список допустимых основных типов сущностей для этой метрики. Может использоваться для typeпредиката в entitySelector.
|
| идентификатор метрики | нить | Полный ключ метрики.
Если использовалось преобразование, оно отражается в ключе метрики. |
| метрическийселектор | нить | Селектор метрик, который используется при запросе метрики func:. |
| скаляр | логический | Указывает, разрешается ли метрическое выражение в скаляр ( true) или в ряд ( false). Скалярный результат всегда содержит одну точку данных. Количество точек данных в результате серии зависит от используемого разрешения.
|
| типы агрегации | строка [] | Список разрешенных агрегаций для этой метрики.
Элемент может содержать эти значения
|
| показать имя | нить | Имя метрики в пользовательском интерфейсе. |
| описание | нить | Краткое описание метрики. |
| преобразования | строка [] | Операторы преобразования, которые можно добавить к текущему списку преобразований.
Элемент может содержать эти значения
|
| Ед. изм | нить | Единица измерения. |
| предупреждения | строка [] | Список потенциальных предупреждений, влияющих на этот идентификатор. Например, использование устаревших функций и т. д. |
| созданный | целое число | Отметка времени создания метрики.
Встроенные метрики и выражения метрик имеют значение |
Объект _ MetricDimensionCardinality
Количество элементов измерения метрики.
| Элемент | Тип | Описание |
|---|---|---|
| родственник | количество | Относительная кардинальность измерения, выраженная в процентах |
| оценивать | целое число | Оценка количества элементов измерения. |
| ключ | нить | Ключ измерения.
Он должен быть уникальным в пределах метрики. |
Объект _ MetricDefaultAggregation
Агрегирование метрики по умолчанию.
| Элемент | Тип | Описание |
|---|---|---|
| параметр | количество | Доставляемый процентиль. Допустимые значения находятся между 0и 100.
Применимо только к |
| тип | нить | Тип агрегации по умолчанию.
Элемент может содержать эти значения
|
Объект _ MetricDimensionDefinition
Размерность метрики.
| Элемент | Тип | Описание |
|---|---|---|
| показать имя | нить | Отображаемое имя измерения. |
| имя | нить | Имя измерения. |
| ключ | нить | Ключ измерения.
Он должен быть уникальным в пределах метрики. |
| тип | нить | Тип измерения.
Элемент может содержать эти значения
|
| индекс | целое число | Уникальный индекс измерения, начинающийся с 0.
Добавление преобразований, таких как :names или :parents, может изменить индексы измерений. |
Объект _ MetricValueType
Тип значения для метрики.
| Элемент | Тип | Описание |
|---|---|---|
| тип | нить | Тип значения метрики
Элемент может содержать эти значения
|
JSON-модель тела ответа
{
"totalCount": 3,
"nextPageKey": "ABCDEFABCDEFABCDEF_",
"metrics": [
{
"metricId": "builtin:host.cpu.user:splitBy(\"dt.entity.host\"):max:fold",
"displayName": "CPU user",
"description": "Percentage of user-space CPU time currently utilized, per host.",
"unit": "Percent",
"dduBillable": false,
"created": 1597400123451,
"lastWritten": 1597400717783,
"entityType": [
"HOST"
],
"aggregationTypes": [
"auto",
"value"
],
"transformations": [
"filter",
"fold",
"limit",
"merge",
"names",
"parents",
"timeshift",
"rate",
"sort",
"last",
"splitBy"
],
"defaultAggregation": {
"type": "value"
},
"dimensionDefinitions": [
{
"key": "dt.entity.host",
"name": "Host",
"displayName": "Host",
"index": 0,
"type": "ENTITY"
}
],
"tags": [],
"metricValueType": {
"type": "unknown"
}
},
{
"metricId": "builtin:host.cpu.user:splitBy()",
"displayName": "CPU user",
"description": "Percentage of user-space CPU time currently utilized, per host.",
"unit": "Percent",
"dduBillable": false,
"created": 1597400123451,
"lastWritten": 1597400717783,
"entityType": [
"HOST"
],
"aggregationTypes": [
"auto",
"value"
],
"transformations": [
"filter",
"fold",
"limit",
"merge",
"names",
"parents",
"timeshift",
"rate",
"sort",
"last",
"splitBy"
],
"defaultAggregation": {
"type": "value"
},
"dimensionDefinitions": [
{
"key": "dt.entity.host",
"name": "Host",
"displayName": "Host",
"index": 0,
"type": "ENTITY"
}
],
"tags": [],
"metricValueType": {
"type": "unknown"
}
}
]
}
Пример
В этом примере запрос запрашивает все встроенные метрики ( для metricSelector установлено значение builtin:*), доступные в среде mySampleEnv . В ответ включаются следующие поля:
- идентификатор метрики
- Ед. изм
- типы агрегации
Для этого для параметра запроса полейunit,aggregationTypes установлено значение .
Маркер API передается в заголовке авторизации .
Ответ имеет application/jsonформат и усекается до четырех записей.
Завиток
curl -L -X GET 'https://mySampleEnv.live.dynatrace.com/api/v2/metrics?fields=unit,aggregationTypes&metricSelector=builtin:*' \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
-H 'Accept: application/json'
URL-адрес запроса
https://mySampleEnv.live.dynatrace.com/api/v2/metrics?fields=unit,aggregationTypes&metricSelector=builtin:*
Тело ответа
{
"totalCount": 1808,
"nextPageKey": "___a7acX3q0AAAAGAQAJYnVpbHRpbjoqAQA",
"metrics": [
{
"metricId": "builtin:host.cpu.idle",
"unit": "Percent",
"aggregationTypes": [
"auto",
"avg",
"max",
"min"
]
},
{
"metricId": "builtin:host.cpu.load",
"unit": "Ratio",
"aggregationTypes": [
"auto",
"avg",
"max",
"min"
]
},
{
"metricId": "builtin:service.errors.server.count",
"unit": "Count",
"aggregationTypes": [
"auto",
"value"
]
},
{
"metricId": "builtin:service.keyRequest.count.client",
"unit": "Count",
"aggregationTypes": [
"auto",
"value"
]
}
]
}
Таблица CSV со строкой заголовка выглядит следующим образом. Чтобы получить его, измените заголовок Accepttext/csv; header=present на .
metricId,unit,aggregationTypes
builtin:host.cpu.idle,Percent,"[auto, avg, max, min]"
builtin:host.cpu.load,Ratio,"[auto, avg, max, min]"
builtin:service.errors.server.count,Count,"[auto, value]"
builtin:service.keyRequest.count.client,Count,"[auto, value]"
Код ответа
200
