Получение точек данных: различия между версиями

Материал из Dynatrace
(Новая страница: «Извлекает параметры и точки данных указанной метрики. Чтобы получить точки данных, уста...»)
 
 
(не показана 1 промежуточная версия этого же участника)
Строка 1: Строка 1:
Извлекает параметры и точки данных указанной метрики.
Извлекает параметры и точки данных указанной метрики.


Чтобы получить точки данных, установите для параметра includeData<code>true</code> значение . Также необходимо указать период времени и тип агрегации, поддерживаемые запрашиваемой метрикой. См. раздел Параметры для более подробной информации.
Чтобы получить точки данных, установите для параметра includeData значение <code>true</code> . Также необходимо указать период времени и тип агрегации, поддерживаемые запрашиваемой метрикой.  


Вы можете получить либо точки данных, либо скалярный результат указанной метрики, в зависимости от queryMode .
Вы можете получить либо точки данных, либо скалярный результат указанной метрики, в зависимости от queryMode .


Запрос создает <code>application/json</code>полезную нагрузку.
Запрос использует в качестве полезной нагрузки формат <code>application/json</code>.
{| class="wikitable"
{| class="wikitable"
| rowspan="3" |ПОЛУЧИТЬ
| rowspan="2" |GET
|Удалось
|Managed
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v1/timeseries/{timeseriesIdentifier}</nowiki></code>
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v1/timeseries/{timeseriesIdentifier}</nowiki></code>
|-
|-
|SaaS
|Окружающая среда АктивногоШлюза
|<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v1/timeseries/{timeseriesIdentifier}</nowiki></code>
|-
|Окружающая среда ActiveGate
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v1/timeseries/{timeseriesIdentifier}</nowiki></code>
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v1/timeseries/{timeseriesIdentifier}</nowiki></code>
|}
|}


== Аутентификация ==
== Аутентификация ==
Чтобы выполнить этот запрос, вам нужен токен доступа с проблемой доступа и каналом событий, метриками и областью топологии ( <code>DataExport</code>) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Чтобы выполнить этот запрос, вам нужен токен доступа с проблемой доступа и каналом событий, метриками и областью топологии ( <code>DataExport</code>) . Чтобы узнать, как его получить и использовать, см. раздел [[Токены и аутентификация (API)|Токены и аутентификация]] .


== Параметры ==
== Параметры ==
Строка 27: Строка 24:


* Комбинация startTimestamp и endTimestamp .
* Комбинация startTimestamp и endTimestamp .
* относительное время
* relativeTime


Максимально допустимый срок — 6 месяцев.
Максимально допустимый срок — 6 месяцев.
Строка 34: Строка 31:
!Тип
!Тип
!Описание
!Описание
!В
!In
!Необходимый
!Необходимость
|-
|-
|Идентификатор таймсерии
|timeseriesIdentifier
|нить
|string
|Идентификатор временного ряда с учетом регистра, из которого вы хотите прочитать параметры и точки данных.
|Идентификатор временного ряда с учетом регистра, из которого вы хотите прочитать параметры и точки данных.
|дорожка
|path
|требуется
|требуется
|-
|-
|includeData
|includeData
|логический
|boolean
|Флаг для включения точек данных в ответ. Установите для <code>true</code>получения точек данных. Также необходимо указать таймфрейм и тип агрегации.
|Флаг для включения точек данных в ответ. Установите для <code>true</code>получения точек данных. Также необходимо указать таймфрейм и тип агрегации.


По умолчанию <code>false</code>значение , что означает, что точки данных не включены.
По умолчанию <code>false</code>значение , что означает, что точки данных не включены.
|запрос
|query
|по желанию
|по желанию
|-
|-
|тип агрегации
|aggregationType
|нить
|string
|Тип агрегации для результирующих точек данных.
|Тип агрегации для результирующих точек данных.


Если запрошенная метрика не поддерживает указанную агрегацию, запрос приведет к ошибке.
Если запрошенная метрика не поддерживает указанную агрегацию, запрос приведет к ошибке.


Элемент может содержать эти значения
Элемент может содержать эти значения:
|запрос
 
* <code>AVG</code>
* <code>COUNT</code>
* <code>MAX</code>
* <code>MEDIAN</code>
* <code>MIN</code>
* <code>PERCENTILE</code>
* <code>SUM</code>
|query
|по желанию
|по желанию
|-
|-
|startTimestamp
|startTimestamp
|целое число
|integer
|Метка времени начала запрошенного таймфрейма в миллисекундах UTC.
|Метка времени начала запрошенного таймфрейма в миллисекундах UTC.
|запрос
|query
|по желанию
|по желанию
|-
|-
|endTimestamp
|endTimestamp
|целое число
|integer
|Отметка времени окончания запрошенного таймфрейма в миллисекундах (UTC).
|Отметка времени окончания запрошенного таймфрейма в миллисекундах (UTC).


Если позже текущего времени, Dynatrace автоматически использует текущее время.
Если позже текущего времени, Ключ-АСТРОМ автоматически использует текущее время.


Срок не должен превышать 6 месяцев.
Срок не должен превышать 6 месяцев.
|запрос
|query
|по желанию
|по желанию
|-
|-
|предсказывать
|predict
|логический
|boolean
|Флаг для прогнозирования будущих точек данных.
|Флаг для прогнозирования будущих точек данных.
|запрос
|query
|по желанию
|по желанию
|-
|-
|относительное время
|relativeTime
|нить
|string
|Относительный таймфрейм, назад от текущего времени.
|Относительный таймфрейм, назад от текущего времени.


Элемент может содержать эти значения
Элемент может содержать эти значения:
|запрос
 
* <code>10mins</code>
* <code>15mins</code>
* <code>2hours</code>
* <code>30mins</code>
* <code>3days</code>
* <code>5mins</code>
* <code>6hours</code>
* <code>day</code>
* <code>hour</code>
* <code>min</code>
* <code>month</code>
* <code>week</code>
|query
|по желанию
|по желанию
|-
|-
|режим запроса
|queryMode
|нить
|string
|Тип результата, который должен вернуть вызов. Допустимые режимы результатов:
|Тип результата, который должен вернуть вызов. Допустимые режимы результатов:


Строка 103: Строка 121:
* <code>SERIES</code>
* <code>SERIES</code>
* <code>TOTAL</code>
* <code>TOTAL</code>
|запрос
|query
|по желанию
|по желанию
|-
|-
|организация
|entity
|строка []
|string []
|Фильтрует запрошенные точки данных по объекту, который должен их предоставить. Допустимые значения — идентификаторы объектов Dynatrace.
|Фильтрует запрошенные точки данных по объекту, который должен их предоставить. Допустимые значения — идентификаторы объектов Ключ-АСТРОМ.


Вы можете указать несколько сущностей в следующем формате: <code>entity=entity1&entity=entity2</code>. Сущность должна соответствовать хотя бы одному из указанных идентификаторов.
Вы можете указать несколько сущностей в следующем формате: <code>entity=entity1&entity=entity2</code>. Сущность должна соответствовать хотя бы одному из указанных идентификаторов.


Если выбранный объект не поддерживает запрошенный временной ряд, запрос приведет к ошибке.
Если выбранный объект не поддерживает запрошенный временной ряд, запрос приведет к ошибке.
|запрос
|query
|по желанию
|по желанию
|-
|-
|ярлык
|tag
|строка []
|string []
|Фильтрует запрошенные точки данных по объекту, который должен их предоставить. Доставляются данные только от сущностей с указанным тегом.
|Фильтрует запрошенные точки данных по объекту, который должен их предоставить. Доставляются данные только от сущностей с указанным тегом.


Строка 123: Строка 141:


В случае тегов «ключ-значение», таких как импортированные теги AWS или CloudFoundry, используйте <code>key:value</code>формат. Если есть также контекст, используйте <code>[context]key:value</code>формат.
В случае тегов «ключ-значение», таких как импортированные теги AWS или CloudFoundry, используйте <code>key:value</code>формат. Если есть также контекст, используйте <code>[context]key:value</code>формат.
|запрос
|query
|по желанию
|по желанию
|-
|-
|процентиль
|percentile
|целое число
|integer
|Указывает, какой процентиль выбранной метрики времени отклика должен быть предоставлен.
|Указывает, какой процентиль выбранной метрики времени отклика должен быть предоставлен.


Строка 135: Строка 153:


Имейте в виду, что экспорт процентилей возможен только для метрик, основанных на времени отклика, таких как время отклика приложений и служб.
Имейте в виду, что экспорт процентилей возможен только для метрик, основанных на времени отклика, таких как время отклика приложений и служб.
|запрос
|query
|по желанию
|по желанию
|-
|-
|includeParentIds
|includeParentIds
|логический
|boolean
|Если установлено значение true, в результате отображаются сопоставления измерений между родительскими объектами и их дочерними объектами.
|Если установлено значение true, в результате отображаются сопоставления измерений между родительскими объектами и их дочерними объектами.


Например: SERVICE-0000000000000001, SERVICE_METHOD-0000000000000001
Например: SERVICE-0000000000000001, SERVICE_METHOD-0000000000000001
|запрос
|query
|по желанию
|по желанию
|-
|-
|рассмотретьMaintenanceWindowsForAvailability
|considerMaintenanceWindowsForAvailability
|логический
|boolean
|Исключите ( <code>true</code>) или включите ( <code>false</code>) точки данных из любого периода обслуживания , определенного в вашей среде.
|Исключите ( <code>true</code>) или включите ( <code>false</code>) точки данных из любого периода обслуживания , определенного в вашей среде.
|запрос
|query
|по желанию
|по желанию
|}
|}
Строка 163: Строка 181:
|-
|-
|200
|200
|Результат запроса временных рядов
|TimeseriesQueryResult
|Успех
|Успех
|}
|}
Строка 169: Строка 187:
=== Объекты тела ответа ===
=== Объекты тела ответа ===


==== Объект _ <code>TimeseriesQueryResult</code> ====
==== Объект <code>TimeseriesQueryResult</code> ====
Конфигурация метрики со всеми ее параметрами и, при необходимости, точками данных.
Конфигурация метрики со всеми ее параметрами и, при необходимости, точками данных.
{| class="wikitable"
{| class="wikitable"
Строка 176: Строка 194:
!Описание
!Описание
|-
|-
|идентификатор таймсерии
|timeseriesId
|нить
|string
|Идентификатор метрики.
|Идентификатор метрики.
|-
|-
|показать имя
|displayName
|нить
|string
|Имя метрики в пользовательском интерфейсе.
|Имя метрики в пользовательском интерфейсе.
|-
|-
|Габаритные размеры
|dimensions
|строка []
|string []
|Точное разделение метрик, например, группа процессов и идентификатор процесса для какой-либо метрики, связанной с процессом.
|Точное разделение метрик, например, группа процессов и идентификатор процесса для какой-либо метрики, связанной с процессом.
|-
|-
|типы агрегации
|aggregationTypes
|строка []
|string []
|Список разрешенных агрегаций для этой метрики.
|Список разрешенных агрегаций для этой метрики.


Строка 202: Строка 220:
* <code>SUM</code>
* <code>SUM</code>
|-
|-
|Ед. изм
|unit
|нить
|string
|Единица измерения.
|Единица измерения.


Строка 270: Строка 288:
* <code>mCores</code>
* <code>mCores</code>
|-
|-
|фильтр
|filter
|нить
|string
|Функция, из которой берется метрика.
|Функция, из которой берется метрика.


Элемент может содержать эти значения
Элемент может содержать эти значения
* <code>ALL</code>
* <code>BUILTIN</code>
* <code>CUSTOM</code>
* <code>PLUGIN</code>
* <code>REMOTE_PLUGIN</code>
|-
|-
|подробныйИсточник
|detailedSource
|нить
|string
|Функция, из которой берется метрика.
|Функция, из которой берется метрика.
|-
|-
|идентификатор плагина
|pluginId
|нить
|string
|Идентификатор плагина, из которого создается метрика.
|Идентификатор плагина, из которого создается метрика.
|-
|-
|типы
|types
|строка []
|string []
|Определение типа технологии. Используется для группировки метрик под логическим именем технологии.
|Определение типа технологии. Используется для группировки метрик под логическим именем технологии.
|-
|-
|данныеРезультат
|dataResult
|Результат запроса точки данных временных рядов
|TimeseriesDataPointQueryResult
|Список точек данных метрики, а также их параметры.
|Список точек данных метрики, а также их параметры.
|-
|-
|предупреждения
|warnings
|строка []
|string []
|Предупреждения, возникшие при создании метрики.
|Предупреждения, возникшие при создании метрики.
|}
|}


==== Объект _ <code>TimeseriesDataPointQueryResult</code> ====
==== Объект <code>TimeseriesDataPointQueryResult</code> ====
Список точек данных метрики, а также их параметры.
Список точек данных метрики, а также их параметры.
{| class="wikitable"
{| class="wikitable"
Строка 304: Строка 328:
!Описание
!Описание
|-
|-
|точки данных
|dataPoints
|объект
|object
|Точки данных метрики.
|Точки данных метрики.


Строка 314: Строка 338:
Точка данных содержит значение и отметку времени, когда это значение было записано.
Точка данных содержит значение и отметку времени, когда это значение было записано.


Dynatrace хранит данные во временных интервалах. Объект dataPoints показывает метку времени ''начала'' слота. Если startTimestamp или endTimestamp вашего запроса находится внутри временного интервала данных, этот временной интервал включается в ответ. Из-за того, что временная метка первой точки данных находится за пределами указанного временного интервала, вы увидите ''более раннюю'' временную метку, чем указанная начальная временная метка в первой точке данных ответа.
Ключ-АСТРОМ хранит данные во временных интервалах. Объект dataPoints показывает метку времени ''начала'' слота. Если startTimestamp или endTimestamp вашего запроса находится внутри временного интервала данных, этот временной интервал включается в ответ. Из-за того, что временная метка первой точки данных находится за пределами указанного временного интервала, вы увидите ''более раннюю'' временную метку, чем указанная начальная временная метка в первой точке данных ответа.


Существует три версии точек данных:
Существует три версии точек данных:
Строка 322: Строка 346:
* Точка данных прогноза: похожа на числовую точку данных, но содержит доверительный интервал, в пределах которого ожидаются будущие значения.
* Точка данных прогноза: похожа на числовую точку данных, но содержит доверительный интервал, в пределах которого ожидаются будущие значения.
|-
|-
|идентификатор таймсерии
|timeseriesId
|нить
|string
|Идентификатор метрики.
|Идентификатор метрики.
|-
|-
|Ед. изм
|unit
|нить
|string
|Единица точек данных.
|Единица точек данных.


Строка 394: Строка 418:
* <code>mCores</code>
* <code>mCores</code>
|-
|-
|разрешениеInMillisUTC
|resolutionInMillisUTC
|целое число
|integer
|Разрешение точек данных.
|Разрешение точек данных.
|-
|-
|тип агрегации
|aggregationType
|нить
|string
|Тип агрегации точек данных.
|Тип агрегации точек данных.


Строка 412: Строка 436:
* <code>SUM</code>
* <code>SUM</code>
|-
|-
|сущности
|entities
|объект
|object
|Список сущностей, из которых исходят точки данных.
|Список сущностей, из которых исходят точки данных.


Объект JSON, который сопоставляет идентификатор объекта в Dynatrace и фактическое имя объекта.
Объект JSON, который сопоставляет идентификатор объекта в Ключ-АСТРОМ и фактическое имя объекта.
|}
|}


=== JSON-модель тела ответа ===
=== JSON-модель тела ответа ===
  <code>{
  <code>{
   "timeseriesId": "com.dynatrace.builtin:host.cpu.idle",
   "timeseriesId": "ru.ruscomtech.builtin:host.cpu.idle",
   "displayName": "CPU idle",
   "displayName": "CPU idle",
   "dimensions": [
   "dimensions": [
Строка 456: Строка 480:


== Примечание о таймфрейме ==
== Примечание о таймфрейме ==
Dynatrace хранит данные во временных интервалах. Объект <code>dataPoints</code>показывает ''начальную'' метку времени слота. Если <code>startTimestamp</code>или <code>endTimestamp</code>вашего запроса попадают в временной интервал данных, этот временной интервал будет включен в ответ. Из-за того, что временная метка первой точки данных лежит за пределами указанного временного интервала, вы увидите более ''раннюю'' временную метку, чем указанная <code>startTimestamp</code>в первой точке данных ответа.
Ключ-АСТРОМ хранит данные во временных интервалах. Объект <code>dataPoints</code>показывает ''начальную'' метку времени слота. Если <code>startTimestamp</code>или <code>endTimestamp</code>вашего запроса попадают в временной интервал данных, этот временной интервал будет включен в ответ. Из-за того, что временная метка первой точки данных лежит за пределами указанного временного интервала, вы увидите более ''раннюю'' временную метку, чем указанная <code>startTimestamp</code>в первой точке данных ответа.


== Пример ==
== Пример ==
В этом примере запрос возвращает значения метрики Действия за сеанс ( <code>com.dynatrace.builtin:app.actionspersession</code>) за последний час для приложений APPLICATION-85A7CC и APPLICATION-8E41C8 .
В этом примере запрос возвращает значения метрики Действия за сеанс ( ru<code>.ruscomtech.builtin:app.actionspersession</code>) за последний час для приложений APPLICATION-85A7CC и APPLICATION-8E41C8 .


Маркер API передается в заголовке авторизации .
Маркер API передается в заголовке авторизации .
Строка 465: Строка 489:
Результат возвращает среднее количество действий пользователя на приложение, усеченное до трех точек данных на приложение.
Результат возвращает среднее количество действий пользователя на приложение, усеченное до трех точек данных на приложение.


==== Завиток ====
==== Curl ====
  <code>curl -X GET \
  <code>curl -X GET \
   <nowiki>https://mySampleEnv.live.dynatrace.com/api/v1/timeseries/com.dynatrace.builtin:app.actionspersession?includeData=true&relativeTime=hour&aggregationType=avg&entity=APPLICATION-85A7CC&entity=APPLICATION-8E41C8</nowiki> \
   https://mySampleEnv.live.ruscomtech.ru/api/v1/timeseries/ru<nowiki/>.ruscomtech.builtin:app.actionspersession?includeData=true&relativeTime=hour&aggregationType=avg&entity=APPLICATION-85A7CC&entity=APPLICATION-8E41C8 \
   -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'</code>
   -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'</code>


==== URL-адрес запроса ====
==== URL-адрес запроса ====
  <code><nowiki>https://mySampleEnv.live.dynatrace.com/api/v1/timeseries/com.dynatrace.builtin:app.actionspersession?includeData=true&relativeTime=hour&aggregationType=avg&entity=APPLICATION-85A7CC&entity=APPLICATION-8E41C8</nowiki></code>
  <code>https://mySampleEnv.live.ruscomtech.ru/api/v1/timeseries/ru<nowiki/>.ruscomtech.builtin:app.actionspersession?includeData=true&relativeTime=hour&aggregationType=avg&entity=APPLICATION-85A7CC&entity=APPLICATION-8E41C8</code>


==== Содержание ответа ====
==== Содержание ответа ====
  <code>{
  <code>{
   "timeseriesId": "com.dynatrace.builtin:app.actionspersession",
   "timeseriesId": "ru.ruscomtech.builtin:app.actionspersession",
   "displayName": "Actions per session",
   "displayName": "Actions per session",
   "dimensions": [
   "dimensions": [
Строка 521: Строка 545:
       "APPLICATION-8E41C8": "easyTravel AMP"
       "APPLICATION-8E41C8": "easyTravel AMP"
     },
     },
     "timeseriesId": "com.dynatrace.builtin:app.actionspersession"
     "timeseriesId": "ru.ruscomtech.builtin:app.actionspersession"
   },
   },
   "aggregationTypes": [
   "aggregationTypes": [

Текущая версия на 07:42, 13 октября 2022

Извлекает параметры и точки данных указанной метрики.

Чтобы получить точки данных, установите для параметра includeData значение true . Также необходимо указать период времени и тип агрегации, поддерживаемые запрашиваемой метрикой.

Вы можете получить либо точки данных, либо скалярный результат указанной метрики, в зависимости от queryMode .

Запрос использует в качестве полезной нагрузки формат application/json.

GET Managed https://{your-domain}/e/{your-environment-id}/api/v1/timeseries/{timeseriesIdentifier}
Окружающая среда АктивногоШлюза https://{your-activegate-domain}/e/{your-environment-id}/api/v1/timeseries/{timeseriesIdentifier}

Аутентификация

Чтобы выполнить этот запрос, вам нужен токен доступа с проблемой доступа и каналом событий, метриками и областью топологии ( DataExport) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .

Параметры

Для получения точек данных необходимо указать таймфрейм и тип агрегации.

Существует два взаимоисключающих способа установки таймфрейма:

  • Комбинация startTimestamp и endTimestamp .
  • relativeTime

Максимально допустимый срок — 6 месяцев.

Параметр Тип Описание In Необходимость
timeseriesIdentifier string Идентификатор временного ряда с учетом регистра, из которого вы хотите прочитать параметры и точки данных. path требуется
includeData boolean Флаг для включения точек данных в ответ. Установите для trueполучения точек данных. Также необходимо указать таймфрейм и тип агрегации.

По умолчанию falseзначение , что означает, что точки данных не включены.

query по желанию
aggregationType string Тип агрегации для результирующих точек данных.

Если запрошенная метрика не поддерживает указанную агрегацию, запрос приведет к ошибке.

Элемент может содержать эти значения:

  • AVG
  • COUNT
  • MAX
  • MEDIAN
  • MIN
  • PERCENTILE
  • SUM
query по желанию
startTimestamp integer Метка времени начала запрошенного таймфрейма в миллисекундах UTC. query по желанию
endTimestamp integer Отметка времени окончания запрошенного таймфрейма в миллисекундах (UTC).

Если позже текущего времени, Ключ-АСТРОМ автоматически использует текущее время.

Срок не должен превышать 6 месяцев.

query по желанию
predict boolean Флаг для прогнозирования будущих точек данных. query по желанию
relativeTime string Относительный таймфрейм, назад от текущего времени.

Элемент может содержать эти значения:

  • 10mins
  • 15mins
  • 2hours
  • 30mins
  • 3days
  • 5mins
  • 6hours
  • day
  • hour
  • min
  • month
  • week
query по желанию
queryMode string Тип результата, который должен вернуть вызов. Допустимые режимы результатов:

series: возвращает все точки данных временного ряда в указанном временном интервале. total: возвращает одно скалярное значение для указанного периода времени.

По умолчанию используется seriesрежим.

Элемент может содержать эти значения

  • SERIES
  • TOTAL
query по желанию
entity string [] Фильтрует запрошенные точки данных по объекту, который должен их предоставить. Допустимые значения — идентификаторы объектов Ключ-АСТРОМ.

Вы можете указать несколько сущностей в следующем формате: entity=entity1&entity=entity2. Сущность должна соответствовать хотя бы одному из указанных идентификаторов.

Если выбранный объект не поддерживает запрошенный временной ряд, запрос приведет к ошибке.

query по желанию
tag string [] Фильтрует запрошенные точки данных по объекту, который должен их предоставить. Доставляются данные только от сущностей с указанным тегом.

Вы можете указать несколько тегов в следующем формате: tag=tag1&tag=tag2. Сущность должна соответствовать всем указанным тегам.

В случае тегов «ключ-значение», таких как импортированные теги AWS или CloudFoundry, используйте key:valueформат. Если есть также контекст, используйте [context]key:valueформат.

query по желанию
percentile integer Указывает, какой процентиль выбранной метрики времени отклика должен быть предоставлен.

Применимо только к PERCENTILEтипу агрегации.

Допустимые значения для процентиля находятся в диапазоне от 1 до 99.

Имейте в виду, что экспорт процентилей возможен только для метрик, основанных на времени отклика, таких как время отклика приложений и служб.

query по желанию
includeParentIds boolean Если установлено значение true, в результате отображаются сопоставления измерений между родительскими объектами и их дочерними объектами.

Например: SERVICE-0000000000000001, SERVICE_METHOD-0000000000000001

query по желанию
considerMaintenanceWindowsForAvailability boolean Исключите ( true) или включите ( false) точки данных из любого периода обслуживания , определенного в вашей среде. query по желанию

Ответ

Результатом является объект JSON, содержащий точки данных и параметры метрик.

Коды ответов

Код Тип Описание
200 TimeseriesQueryResult Успех

Объекты тела ответа

Объект TimeseriesQueryResult

Конфигурация метрики со всеми ее параметрами и, при необходимости, точками данных.

Элемент Тип Описание
timeseriesId string Идентификатор метрики.
displayName string Имя метрики в пользовательском интерфейсе.
dimensions string [] Точное разделение метрик, например, группа процессов и идентификатор процесса для какой-либо метрики, связанной с процессом.
aggregationTypes string [] Список разрешенных агрегаций для этой метрики.

Элемент может содержать эти значения

  • AVG
  • COUNT
  • MAX
  • MEDIAN
  • MIN
  • PERCENTILE
  • SUM
unit string Единица измерения.

Элемент может содержать эти значения

  • Billion (bilcount)
  • Bit (bit)
  • BitPerHour (bit/h)
  • BitPerMinute (bit/min)
  • BitPerSecond (bit/s)
  • Byte (B)
  • BytePerHour (B/h)
  • BytePerMinute (B/min)
  • BytePerSecond (B/s)
  • Cores
  • Count (count)
  • Day (ds)
  • DecibelMilliWatt (dBm)
  • G
  • GibiByte (GiB)
  • GigaByte (GB)
  • Hour (hs)
  • KibiByte (KiB)
  • KibiBytePerHour (KiB/h)
  • KibiBytePerMinute (KiB/min)
  • KibiBytePerSecond (KiB/s)
  • KiloByte (kB)
  • KiloBytePerHour (kB/h)
  • KiloBytePerMinute (kB/min)
  • KiloBytePerSecond (kB/s)
  • M
  • MSU
  • MebiByte (MiB)
  • MebiBytePerHour (MiB/h)
  • MebiBytePerMinute (MiB/min)
  • MebiBytePerSecond (MiB/s)
  • MegaByte (MB)
  • MegaBytePerHour (MB/h)
  • MegaBytePerMinute (MB/min)
  • MegaBytePerSecond (MB/s)
  • MicroSecond (µs)
  • MilliSecond (ms)
  • MilliSecondPerMinute (ms/min)
  • Million (milcount)
  • Minute (mins)
  • Month (mos)
  • N/A
  • NanoSecond (ns)
  • NanoSecondPerMinute (ns/min)
  • PerHour (count/h)
  • PerMinute (count/min)
  • PerSecond (count/s)
  • Percent (%)
  • Pixel (px)
  • Promille (‰)
  • Ratio
  • Second (s)
  • State
  • Unspecified
  • Week (ws)
  • Year (ys)
  • k
  • km/h
  • m/h
  • m/s
  • mCores
filter string Функция, из которой берется метрика.

Элемент может содержать эти значения

  • ALL
  • BUILTIN
  • CUSTOM
  • PLUGIN
  • REMOTE_PLUGIN
detailedSource string Функция, из которой берется метрика.
pluginId string Идентификатор плагина, из которого создается метрика.
types string [] Определение типа технологии. Используется для группировки метрик под логическим именем технологии.
dataResult TimeseriesDataPointQueryResult Список точек данных метрики, а также их параметры.
warnings string [] Предупреждения, возникшие при создании метрики.

Объект TimeseriesDataPointQueryResult

Список точек данных метрики, а также их параметры.

Элемент Тип Описание
dataPoints object Точки данных метрики.

Объект JSON, который сопоставляет идентификатор объекта, предоставившего точки данных, и массив, состоящий из массивов значений с плавающей запятой точек данных.

Может содержать более одного идентификатора объекта на запись (например, хост и его сетевой интерфейс). В таких случаях идентификаторы объектов разделяются запятыми.

Точка данных содержит значение и отметку времени, когда это значение было записано.

Ключ-АСТРОМ хранит данные во временных интервалах. Объект dataPoints показывает метку времени начала слота. Если startTimestamp или endTimestamp вашего запроса находится внутри временного интервала данных, этот временной интервал включается в ответ. Из-за того, что временная метка первой точки данных находится за пределами указанного временного интервала, вы увидите более раннюю временную метку, чем указанная начальная временная метка в первой точке данных ответа.

Существует три версии точек данных:

  • Числовая точка данных: содержит числовое значение.
  • Точка данных перечисления: содержит значение перечисления, в настоящее время только для временных рядов доступности.
  • Точка данных прогноза: похожа на числовую точку данных, но содержит доверительный интервал, в пределах которого ожидаются будущие значения.
timeseriesId string Идентификатор метрики.
unit string Единица точек данных.

Элемент может содержать эти значения

  • Billion (bilcount)
  • Bit (bit)
  • BitPerHour (bit/h)
  • BitPerMinute (bit/min)
  • BitPerSecond (bit/s)
  • Byte (B)
  • BytePerHour (B/h)
  • BytePerMinute (B/min)
  • BytePerSecond (B/s)
  • Cores
  • Count (count)
  • Day (ds)
  • DecibelMilliWatt (dBm)
  • G
  • GibiByte (GiB)
  • GigaByte (GB)
  • Hour (hs)
  • KibiByte (KiB)
  • KibiBytePerHour (KiB/h)
  • KibiBytePerMinute (KiB/min)
  • KibiBytePerSecond (KiB/s)
  • KiloByte (kB)
  • KiloBytePerHour (kB/h)
  • KiloBytePerMinute (kB/min)
  • KiloBytePerSecond (kB/s)
  • M
  • MSU
  • MebiByte (MiB)
  • MebiBytePerHour (MiB/h)
  • MebiBytePerMinute (MiB/min)
  • MebiBytePerSecond (MiB/s)
  • MegaByte (MB)
  • MegaBytePerHour (MB/h)
  • MegaBytePerMinute (MB/min)
  • MegaBytePerSecond (MB/s)
  • MicroSecond (µs)
  • MilliSecond (ms)
  • MilliSecondPerMinute (ms/min)
  • Million (milcount)
  • Minute (mins)
  • Month (mos)
  • N/A
  • NanoSecond (ns)
  • NanoSecondPerMinute (ns/min)
  • PerHour (count/h)
  • PerMinute (count/min)
  • PerSecond (count/s)
  • Percent (%)
  • Pixel (px)
  • Promille (‰)
  • Ratio
  • Second (s)
  • State
  • Unspecified
  • Week (ws)
  • Year (ys)
  • k
  • km/h
  • m/h
  • m/s
  • mCores
resolutionInMillisUTC integer Разрешение точек данных.
aggregationType string Тип агрегации точек данных.

Элемент может содержать эти значения

  • AVG
  • COUNT
  • MAX
  • MEDIAN
  • MIN
  • PERCENTILE
  • SUM
entities object Список сущностей, из которых исходят точки данных.

Объект JSON, который сопоставляет идентификатор объекта в Ключ-АСТРОМ и фактическое имя объекта.

JSON-модель тела ответа

{
  "timeseriesId": "ru.ruscomtech.builtin:host.cpu.idle",
  "displayName": "CPU idle",
  "dimensions": [
    "HOST"
  ],
  "aggregationTypes": [
    "AVG",
    "SUM",
    "MIN",
    "MAX"
  ],
  "unit": "Percent",
  "filter": "BUILTIN",
  "detailedSource": "Infrastructure",
  "types": [],
  "dataResult": {
    "dataPoints": {
      "HOST-0000000000000007": [
        [
          1522220334000,
          89
        ]
      ]
    },
    "timeseriesId": "com.dynatrace.builtin:host.cpu.idle",
    "unit": "Percent",
    "entities": {
      "HOST-0000000000000007": "Laptop-8"
    },
    "resolutionInMillisUTC": 300000,
    "aggregationType": "AVG"
  }
}

Примечание о таймфрейме

Ключ-АСТРОМ хранит данные во временных интервалах. Объект dataPointsпоказывает начальную метку времени слота. Если startTimestampили endTimestampвашего запроса попадают в временной интервал данных, этот временной интервал будет включен в ответ. Из-за того, что временная метка первой точки данных лежит за пределами указанного временного интервала, вы увидите более раннюю временную метку, чем указанная startTimestampв первой точке данных ответа.

Пример

В этом примере запрос возвращает значения метрики Действия за сеанс ( ru.ruscomtech.builtin:app.actionspersession) за последний час для приложений APPLICATION-85A7CC и APPLICATION-8E41C8 .

Маркер API передается в заголовке авторизации .

Результат возвращает среднее количество действий пользователя на приложение, усеченное до трех точек данных на приложение.

Curl

curl -X GET \
  https://mySampleEnv.live.ruscomtech.ru/api/v1/timeseries/ru.ruscomtech.builtin:app.actionspersession?includeData=true&relativeTime=hour&aggregationType=avg&entity=APPLICATION-85A7CC&entity=APPLICATION-8E41C8 \
  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

URL-адрес запроса

https://mySampleEnv.live.ruscomtech.ru/api/v1/timeseries/ru.ruscomtech.builtin:app.actionspersession?includeData=true&relativeTime=hour&aggregationType=avg&entity=APPLICATION-85A7CC&entity=APPLICATION-8E41C8

Содержание ответа

{
  "timeseriesId": "ru.ruscomtech.builtin:app.actionspersession",
  "displayName": "Actions per session",
  "dimensions": [
    "APPLICATION"
  ],
  "unit": "PerMinute (count/min)",
  "detailedSource": "Web application",
  "types": [],
  "dataResult": {
    "dataPoints": {
      "APPLICATION-85A7CC": [
        [
          1534921560000,
          1.75
        ],
        [
          1534921620000,
          2
        ],
        [
          1534921680000,
          2
        ]
      ],
      "APPLICATION-8E41C8": [
        [
          1534921560000,
          4
        ],
        [
          1534921620000,
          7
        ],
        [
          1534921680000,
          4
        ]
      ]
    },
    "unit": "PerMinute (count/min)",
    "resolutionInMillisUTC": 60000,
    "aggregationType": "AVG",
    "entities": {
      "APPLICATION-85A7CC": "Permanent Docker",
      "APPLICATION-8E41C8": "easyTravel AMP"
    },
    "timeseriesId": "ru.ruscomtech.builtin:app.actionspersession"
  },
  "aggregationTypes": [
    "AVG"
  ],
  "filter": "BUILTIN"
}

Код ответа

200