Получение списка метрик: различия между версиями
ENetrebin (обсуждение | вклад) |
ENetrebin (обсуждение | вклад) |
||
Строка 10: | Строка 10: | ||
|- | |- | ||
|SaaS | |SaaS | ||
|<code>https://{your-environment-id}.live. | |<code><nowiki>https://{your-environment-id}.live.dynatrace.com</nowiki><nowiki/>/api/v1/timeseries</code> | ||
|- | |- | ||
|Окружающая среда АктивногоШлюза | |Окружающая среда АктивногоШлюза | ||
Строка 279: | Строка 279: | ||
== Типы процессов == | == Типы процессов == | ||
Список известных типов процессов, которые мы отслеживаем с помощью | Список известных типов процессов, которые мы отслеживаем с помощью Dynatrace, постоянно растет. Если вы не видите нужный тип процесса в приведенном ниже списке, перейдите на страницу процессов Dynatrace, чтобы узнать, включен ли туда этот процесс. | ||
Cписок типов процессов: | Cписок типов процессов: | ||
Строка 327: | Строка 327: | ||
== Типы ОС == | == Типы ОС == | ||
Список известных операционных систем, которые мы отслеживаем с помощью | Список известных операционных систем, которые мы отслеживаем с помощью Dynatrace, постоянно растет. Если вы не видите нужный тип ОС в списке ниже, обратитесь к странице хостов Dynatrace, чтобы узнать, указан ли там тип ОС. | ||
Cписок ОС: | Cписок ОС: |
Текущая версия на 13:52, 30 января 2023
Список всех определений метрик, а также параметры каждой метрики, доступные в вашей среде.
Полный список может быть длинным, но вы можете сузить его, указав параметры фильтра, такие как источник метрики.
Запрос создает application/json
полезную нагрузку.
GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v1/timeseries
|
SaaS | https://{your-environment-id}.live.dynatrace.com/api/v1/timeseries
| |
Окружающая среда АктивногоШлюза | https://{your-activegate-domain}/e/{your-environment-id}/api/v1/timeseries
|
Аутентификация
Чтобы выполнить этот запрос, вам нужен токен доступа с проблемой доступа и каналом событий, метриками и областью топологии ( DataExport
) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
Параметр | Тип | Описание | In | Необходимость |
---|---|---|---|---|
source | string | Тип показателя, например BUILTIN или CUSTOM.
Элемент может содержать эти значения |
query | по желанию |
detailedSource | string | Функция, из которой берутся метрики, например, синтетическая или RUM. | query | по желанию |
Возможные значения detailedSource
элемента:
Вы можете найти допустимые значения для detailedSource
элемента в подзаголовках разделов Встроенные метрики и Плагинные метрики на страницах доступных метрик для SaaS и Managed . Используйте их точно так же, как и в заголовках, включая пробелы.
Ответ
Результатом является JSON, содержащий массив объектов, где каждый объект представляет собой метрику.
Коды ответов
Код | Тип | Описание |
---|---|---|
200 | TimeseriesDefinition[] | Успех |
Объекты тела ответа
Объект ResponseBody
Объект не предоставляет никаких параметров.
Объект TimeseriesDefinition
Конфигурация метрики со всеми ее параметрами.
Элемент | Тип | Описание |
---|---|---|
timeseriesId | string | Идентификатор метрики. |
displayName | string | Имя метрики в пользовательском интерфейсе. |
dimensions | string[] | Точное разделение метрик, например, группа процессов и идентификатор процесса для какой-либо метрики, связанной с процессом. |
aggregationTypes | string[] | Список разрешенных агрегаций для этой метрики.
Элемент может содержать эти значения
|
unit | string | Единица измерения.
Элемент может содержать эти значения
|
filter | string | Функция, из которой берется метрика.
Элемент может содержать эти значения
|
detailedSource | string | Функция, из которой берется метрика. |
pluginId | string | Идентификатор плагина, из которого создается метрика. |
types | string [] | Определение типа технологии. Используется для группировки метрик под логическим именем технологии. |
warnings | string [] | Предупреждения, возникшие при создании метрики. |
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
curl -X GET \
'https://mySampleEnv.live.ruscomtech.ru/api/v1/timeseries?source=plugin&detailedsource=PHP-FPM' \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
URL-адрес запроса
https://mySampleEnv.live.ruscomtech.ru/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, чтобы узнать, включен ли туда этот процесс.
Cписок типов процессов:
|
|
|
|
Типы ОС
Список известных операционных систем, которые мы отслеживаем с помощью Dynatrace, постоянно растет. Если вы не видите нужный тип ОС в списке ниже, обратитесь к странице хостов Dynatrace, чтобы узнать, указан ли там тип ОС.
Cписок ОС:
|
|
Типы услуг
Список услуг:
|
|
Типы технологий
Список технологий:
|
|
Типы агрегации
Нажмите, чтобы просмотреть список типов агрегации
|
|