Получение списка метрик
Список всех определений метрик, а также параметры каждой метрики, доступные в вашей среде.
Полный список может быть длинным, но вы можете сузить его, указав параметры фильтра, такие как источник метрики. Дополнительные сведения см. в раскрывающемся разделе « Параметры ».
Запрос создает application/json
полезную нагрузку.
ПОЛУЧИТЬ | Удалось | https://{your-domain}/e/{your-environment-id}/api/v1/timeseries
|
SaaS | https://{your-environment-id}.live.dynatrace.com/api/v1/timeseries
| |
Окружающая среда ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v1/timeseries
|
Аутентификация
Чтобы выполнить этот запрос, вам нужен токен доступа с проблемой доступа и каналом событий, метриками и областью топологии ( DataExport
) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
Параметр | Тип | Описание | В | Необходимый |
---|---|---|---|---|
источник | нить | Тип показателя, например BUILTIN или CUSTOM.
Элемент может содержать эти значения |
запрос | по желанию |
подробныйИсточник | нить | Функция, из которой берутся метрики, например, синтетическая или RUM. | запрос | по желанию |
Возможные значения detailedSource
элемента:
Вы можете найти допустимые значения для detailedSource
элемента в подзаголовках разделов Встроенные метрики и Плагинные метрики на страницах доступных метрик для SaaS и Managed . Используйте их точно так же, как и в заголовках, включая пробелы.
Ответ
Результатом является JSON, содержащий массив объектов, где каждый объект представляет собой метрику.
Коды ответов
Код | Тип | Описание |
---|---|---|
200 | Определение таймсерии [] | Успех |
Объекты тела ответа
Объект _ ResponseBody
Объект не предоставляет никаких параметров.
Объект _ TimeseriesDefinition
Конфигурация метрики со всеми ее параметрами.
Элемент | Тип | Описание |
---|---|---|
идентификатор таймсерии | нить | Идентификатор метрики. |
показать имя | нить | Имя метрики в пользовательском интерфейсе. |
Габаритные размеры | строка [] | Точное разделение метрик, например, группа процессов и идентификатор процесса для какой-либо метрики, связанной с процессом. |
типы агрегации | строка [] | Список разрешенных агрегаций для этой метрики.
Элемент может содержать эти значения |
Ед. изм | нить | Единица измерения.
Элемент может содержать эти значения |
фильтр | нить | Функция, из которой берется метрика.
Элемент может содержать эти значения |
подробныйИсточник | нить | Функция, из которой берется метрика. |
идентификатор плагина | нить | Идентификатор плагина, из которого создается метрика. |
типы | строка [] | Определение типа технологии. Используется для группировки метрик под логическим именем технологии. |
предупреждения | строка [] | Предупреждения, возникшие при создании метрики. |
JSON-модель тела ответа
[
{
"timeseriesId": "com.dynatrace.builting:host.cpu.idle",
"displayName": "CPU idle",
"dimensions": [
"HOST"
],
"aggregationTypes": [
"AVG",
"SUM",
"MIN",
"MAX"
],
"unit": "Percent",
"filter": "BUILTIN",
"detailedSource": "Infrastructure",
"types": [
"Test"
],
"warnings": []
}
]
Пример
В этом примере в запросе указана метрика типа PLUGIN , где подробный источник — PHP-FPM .
Маркер API передается в заголовке авторизации .
Результат усекается до двух записей.
Завиток
curl -X GET \
'https://mySampleEnv.live.dynatrace.com/api/v1/timeseries?source=plugin&detailedsource=PHP-FPM' \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
URL-адрес запроса
https://mySampleEnv.live.dynatrace.com/api/v1/timeseries?api-token&source=plugin&detailedsource=PHP-FPM
Содержание ответа
[
{
"timeseriesId": "beta.python.phpfpm.dev:accepted conn",
"displayName": "accepted conn",
"dimensions": [
"PROCESS_GROUP_INSTANCE",
"pool"
],
"aggregationTypes": [
"AVG",
"SUM",
"MIN",
"MAX"
],
"unit": "Count (count)",
"filter": "PLUGIN",
"detailedSource": "PHP-FPM",
"pluginId": "beta.python.phpfpm.dev",
"types": []
},
{
"timeseriesId": "beta.python.phpfpm.dev:active processes",
"displayName": "active processes",
"dimensions": [
"PROCESS_GROUP_INSTANCE",
"pool"
],
"aggregationTypes": [
"AVG",
"SUM",
"MIN",
"MAX"
],
"unit": "Count (count)",
"filter": "PLUGIN",
"detailedSource": "PHP-FPM",
"pluginId": "beta.python.phpfpm.dev",
"types": []
}
]
Код ответа
200
Типы процессов
Список известных типов процессов, которые мы отслеживаем с помощью Dynatrace, постоянно растет. Если вы не видите нужный тип процесса в приведенном ниже списке, перейдите на страницу процессов Dynatrace, чтобы узнать, включен ли туда этот процесс.
Нажмите, чтобы просмотреть список типов процессов
типы ОС
Список известных операционных систем, которые мы отслеживаем с помощью Dynatrace, постоянно растет. Если вы не видите нужный тип ОС в списке ниже, обратитесь к странице хостов Dynatrace, чтобы узнать, указан ли там тип ОС.
Нажмите, чтобы просмотреть список ОС
Типы услуг
Нажмите, чтобы просмотреть список услуг
Типы технологий
Нажмите, чтобы просмотреть список технологий
Типы агрегации
Нажмите, чтобы просмотреть список типов агрегации
|
|