Получение определения метрик - История изменений

ENetrebin: /* Содержание ответа */

2023-01-30T13:55:52Z

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

← Предыдущая		Версия 13:55, 30 января 2023
Строка 363:		Строка 363:
	==== Содержание ответа ====		==== Содержание ответа ====
	<code>{		<code>{
	"timeseriesId": "ru.~~ruscomtech~~.builtin:app.actionspersession",		"timeseriesId": "com.dynstrace.builtin:app.actionspersession",
	"displayName": "Actions per session",		"displayName": "Actions per session",
	"dimensions": [		"dimensions": [

ENetrebin: /* JSON-модель тела ответа */

2023-01-30T13:55:00Z

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

← Предыдущая		Версия 13:55, 30 января 2023
Строка 314:		Строка 314:
	=== JSON-модель тела ответа ===		=== JSON-модель тела ответа ===
	<code>{		<code>{
	"timeseriesId": "ru.~~ruscomtech~~.builtin:host.cpu.idle",		"timeseriesId": "com.dynatrce.builtin:host.cpu.idle",
	"displayName": "CPU idle",		"displayName": "CPU idle",
	"dimensions": [		"dimensions": [

ENetrebin в 13:53, 30 января 2023

2023-01-30T13:53:57Z

← Предыдущая		Версия 13:53, 30 января 2023
Строка 8:		Строка 8:
	\|-		\|-
	\|SaaS		\|SaaS
	\|<code><nowiki>https://{your-environment-id}.live.~~ruscomtech~~.ru/api/v1/timeseries/{timeseriesIdentifier}</nowiki></code>		\|<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v1/timeseries/{timeseriesIdentifier}</nowiki></code>
	\|-		\|-
	\|Окружающая среда АктивногоШлюза		\|Окружающая среда АктивногоШлюза
Строка 207:		Строка 207:
	Точка данных содержит значение и отметку времени, когда это значение было записано.		Точка данных содержит значение и отметку времени, когда это значение было записано.

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

	Существует три версии точек данных:		Существует три версии точек данных:
Строка 309:		Строка 309:
	\|Список сущностей, из которых исходят точки данных.		\|Список сущностей, из которых исходят точки данных.

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

ENetrebin в 12:50, 7 октября 2022

2022-10-07T12:50:52Z

Внесённые изменения

ENetrebin: Новая страница: «Получает определение указанной метрики. Запрос создает `application/json`полезную нагруз...»

2022-10-04T19:52:36Z

Новая страница: «Получает определение указанной метрики. Запрос создает <code>application/json</code>полезную нагруз...»

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

Получает определение указанной метрики.

Запрос создает <code>application/json</code>полезную нагрузку.
{| class="wikitable"
| rowspan="3" |ПОЛУЧИТЬ
|Удалось
|<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>DataExport</code>) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .

== Параметры ==
Чтобы получить определение метрики, но не ее точек данных, задайте для параметра includeData<code>false</code> значение .
{| class="wikitable"
!Параметр
!Тип
!Описание
!В
!Необходимый
|-
|идентификатор таймсерии
|нить
|Идентификатор метрики с учетом регистра, из которой вы хотите прочитать параметры.
Вы можете выполнить запрос определения метрик GET , чтобы получить список доступных метрик.
|дорожка
|требуется
|-
|includeData
|логический
|Отметьте, чтобы включить точки данных в ответ. Установите для <code>false</code>получения только определения метрики.
|запрос
|по желанию
|}

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

=== Коды ответов ===
{| class="wikitable"
!Код
|Тип
!Описание
|-
|200
|Результат запроса временных рядов
|Успех
|}

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

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

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

* <code>AVG</code>
* <code>COUNT</code>
* <code>MAX</code>
* <code>MEDIAN</code>
* <code>MIN</code>
* <code>PERCENTILE</code>
* <code>SUM</code>
|-
|Ед. изм
|нить
|Единица измерения.

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

* <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>
|-
|фильтр
|нить
|Функция, из которой берется метрика.

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

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

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

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

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

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

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

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

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

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

* <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
|целое число
|Разрешение точек данных.
|-
|тип агрегации
|нить
|Тип агрегации точек данных.

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

* <code>AVG</code>
* <code>COUNT</code>
* <code>MAX</code>
* <code>MEDIAN</code>
* <code>MIN</code>
* <code>PERCENTILE</code>
* <code>SUM</code>
|-
|сущности
|объект
|Список сущностей, из которых исходят точки данных.

Объект JSON, который сопоставляет идентификатор объекта в Dynatrace и фактическое имя объекта.
|}

=== JSON-модель тела ответа ===
<code>{
"timeseriesId": "com.dynatrace.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>com.dynatrace.builtin:app.actionspersession</code>

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

==== Завиток ====
<code>curl -X GET \
<nowiki>https://mySampleEnv.live.dynatrace.com/api/v1/timeseries/com.dynatrace.builtin:app.actionspersession?includeData=false</nowiki> \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'</code>

==== URL-адрес запроса ====
<code><nowiki>https://mySampleEnv.live.dynatrace.com/api/v1/timeseries/com.dynatrace.builtin:app.actionspersession?includeData=false</nowiki></code>

==== Содержание ответа ====
<code>{
"timeseriesId": "com.dynatrace.builtin:app.actionspersession",
"displayName": "Actions per session",
"dimensions": [
"APPLICATION"
],
"unit": "PerMinute (count/min)",
"detailedSource": "Web application",
"types": [],
"aggregationTypes": [
"AVG"
],
"filter": "BUILTIN"
}</code>

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

Получение определения метрик - История изменений

ENetrebin: /* Содержание ответа */

ENetrebin: /* JSON-модель тела ответа */

ENetrebin в 13:53, 30 января 2023

ENetrebin в 12:50, 7 октября 2022

ENetrebin: Новая страница: «Получает определение указанной метрики. Запрос создает application/jsonполезную нагруз...»

ENetrebin: Новая страница: «Получает определение указанной метрики. Запрос создает `application/json`полезную нагруз...»