Выбор нескольких метрик - История изменений

IKuznetsov в 12:18, 29 декабря 2024

2024-12-29T12:18:31Z

ENetrebin: /* Curl */

2022-10-10T15:10:21Z

Curl

ENetrebin в 09:41, 7 октября 2022

2022-10-07T09:41:23Z

← Предыдущая версия		Версия от 09:41, 7 октября 2022
Строка 9:		Строка 9:
	Для каждого мы будем запрашивать полные дескрипторы:		Для каждого мы будем запрашивать полные дескрипторы:

	* ~~Метрический ключ~~		* Ключ метрики
	* Показать имя		* Показать имя
	* Описание		* Описание
Строка 17:		Строка 17:
	* Агрегация по умолчанию		* Агрегация по умолчанию
	* Поддерживаемые преобразования		* Поддерживаемые преобразования
	* ~~Габаритные размеры~~		* Параметры

	== Настроить запрос ==		== Настроить запрос ==

ENetrebin: /* Завиток */

2022-10-06T17:24:02Z

Завиток

← Предыдущая версия		Версия от 17:24, 6 октября 2022
Строка 32:		Строка 32:
	Чтобы аутентифицировать запрос, установите для заголовка Authorization<code>Api-token {your-token}</code> запроса значение . Токен должен иметь разрешение на чтение метрик ( ).<code>metrics.read</code>		Чтобы аутентифицировать запрос, установите для заголовка Authorization<code>Api-token {your-token}</code> запроса значение . Токен должен иметь разрешение на чтение метрик ( ).<code>metrics.read</code>

	== ~~Завиток~~ ==		== Curl ==
	Вот Curl-код запроса. Обязательно используйте URL-адрес вашей собственной среды и настоящий токен API.		Вот Curl-код запроса. Обязательно используйте URL-адрес вашей собственной среды и настоящий токен API.

ENetrebin: Новая страница: «Конечная точка метрик GET предоставляет вам возможность запрашивать несколько метрик, а...»

2022-10-05T16:38:26Z

Новая страница: «Конечная точка метрик GET предоставляет вам возможность запрашивать несколько метрик, а...»

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

Конечная точка метрик GET предоставляет вам возможность запрашивать несколько метрик, а также частичные или даже полные дескрипторы метрик.

В этом примере показано, как получить дескрипторы нескольких метрик одного родителя:

* Процессор простаивает ( <code>builtin:host.cpu.idle</code>)
* Загрузка системы ( <code>builtin:host.cpu.load</code>)
* Использование ЦП % ( <code>builtin:host.cpu.usage</code>)

Для каждого мы будем запрашивать полные дескрипторы:

* Метрический ключ
* Показать имя
* Описание
* Единицы
* Поддерживаемые типы объектов
* Поддерживаемые агрегаты
* Агрегация по умолчанию
* Поддерживаемые преобразования
* Габаритные размеры

== Настроить запрос ==
Мы должны установить следующие параметры запроса:

* метрикаСелектор к<code>builtin:host.cpu.(idle,usage,load)</code>
* поля до <code>displayName,description,unit,entityType,aggregationTypes,transformations,defaultAggregation,dimensionDefinitions</code>. Обратите внимание, что <code>metricId</code>здесь это опущено, потому что оно всегда присутствует в ответе.

Вы можете получить ответ в двух форматах:

* JSON: установите для заголовка Accept<code>application/json</code> запроса значение .
* Таблица CSV: установите для заголовка Accept<code>text/csv; header=present</code> запроса значение . Если вас не интересует строка заголовка, используйте <code>text/csv; header=absent</code>.

Чтобы аутентифицировать запрос, установите для заголовка Authorization<code>Api-token {your-token}</code> запроса значение . Токен должен иметь разрешение на чтение метрик ( ).<code>metrics.read</code>

== Завиток ==
Вот Curl-код запроса. Обязательно используйте URL-адрес вашей собственной среды и настоящий токен API.

=== Полезная нагрузка JSON ===
<code>curl -L -X GET '<nowiki>https://mySampleEnv.live.dynatrace.com/api/v2/metrics?fields=displayName,description,unit,entityType,aggregationTypes,transformations,defaultAggregation,dimensionDefinitions&metricSelector=builtin:host.cpu.(idle,usage,load)'</nowiki> \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
-H 'Accept: application/json'</code>

=== Полезная нагрузка таблицы CSV ===
<code>curl -L -X GET '<nowiki>https://mySampleEnv.live.dynatrace.com/api/v2/metrics?fields=displayName,description,unit,entityType,aggregationTypes,transformations,defaultAggregation,dimensionDefinitions&metricSelector=builtin:host.cpu.(idle,usage,load)'</nowiki> \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
-H 'Accept: text/csv; header=present'</code>

== URL-адрес запроса ==
<code><nowiki>https://mySampleEnv.live.dynatrace.com/api/v2/metrics?fields=displayName,description,unit,entityType,aggregationTypes,transformations,defaultAggregation,dimensionDefinitions&metricSelector=builtin:host.cpu.(idle,usage,load)</nowiki></code>

== Ответ ==
Оба примера содержат полную полезную нагрузку, ничего не усекается.

=== Полезная нагрузка JSON ===
<code>{
"totalCount": 3,
"nextPageKey": null,
"metrics": [
{
"metricId": "builtin:host.cpu.idle",
"displayName": "CPU idle",
"description": "",
"unit": "Percent",
"entityType": [
"HOST"
],
"aggregationTypes": [
"auto",
"avg",
"max",
"min"
],
"transformations": [
"filter",
"fold",
"merge",
"names",
"parents"
],
"defaultAggregation": {
"type": "avg"
},
"dimensionDefinitions": [
{
"key": "dt.entity.host",
"name": "Host",
"index": 0,
"type": "ENTITY"
}
]
},
{
"metricId": "builtin:host.cpu.load",
"displayName": "System load",
"description": "",
"unit": "Ratio",
"entityType": [
"HOST"
],
"aggregationTypes": [
"auto",
"avg",
"max",
"min"
],
"transformations": [
"filter",
"fold",
"merge",
"names",
"parents"
],
"defaultAggregation": {
"type": "avg"
},
"dimensionDefinitions": [
{
"key": "dt.entity.host",
"name": "Host",
"index": 0,
"type": "ENTITY"
}
]
},
{
"metricId": "builtin:host.cpu.usage",
"displayName": "CPU usage %",
"description": "Percentage of CPU time currently utilized.",
"unit": "Percent",
"entityType": [
"HOST"
],
"aggregationTypes": [
"auto",
"avg",
"max",
"min"
],
"transformations": [
"filter",
"fold",
"merge",
"names",
"parents"
],
"defaultAggregation": {
"type": "avg"
},
"dimensionDefinitions": [
{
"key": "dt.entity.host",
"name": "Host",
"index": 0,
"type": "ENTITY"
}
]
}
]
}</code>

=== Полезная нагрузка таблицы CSV ===
<code>metricId,displayName,description,unit,entityType,aggregationTypes,transformations,defaultAggregation,dimensionDefinitions
builtin:host.cpu.idle,CPU idle,,Percent,[HOST],"[auto, avg, max, min]","[filter, fold, merge, names, parents]",avg,[Host:ENTITY]
builtin:host.cpu.load,System load,,Ratio,[HOST],"[auto, avg, max, min]","[filter, fold, merge, names, parents]",avg,[Host:ENTITY]
builtin:host.cpu.usage,CPU usage %,Percentage of CPU time currently utilized.,Percent,[HOST],"[auto, avg, max, m</code>

← Предыдущая версия		Версия от 12:18, 29 декабря 2024
Строка 1:		Строка 1:
			'''''[[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%D1%82%D0%BE%D1%87%D0%B5%D0%BA%20%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85-,%D0%9C%D0%B5%D1%82%D1%80%D0%B8%D0%BA%D0%B8%20v2,-GET%20%D0%BC%D0%B5%D1%82%D1%80%D0%B8%D0%BA Метрики v2] / [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=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%D1%8B%20%D0%B8%20%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B%20%D0%B8%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F Примеры и варианты использования] / Выбор нескольких метрик'''''

	Конечная точка метрик GET предоставляет вам возможность запрашивать несколько метрик, а также частичные или даже полные дескрипторы метрик.		Конечная точка метрик GET предоставляет вам возможность запрашивать несколько метрик, а также частичные или даже полные дескрипторы метрик.

Строка 36:		Строка 38:

	=== Полезная нагрузка JSON ===		=== Полезная нагрузка JSON ===
	<~~code>~~curl -L -X GET '<nowiki>https://mySampleEnv.live.ruscomtech.ru/api/v2/metrics?fields=displayName,description,unit,entityType,aggregationTypes,transformations,defaultAggregation,dimensionDefinitions&metricSelector=builtin:host.cpu.(idle,usage,load)'</nowiki> \		<curl -L -X GET '<nowiki>https://mySampleEnv.live.ruscomtech.ru/api/v2/metrics?fields=displayName,description,unit,entityType,aggregationTypes,transformations,defaultAggregation,dimensionDefinitions&metricSelector=builtin:host.cpu.(idle,usage,load)'</nowiki> \
	-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \		-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
	-H 'Accept: application/json'</code>		-H 'Accept: application/json'</code>

	=== Полезная нагрузка таблицы CSV ===		=== Полезная нагрузка таблицы CSV ===
	<~~code>~~curl -L -X GET '<nowiki>https://mySampleEnv.live.ruscomtech.ru/api/v2/metrics?fields=displayName,description,unit,entityType,aggregationTypes,transformations,defaultAggregation,dimensionDefinitions&metricSelector=builtin:host.cpu.(idle,usage,load)'</nowiki> \		<curl -L -X GET '<nowiki>https://mySampleEnv.live.ruscomtech.ru/api/v2/metrics?fields=displayName,description,unit,entityType,aggregationTypes,transformations,defaultAggregation,dimensionDefinitions&metricSelector=builtin:host.cpu.(idle,usage,load)'</nowiki> \
	-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \		-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
	-H 'Accept: text/csv; header=present'</code>		-H 'Accept: text/csv; header=present'</code>
Строка 52:		Строка 54:

	=== Полезная нагрузка JSON ===		=== Полезная нагрузка JSON ===
	<~~code>~~{		<{
	"totalCount": 3,		"totalCount": 3,
	"nextPageKey": null,		"nextPageKey": null,
Строка 159:		Строка 161:

	=== Полезная нагрузка таблицы CSV ===		=== Полезная нагрузка таблицы CSV ===
	<~~code>~~metricId,displayName,description,unit,entityType,aggregationTypes,transformations,defaultAggregation,dimensionDefinitions		<metricId,displayName,description,unit,entityType,aggregationTypes,transformations,defaultAggregation,dimensionDefinitions
	builtin:host.cpu.idle,CPU idle,,Percent,[HOST],"[auto, avg, max, min]","[filter, fold, merge, names, parents]",avg,[Host:ENTITY]		builtin:host.cpu.idle,CPU idle,,Percent,[HOST],"[auto, avg, max, min]","[filter, fold, merge, names, parents]",avg,[Host:ENTITY]
	builtin:host.cpu.load,System load,,Ratio,[HOST],"[auto, avg, max, min]","[filter, fold, merge, names, parents]",avg,[Host:ENTITY]		builtin:host.cpu.load,System load,,Ratio,[HOST],"[auto, avg, max, min]","[filter, fold, merge, names, parents]",avg,[Host:ENTITY]
	builtin:host.cpu.usage,CPU usage %,Percentage of CPU time currently utilized.,Percent,[HOST],"[auto, avg, max, m</code>		builtin:host.cpu.usage,CPU usage %,Percentage of CPU time currently utilized.,Percent,[HOST],"[auto, avg, max, m</code>

← Предыдущая версия		Версия от 15:10, 10 октября 2022
Строка 30:		Строка 30:
	* Таблица CSV: установите для заголовка Accept<code>text/csv; header=present</code> запроса значение . Если вас не интересует строка заголовка, используйте <code>text/csv; header=absent</code>.		* Таблица CSV: установите для заголовка Accept<code>text/csv; header=present</code> запроса значение . Если вас не интересует строка заголовка, используйте <code>text/csv; header=absent</code>.

	Чтобы аутентифицировать запрос, установите для заголовка Authorization<code>Api-token {your-token}</code> запроса значение . Токен должен иметь разрешение на чтение метрик ( ).<code>metrics.read</code>		Чтобы аутентифицировать запрос, установите для заголовка Authorization<code>Api-token {your-token}</code> запроса значение . Токен должен иметь разрешение на чтение метрик (<code>metrics.read</code>)

	== Curl ==		== Curl ==
Строка 36:		Строка 36:

	=== Полезная нагрузка JSON ===		=== Полезная нагрузка JSON ===
	<code>curl -L -X GET '<nowiki>https://mySampleEnv.live.~~dynatrace~~.~~com~~/api/v2/metrics?fields=displayName,description,unit,entityType,aggregationTypes,transformations,defaultAggregation,dimensionDefinitions&metricSelector=builtin:host.cpu.(idle,usage,load)'</nowiki> \		<code>curl -L -X GET '<nowiki>https://mySampleEnv.live.ruscomtech.ru/api/v2/metrics?fields=displayName,description,unit,entityType,aggregationTypes,transformations,defaultAggregation,dimensionDefinitions&metricSelector=builtin:host.cpu.(idle,usage,load)'</nowiki> \
	-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \		-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
	-H 'Accept: application/json'</code>		-H 'Accept: application/json'</code>

	=== Полезная нагрузка таблицы CSV ===		=== Полезная нагрузка таблицы CSV ===
	<code>curl -L -X GET '<nowiki>https://mySampleEnv.live.~~dynatrace~~.~~com~~/api/v2/metrics?fields=displayName,description,unit,entityType,aggregationTypes,transformations,defaultAggregation,dimensionDefinitions&metricSelector=builtin:host.cpu.(idle,usage,load)'</nowiki> \		<code>curl -L -X GET '<nowiki>https://mySampleEnv.live.ruscomtech.ru/api/v2/metrics?fields=displayName,description,unit,entityType,aggregationTypes,transformations,defaultAggregation,dimensionDefinitions&metricSelector=builtin:host.cpu.(idle,usage,load)'</nowiki> \
	-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \		-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
	-H 'Accept: text/csv; header=present'</code>		-H 'Accept: text/csv; header=present'</code>

	== URL-адрес запроса ==		== URL-адрес запроса ==
	<code><nowiki>https://mySampleEnv.live.~~dynatrace~~.~~com~~/api/v2/metrics?fields=displayName,description,unit,entityType,aggregationTypes,transformations,defaultAggregation,dimensionDefinitions&metricSelector=builtin:host.cpu.(idle,usage,load)</nowiki></code>		<code><nowiki>https://mySampleEnv.live.ruscomtech.ru/api/v2/metrics?fields=displayName,description,unit,entityType,aggregationTypes,transformations,defaultAggregation,dimensionDefinitions&metricSelector=builtin:host.cpu.(idle,usage,load)</nowiki></code>

	== Ответ ==		== Ответ ==