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

Материал из Dynatrace
(Новая страница: «Извлекает параметры и точки данных указанной метрики. По сравнению с запросом GET запрос P...»)
 
Строка 1: Строка 1:
Извлекает параметры и точки данных указанной метрики. По сравнению с запросом GET запрос POST предоставляет меньше данных о самой метрике.
Извлекает параметры и точки данных указанной метрики. По сравнению с запросом GET запрос POST предоставляет меньше данных о самой метрике.


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


Запрос потребляет и создает <code>application/json</code>полезную нагрузку.
Запрос потребляет и создает <code>application/json</code>полезную нагрузку.
{| class="wikitable"
{| class="wikitable"
| rowspan="3" |ПОЧТА
| rowspan="3" |POST
|Удалось
|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
|SaaS
|<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v1/timeseries/{timeseriesIdentifier}</nowiki></code>
|<code><nowiki>https://{your-environment-id}.live.ruscomtech.ru/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)|Токены и аутентификация]] .


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


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


Максимально допустимый срок — 6 месяцев.
Максимально допустимый срок — 6 месяцев.
Строка 32: Строка 32:
!Тип
!Тип
!Описание
!Описание
!В
!In
!Необходимый
!Необходимость
|-
|-
|Идентификатор таймсерии
|timeseriesIdentifier
|нить
|string
|Идентификатор временного ряда с учетом регистра, из которого вы хотите прочитать параметры и точки данных.
|Идентификатор временного ряда с учетом регистра, из которого вы хотите прочитать параметры и точки данных.
|дорожка
|path
|требуется
|требуется
|-
|-
|тело
|body
|Сообщение запроса временных рядов
|TimeseriesQueryMessage
|Тело запроса JSON, содержащее параметры для определения необходимых точек данных.
|Тело запроса JSON, содержащее параметры для определения необходимых точек данных.
|тело
|body
|по желанию
|по желанию
|}
|}
Строка 50: Строка 50:
=== Объекты тела запроса ===
=== Объекты тела запроса ===


==== Объект _ <code>TimeseriesQueryMessage</code> ====
==== Объект <code>TimeseriesQueryMessage</code> ====
Параметры фильтрации для запроса временных рядов.
Параметры фильтрации для запроса временных рядов.
{| class="wikitable"
{| class="wikitable"
Строка 56: Строка 56:
!Тип
!Тип
!Описание
!Описание
!Необходимый
!Необходимость
|-
|-
|идентификатор таймсерии
|timeseriesId
|нить
|string
|Идентификатор метрики с учетом регистра, в которой вы хотите считать точки данных.
|Идентификатор метрики с учетом регистра, в которой вы хотите считать точки данных.


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


Строка 83: Строка 83:
|-
|-
|startTimestamp
|startTimestamp
|целое число
|integer
|Метка времени начала таймфрейма в миллисекундах UTC.
|Метка времени начала таймфрейма в миллисекундах UTC.
|по желанию
|по желанию
|-
|-
|endTimestamp
|endTimestamp
|целое число
|integer
|Метка времени начала таймфрейма в миллисекундах UTC.
|Метка времени начала таймфрейма в миллисекундах UTC.


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


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


Строка 121: Строка 121:
|по желанию
|по желанию
|-
|-
|режим запроса
|queryMode
|нить
|string
|Определяет тип результата, который должен возвращать вызов. Допустимые режимы результатов:
|Определяет тип результата, который должен возвращать вызов. Допустимые режимы результатов:


Строка 135: Строка 135:
|по желанию
|по желанию
|-
|-
|сущности
|entities
|строка []
|string []
|Фильтрует запрошенные точки данных по объектам, которые должны их предоставить. Вы можете указать сразу несколько сущностей.
|Фильтрует запрошенные точки данных по объектам, которые должны их предоставить. Вы можете указать сразу несколько сущностей.


Допустимые значения — идентификаторы объектов Dynatrace.
Допустимые значения — идентификаторы объектов Ключ-АСТРОМ.


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


Строка 153: Строка 153:
|по желанию
|по желанию
|-
|-
|фильтры
|filters
|объект
|object
|Фильтр — это объект, содержащий карту ключей фильтра и его значений. Действительные ключи фильтра:
|Фильтр — это объект, содержащий карту ключей фильтра и его значений. Действительные ключи фильтра:


Строка 160: Строка 160:
|по желанию
|по желанию
|-
|-
|процентиль
|percentile
|целое число
|integer
|Указывает, какой процентиль выбранной метрики времени отклика должен быть предоставлен.
|Указывает, какой процентиль выбранной метрики времени отклика должен быть предоставлен.


Строка 172: Строка 172:
|-
|-
|includeParentIds
|includeParentIds
|логический
|boolean
|Указывает, должны ли результаты отображать сопоставления измерений между родительскими объектами и их дочерними объектами.
|Указывает, должны ли результаты отображать сопоставления измерений между родительскими объектами и их дочерними объектами.


Строка 178: Строка 178:
|по желанию
|по желанию
|-
|-
|рассмотретьMaintenanceWindowsForAvailability
|considerMaintenanceWindowsForAvailability
|логический
|boolean
|Исключите ( <code>true</code>) или включите ( <code>false</code>) точки данных из любого периода обслуживания , определенного в вашей среде.
|Исключите ( <code>true</code>) или включите ( <code>false</code>) точки данных из любого периода обслуживания , определенного в вашей среде.
|по желанию
|по желанию
Строка 187: Строка 187:
Это модель тела запроса, показывающая возможные элементы. Его необходимо настроить для использования в реальном запросе.
Это модель тела запроса, показывающая возможные элементы. Его необходимо настроить для использования в реальном запросе.
  <code>{
  <code>{
   "timeseriesId": "com.dynatrace.builtin:host.cpu.idle",
   "timeseriesId": "ru.ruscomtech.builtin:host.cpu.idle",
   "aggregationType": "AVG",
   "aggregationType": "AVG",
   "startTimestamp": 1521042929000,
   "startTimestamp": 1521042929000,
Строка 214: Строка 214:
|-
|-
|200
|200
|Оболочка результатов запроса временных рядов
|TimeseriesQueryResultWrapper
|Успех
|Успех
|}
|}
Строка 220: Строка 220:
=== Объекты тела ответа ===
=== Объекты тела ответа ===


==== Объект _ <code>TimeseriesQueryResultWrapper</code> ====
==== Объект <code>TimeseriesQueryResultWrapper</code> ====
{| class="wikitable"
{| class="wikitable"
!Элемент
!Элемент
Строка 226: Строка 226:
!Описание
!Описание
|-
|-
|результат
|result
|Результат запроса точки данных временных рядов
|TimeseriesDataPointQueryResult
|Список точек данных метрики, а также их параметры.
|Список точек данных метрики, а также их параметры.
|}
|}


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


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


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


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


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


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


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


Строка 302: Строка 364:
       ]
       ]
     },
     },
     "timeseriesId": "com.dynatrace.builtin:host.cpu.idle",
     "timeseriesId": "ru.ruscomtech.builtin:host.cpu.idle",
     "unit": "Percent",
     "unit": "Percent",
     "entities": {
     "entities": {
Строка 313: Строка 375:


== Примечание о таймфрейме ==
== Примечание о таймфрейме ==
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 . Результат возвращает среднее количество действий пользователя в приложении. Результат усекается до трех точек данных для каждого приложения.
В этом примере запрос возвращает значения метрики Действия за сеанс ( <code>ru.ruscomtech.builtin:app.actionspersession</code>) за последний час для приложений APPLICATION-85A7CC и APPLICATION-8E41C8 . Результат возвращает среднее количество действий пользователя в приложении. Результат усекается до трех точек данных для каждого приложения.


==== Завиток ====
==== Curl ====
  <code>curl -X POST \
  <code>curl -X POST \
   <nowiki>https://mySampleEnv.live.dynatrace.com/api/v1/timeseries</nowiki> \
   <nowiki>https://mySampleEnv.live.ruscomtech.ru/api/v1/timeseries</nowiki> \
   -H 'Authorization: abcdefjhij1234567890' \
   -H 'Authorization: abcdefjhij1234567890' \
   -H 'Content-Type: application/json' \
   -H 'Content-Type: application/json' \
   -d '{
   -d '{
   "timeseriesId": "com.dynatrace.builtin:app.actionspersession",
   "timeseriesId": "ru.ruscomtech.builtin:app.actionspersession",
   "relativeTime": "hour",
   "relativeTime": "hour",
   "aggregationType": "avg",
   "aggregationType": "avg",
Строка 334: Строка 396:


==== URL-адрес запроса ====
==== URL-адрес запроса ====
  <code><nowiki>https://mySampleEnv.live.dynatrace.com/api/v1/timeseries</nowiki></code>
  <code><nowiki>https://mySampleEnv.live.ruscomtech.ru/api/v1/timeseries</nowiki></code>


==== Тело запроса ====
==== Тело запроса ====
  <code>{
  <code>{
   "timeseriesId": "com.dynatrace.builtin:app.actionspersession",
   "timeseriesId": "ru.ruscomtech.builtin:app.actionspersession",
   "relativeTime": "hour",
   "relativeTime": "hour",
   "aggregationType": "avg",
   "aggregationType": "avg",
Строка 387: Строка 449:
       "APPLICATION-8E41C8": "easyTravel AMP"
       "APPLICATION-8E41C8": "easyTravel AMP"
     },
     },
     "timeseriesId": "com.dynatrace.builtin:app.actionspersession"
     "timeseriesId": "ru.ruscomtech.builtin:app.actionspersession"
   }
   }
  }</code>
  }</code>

Версия 13:58, 7 октября 2022

Извлекает параметры и точки данных указанной метрики. По сравнению с запросом GET запрос POST предоставляет меньше данных о самой метрике.

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

Запрос потребляет и создает application/jsonполезную нагрузку.

POST Managed https://{your-domain}/e/{your-environment-id}/api/v1/timeseries/{timeseriesIdentifier}
SaaS https://{your-environment-id}.live.ruscomtech.ru/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 требуется
body TimeseriesQueryMessage Тело запроса JSON, содержащее параметры для определения необходимых точек данных. body по желанию

Объекты тела запроса

Объект TimeseriesQueryMessage

Параметры фильтрации для запроса временных рядов.

Элемент Тип Описание Необходимость
timeseriesId string Идентификатор метрики с учетом регистра, в которой вы хотите считать точки данных.

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

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

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

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

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

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

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

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

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

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

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

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

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

  • SERIES
  • TOTAL
по желанию
entities string [] Фильтрует запрошенные точки данных по объектам, которые должны их предоставить. Вы можете указать сразу несколько сущностей.

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

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

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

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

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

по желанию
filters object Фильтр — это объект, содержащий карту ключей фильтра и его значений. Действительные ключи фильтра:

processType: фильтрует по типу процесса. Допустимые значения см. в разделе Типы процессов. osType: фильтрация по операционной системе. Допустимые значения см. в разделе Типы ОС. serviceType: фильтрация по типу службы. Допустимые значения см. в разделе Типы служб. technology: фильтрация по типу технологии. Допустимые значения см. в разделе Типы технологий. webServiceName: фильтрация по имени веб-службы. webServiceNamespace: фильтрация по пространству имен веб-службы. host: Фильтрация по идентификатору хоста, например HOST-007.

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

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

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

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

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

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

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

JSON-модель тела запроса

Это модель тела запроса, показывающая возможные элементы. Его необходимо настроить для использования в реальном запросе.

{
  "timeseriesId": "ru.ruscomtech.builtin:host.cpu.idle",
  "aggregationType": "AVG",
  "startTimestamp": 1521042929000,
  "endTimestamp": 1521542929000,
  "predict": true,
  "relativeTime": "HOUR",
  "queryMode": "SERIES",
  "includeParentIds": "false",
  "considerMaintenanceWindowsForAvailability": "false",
  "entities": [
    "HOST-0000000000000007"
  ],
  "tags": [
    "office-linz"
  ]
}

Ответ

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

Коды ответов

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

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

Объект TimeseriesQueryResultWrapper

Элемент Тип Описание
result TimeseriesDataPointQueryResult Список точек данных метрики, а также их параметры.

Объект 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-модель тела ответа

{
  "result": {
    "dataPoints": {
      "HOST-0000000000000007": [
        [
          1522220334000,
          89
        ]
      ]
    },
    "timeseriesId": "ru.ruscomtech.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 . Результат возвращает среднее количество действий пользователя в приложении. Результат усекается до трех точек данных для каждого приложения.

Curl

curl -X POST \
  https://mySampleEnv.live.ruscomtech.ru/api/v1/timeseries \
  -H 'Authorization: abcdefjhij1234567890' \
  -H 'Content-Type: application/json' \
  -d '{
  "timeseriesId": "ru.ruscomtech.builtin:app.actionspersession",
  "relativeTime": "hour",
  "aggregationType": "avg",
  "entities": [
    "APPLICATION-85A7CCAAC7345F0B",
    "APPLICATION-8E41C8C247910758"
    ]
}'

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

https://mySampleEnv.live.ruscomtech.ru/api/v1/timeseries

Тело запроса

{
  "timeseriesId": "ru.ruscomtech.builtin:app.actionspersession",
  "relativeTime": "hour",
  "aggregationType": "avg",
  "entities": [
    "APPLICATION-85A7CC",
    "APPLICATION-8E41C8"
  ]
}

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

{
  "result": {
    "dataPoints": {
      "APPLICATION-85A7CC": [
        [
          1534920000000,
          1.6666666666666667
        ],
        [
          1534920060000,
          2.5
        ],
        [
          1534920120000,
          2.888888888888889
        ]
      ],
      "APPLICATION-8E41C8": [
        [
          1534920000000,
          null
        ],
        [
          1534920060000,
          3
        ],
        [
          1534920120000,
          null
        ]
      ]
    },
    "unit": "PerMinute (count/min)",
    "resolutionInMillisUTC": 60000,
    "aggregationType": "AVG",
    "entities": {
      "APPLICATION-85A7CC": "Permanent Docker",
      "APPLICATION-8E41C8": "easyTravel AMP"
    },
    "timeseriesId": "ru.ruscomtech.builtin:app.actionspersession"
  }
}

Код ответа

200