GET точек данных - История изменений

IKuznetsov в 11:39, 29 декабря 2024

2024-12-29T11:39:54Z

← Предыдущая версия		Версия от 11:39, 29 декабря 2024
Строка 1:		Строка 1:
	'''''[[API АппОптима]] / Эндпойнты среды / Развёртывание / Таймсерии v1 / Чтение точек данных / GET точек данных'''''		'''''[[API АппОптима]] / [[API АппОптима\|Эндпойнты среды]] / [https://docs.expert-apm.ru/index.php/API_%D0%90%D0%BF%D0%BF%D0%9E%D0%BF%D1%82%D0%B8%D0%BC%D0%B0#:~:text=DELETE%20%D1%82%D0%B5%D0%B3%D0%BE%D0%B2-,%D0%A0%D0%B0%D0%B7%D0%B2%D1%91%D1%80%D1%82%D1%8B%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5,-%D0%BF%D1%80%D0%B0%D0%B2%D0%B8%D1%82%D1%8C Развёртывание] / [https://docs.expert-apm.ru/index.php/API_%D0%90%D0%BF%D0%BF%D0%9E%D0%BF%D1%82%D0%B8%D0%BC%D0%B0#:~:text=POST%20%D0%BB%D0%BE%D0%B3%D0%B0%20%D0%BD%D0%B0%D0%B3%D1%80%D1%83%D0%B7%D0%BA%D0%B8-,%D0%A2%D0%B0%D0%B9%D0%BC%D1%81%D0%B5%D1%80%D0%B8%D0%B8%20v1,-%D0%9F%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D1%8C%D1%81%D0%BA%D0%B8%D0%B5%20%D0%BC%D0%B5%D1%82%D1%80%D0%B8%D0%BA%D0%B8 Таймсерии v1] / [https://docs.expert-apm.ru/index.php/API_%D0%90%D0%BF%D0%BF%D0%9E%D0%BF%D1%82%D0%B8%D0%BC%D0%B0#:~:text=GET%20%D0%BE%D0%BF%D1%80%D0%B5%D0%B4%D0%B5%D0%BB%D0%B5%D0%BD%D0%B8%D1%8F%20%D0%BC%D0%B5%D1%82%D1%80%D0%B8%D0%BA-,%D0%A7%D1%82%D0%B5%D0%BD%D0%B8%D0%B5%20%D1%82%D0%BE%D1%87%D0%B5%D0%BA%20%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85,-GET%20%D1%82%D0%BE%D1%87%D0%B5%D0%BA%20%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85 Чтение точек данных] / GET точек данных'''''

	Извлекает параметры и точки данных указанной метрики.		Извлекает параметры и точки данных указанной метрики.
Строка 463:		Строка 463:
	"aggregationType": "AVG"		"aggregationType": "AVG"
	}		}
	}~~</code>~~		}

	== Примечание о таймфрейме ==		== Примечание о таймфрейме ==
Строка 478:		Строка 478:
	<curl -X GET \		<curl -X GET \
	<nowiki>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</nowiki> \		<nowiki>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</nowiki> \
	-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'~~</code>~~		-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

	==== URL-адрес запроса ====		==== URL-адрес запроса ====
Строка 537:		Строка 537:
	],		],
	"filter": "BUILTIN"		"filter": "BUILTIN"
	}~~</code>~~		}

	==== Код ответа ====		==== Код ответа ====
	200		200

IKuznetsov в 10:17, 26 декабря 2024

2024-12-26T10:17:24Z

← Предыдущая версия		Версия от 10:17, 26 декабря 2024
Строка 1:		Строка 1:
	'''''[[API ~~Ключ-АСТРОМ~~]] / ~~[[API Ключ-АСТРОМ#.D0.AD.D0.BD.D0.B4.D0.BF.D0.BE.D0.B9.D0.BD.D1.82.D1.8B%20.D1.81.D1.80.D0.B5.D0.B4.D1.8B\|~~Эндпойнты среды]] / ~~[[API Ключ-АСТРОМ#.D0.A0.D0.B0.D0.B7.D0.B2.D1.91.D1.80.D1.82.D1.8B.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5\|~~Развёртывание]] / Таймсерии v1 / Чтение точек данных / GET точек данных'''''		'''''[[API АппОптима]] / Эндпойнты среды / Развёртывание / Таймсерии v1 / Чтение точек данных / GET точек данных'''''

	Извлекает параметры и точки данных указанной метрики.		Извлекает параметры и точки данных указанной метрики.
Строка 10:		Строка 10:
	{\| class="wikitable"		{\| class="wikitable"
	\| rowspan="2" \|GET		\| 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>
	\|-		\|-
Строка 75:		Строка 75:
	\|integer		\|integer
	\|Отметка времени окончания запрошенного таймфрейма в миллисекундах (UTC).		\|Отметка времени окончания запрошенного таймфрейма в миллисекундах (UTC).
	Если позже текущего времени, ~~Ключ-АСТРОМ~~ автоматически использует текущее время.		Если позже текущего времени, АппОптима автоматически использует текущее время.

	Срок не должен превышать 6 месяцев.		Срок не должен превышать 6 месяцев.
Строка 123:		Строка 123:
	\|entity		\|entity
	\|string []		\|string []
	\|Фильтрует запрошенные точки данных по объекту, который должен их предоставить. Допустимые значения — идентификаторы объектов ~~Ключ-АСТРОМ~~.		\|Фильтрует запрошенные точки данных по объекту, который должен их предоставить. Допустимые значения — идентификаторы объектов АппОптима.
	Вы можете указать несколько сущностей в следующем формате: <code>entity=entity1&entity=entity2</code>. Сущность должна соответствовать хотя бы одному из указанных идентификаторов.		Вы можете указать несколько сущностей в следующем формате: <code>entity=entity1&entity=entity2</code>. Сущность должна соответствовать хотя бы одному из указанных идентификаторов.

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

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

	Существует три версии точек данных:		Существует три версии точек данных:
Строка 426:		Строка 426:
	\|object		\|object
	\|Список сущностей, из которых исходят точки данных.		\|Список сущностей, из которых исходят точки данных.
	Объект JSON, который сопоставляет идентификатор объекта в ~~Ключ-АСТРОМ~~ и фактическое имя объекта.		Объект JSON, который сопоставляет идентификатор объекта в АппОптима и фактическое имя объекта.
	\|}		\|}

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

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

	== Пример ==		== Пример ==
Строка 476:		Строка 476:

	==== Curl ====		==== Curl ====
	<~~code>~~curl -X GET \		<curl -X GET \
	<nowiki>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</nowiki> \		<nowiki>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</nowiki> \
	-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'</code>		-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'</code>
Строка 484:		Строка 484:

	==== Содержание ответа ====		==== Содержание ответа ====
	<~~code>~~{		<{
	"timeseriesId": "ru.ruscomtech.builtin:app.actionspersession",		"timeseriesId": "ru.ruscomtech.builtin:app.actionspersession",
	"displayName": "Actions per session",		"displayName": "Actions per session",

ENetrebin в 15:51, 28 июня 2024

2024-06-28T15:51:04Z

← Предыдущая версия		Версия от 15:51, 28 июня 2024
Строка 1:		Строка 1:
			'''''[[API Ключ-АСТРОМ]] / [[API Ключ-АСТРОМ#.D0.AD.D0.BD.D0.B4.D0.BF.D0.BE.D0.B9.D0.BD.D1.82.D1.8B%20.D1.81.D1.80.D0.B5.D0.B4.D1.8B\|Эндпойнты среды]] / [[API Ключ-АСТРОМ#.D0.A0.D0.B0.D0.B7.D0.B2.D1.91.D1.80.D1.82.D1.8B.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5\|Развёртывание]] / Таймсерии v1 / Чтение точек данных / GET точек данных'''''

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

ENetrebin: Новая страница: «Извлекает параметры и точки данных указанной метрики. Чтобы получить точки данных, уста...»

2022-10-13T07:48:43Z

Новая страница: «Извлекает параметры и точки данных указанной метрики. Чтобы получить точки данных, уста...»

Новая страница

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

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

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

Запрос использует в качестве полезной нагрузки формат <code>application/json</code>.
{| class="wikitable"
| rowspan="2" |GET
|Managed
|<code><nowiki>https://{your-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>) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .

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

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

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

Максимально допустимый срок — 6 месяцев.
{| class="wikitable"
!Параметр
!Тип
!Описание
!In
!Необходимость
|-
|timeseriesIdentifier
|string
|Идентификатор временного ряда с учетом регистра, из которого вы хотите прочитать параметры и точки данных.
|path
|требуется
|-
|includeData
|boolean
|Флаг для включения точек данных в ответ. Установите для <code>true</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
|integer
|Метка времени начала запрошенного таймфрейма в миллисекундах UTC.
|query
|по желанию
|-
|endTimestamp
|integer
|Отметка времени окончания запрошенного таймфрейма в миллисекундах (UTC).
Если позже текущего времени, Ключ-АСТРОМ автоматически использует текущее время.

Срок не должен превышать 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
|Тип результата, который должен вернуть вызов. Допустимые режимы результатов:
<code>series</code>: возвращает все точки данных временного ряда в указанном временном интервале. <code>total</code>: возвращает одно скалярное значение для указанного периода времени.

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

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

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

Если выбранный объект не поддерживает запрошенный временной ряд, запрос приведет к ошибке.
|query
|по желанию
|-
|tag
|string []
|Фильтрует запрошенные точки данных по объекту, который должен их предоставить. Доставляются данные только от сущностей с указанным тегом.
Вы можете указать несколько тегов в следующем формате: <code>tag=tag1&tag=tag2</code>. Сущность должна соответствовать всем указанным тегам.

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

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

Имейте в виду, что экспорт процентилей возможен только для метрик, основанных на времени отклика, таких как время отклика приложений и служб.
|query
|по желанию
|-
|includeParentIds
|boolean
|Если установлено значение true, в результате отображаются сопоставления измерений между родительскими объектами и их дочерними объектами.
Например: SERVICE-0000000000000001, SERVICE_METHOD-0000000000000001
|query
|по желанию
|-
|considerMaintenanceWindowsForAvailability
|boolean
|Исключите ( <code>true</code>) или включите ( <code>false</code>) точки данных из любого периода обслуживания , определенного в вашей среде.
|query
|по желанию
|}

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

=== Коды ответовправитьправить код ===
{| class="wikitable"
!Код
|Тип
!Описание
|-
|200
|TimeseriesQueryResult
|Успех
|}

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

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

* <code>AVG</code>
* <code>COUNT</code>
* <code>MAX</code>
* <code>MEDIAN</code>
* <code>MIN</code>
* <code>PERCENTILE</code>
* <code>SUM</code>
|-
|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>
|-
|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> ====
Список точек данных метрики, а также их параметры.
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|dataPoints
|object
|Точки данных метрики.
Объект JSON, который сопоставляет идентификатор объекта, предоставившего точки данных, и массив, состоящий из массивов значений с плавающей запятой точек данных.

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

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

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

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

* Числовая точка данных: содержит числовое значение.
* Точка данных перечисления: содержит значение перечисления, в настоящее время только для временных рядов доступности.
* Точка данных прогноза: похожа на числовую точку данных, но содержит доверительный интервал, в пределах которого ожидаются будущие значения.
|-
|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>
|-
|resolutionInMillisUTC
|integer
|Разрешение точек данных.
|-
|aggregationType
|string
|Тип агрегации точек данных.
Элемент может содержать эти значения

* <code>AVG</code>
* <code>COUNT</code>
* <code>MAX</code>
* <code>MEDIAN</code>
* <code>MIN</code>
* <code>PERCENTILE</code>
* <code>SUM</code>
|-
|entities
|object
|Список сущностей, из которых исходят точки данных.
Объект JSON, который сопоставляет идентификатор объекта в Ключ-АСТРОМ и фактическое имя объекта.
|}

=== JSON-модель тела ответа ===
<code>{
"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"
}
}</code>

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

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

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

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

==== Curl ====
<code>curl -X GET \
<nowiki>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</nowiki> \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'</code>

==== URL-адрес запроса ====
<code><nowiki>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</nowiki></code>

==== Содержание ответа ====
<code>{
"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"
}</code>

==== Код ответа ====
200