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

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

2024-12-29T12:16:02Z

← Предыдущая версия		Версия от 12:16, 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] / Получение точки данных метрики'''''

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

IKuznetsov в 15:46, 26 декабря 2024

2024-12-26T15:46:49Z

← Предыдущая версия		Версия от 15:46, 26 декабря 2024
Строка 59:		Строка 59:
	<code>"ext:selfmonitoring.jmx.Agents: Type ~"APACHE~""</code>		<code>"ext:selfmonitoring.jmx.Agents: Type ~"APACHE~""</code>

	Вы можете установить дополнительные операторы преобразования, разделенные двоеточием ( <code>:</code>). Дополнительную информацию о доступных преобразованиях результатов и синтаксисе см. в разделе Преобразования селектора показателей в документации ~~Ключ-АСТРОМ~~.		Вы можете установить дополнительные операторы преобразования, разделенные двоеточием ( <code>:</code>). Дополнительную информацию о доступных преобразованиях результатов и синтаксисе см. в разделе Преобразования селектора показателей в документации АппОптима.
	\|query		\|query
	\|по желанию		\|по желанию
Строка 137:		Строка 137:

	* Тип объекта:<code>type("TYPE")</code>		* Тип объекта:<code>type("TYPE")</code>
	* Идентификатор объекта ~~Ключ-АСТРОМ~~: <code>entityId("id")</code>. Вы можете указать несколько идентификаторов, разделенных запятой ( <code>entityId("id-1","id-2")</code>). Все запрошенные сущности должны быть одного типа.		* Идентификатор объекта АппОптима: <code>entityId("id")</code>. Вы можете указать несколько идентификаторов, разделенных запятой ( <code>entityId("id-1","id-2")</code>). Все запрошенные сущности должны быть одного типа.

	Вы можете добавить один или несколько следующих критериев. Значения чувствительны к регистру, и <code>EQUALS</code>оператор используется, если не указано иное.		Вы можете добавить один или несколько следующих критериев. Значения чувствительны к регистру, и <code>EQUALS</code>оператор используется, если не указано иное.
Строка 159:		Строка 159:
	* Отрицание: <code>not(<criterion>)</code>. Инвертирует любой критерий, кроме type .		* Отрицание: <code>not(<criterion>)</code>. Инвертирует любой критерий, кроме type .

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

	Чтобы задать несколько критериев, разделите их запятой ( <code>,</code>). Например, <code>type("HOST"),healthState("HEALTHY")</code>. В ответ включаются только результаты, соответствующие всем критериям.		Чтобы задать несколько критериев, разделите их запятой ( <code>,</code>). Например, <code>type("HOST"),healthState("HEALTHY")</code>. В ответ включаются только результаты, соответствующие всем критериям.
Строка 519:		Строка 519:
	}		}
	]		]
	}~~</code>~~		}

	== Примечание о таймфрейме ==		== Примечание о таймфрейме ==
	~~Ключ-АСТРОМ~~ хранит данные во временных интервалах. Объект MetricValue показывает отметку времени ''окончания'' слота. Если время, указанное в параметрах from или to вашего запроса, попадает в временной интервал данных, этот временной интервал включается в ответ.		АппОптима хранит данные во временных интервалах. Объект MetricValue показывает отметку времени ''окончания'' слота. Если время, указанное в параметрах from или to вашего запроса, попадает в временной интервал данных, этот временной интервал включается в ответ.

	Если временная метка последнего слота данных выходит за пределы указанного временного интервала, последняя точка данных ответа имеет более ''позднюю'' временную метку, чем указано в параметре запроса.		Если временная метка последнего слота данных выходит за пределы указанного временного интервала, последняя точка данных ответа имеет более ''позднюю'' временную метку, чем указано в параметре запроса.

	~~Ключ-АСТРОМ~~ не предсказывает будущие данные. Временная метка последней точки данных может лежать в будущем из-за принципа интервалов данных, описанного выше. В этом случае этот слот данных имеет неполные данные.		АппОптима не предсказывает будущие данные. Временная метка последней точки данных может лежать в будущем из-за принципа интервалов данных, описанного выше. В этом случае этот слот данных имеет неполные данные.

	== Примеры ==		== Примеры ==
Строка 547:		Строка 547:
	<curl -L -X GET 'https://mySampleEnv.live.ruscomtech.ru<nowiki/>/api/v2/metrics/query?metricSelector=builtin:host.cpu.(usage,idle)&entitySelector=type(%22dt.entity.host%22),entityId(%22HOST-0990886B7D39FE29%22,%22HOST-0956C3557E9109C1%22)&from=now-5m' \		<curl -L -X GET 'https://mySampleEnv.live.ruscomtech.ru<nowiki/>/api/v2/metrics/query?metricSelector=builtin:host.cpu.(usage,idle)&entitySelector=type(%22dt.entity.host%22),entityId(%22HOST-0990886B7D39FE29%22,%22HOST-0956C3557E9109C1%22)&from=now-5m' \
	-H 'Authorization: Api-Token abcdefjhij1234567890' \		-H 'Authorization: Api-Token abcdefjhij1234567890' \
	-H 'Accept: application/json'~~</code>~~		-H 'Accept: application/json'
	С преобразованием, применяемым непосредственно к метрикам:		С преобразованием, применяемым непосредственно к метрикам:
	<curl -L -X GET '<nowiki>https://mySampleEnv.live.ruscomtech.ru/api/v2/metrics/query?metricSelector=builtin:host.cpu.(usage,idle):filter(or(eq(%22dt.entity.host%22,%22HOST-0990886B7D39FE29%22),eq(%22dt.entity.host%22,%22HOST-0956C3557E9109C1%22)))&from=now-5m'</nowiki> \		<curl -L -X GET '<nowiki>https://mySampleEnv.live.ruscomtech.ru/api/v2/metrics/query?metricSelector=builtin:host.cpu.(usage,idle):filter(or(eq(%22dt.entity.host%22,%22HOST-0990886B7D39FE29%22),eq(%22dt.entity.host%22,%22HOST-0956C3557E9109C1%22)))&from=now-5m'</nowiki> \
	-H 'Authorization: Api-Token abcdefjhij1234567890' \		-H 'Authorization: Api-Token abcdefjhij1234567890' \
	-H 'Accept: application/json'~~</code>~~		-H 'Accept: application/json'

	==== URL-адрес запроса ====		==== URL-адрес запроса ====
Строка 652:		Строка 652:
	}		}
	]		]
	}~~</code>~~		}
	Таблица CSV со строкой заголовка выглядит следующим образом. Чтобы получить его, измените заголовок Accept<code>text/csv; header=present</code> на .		Таблица CSV со строкой заголовка выглядит следующим образом. Чтобы получить его, измените заголовок Accept<code>text/csv; header=present</code> на .
	<metricId,dt.entity.host,time,value		<metricId,dt.entity.host,time,value
Строка 660:		Строка 660:
	builtin:host.cpu.usage,HOST-0990886B7D39FE29,2020-05-14 11:35:00,19.0		builtin:host.cpu.usage,HOST-0990886B7D39FE29,2020-05-14 11:35:00,19.0
	builtin:host.cpu.usage,HOST-0990886B7D39FE29,2020-05-14 11:36:00,21.0		builtin:host.cpu.usage,HOST-0990886B7D39FE29,2020-05-14 11:36:00,21.0
	builtin:host.cpu.usage,HOST-0990886B7D39FE29,2020-05-14 11:37:00,22.0~~</code>~~		builtin:host.cpu.usage,HOST-0990886B7D39FE29,2020-05-14 11:37:00,22.0

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

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

2024-12-26T10:24:02Z

← Предыдущая версия		Версия от 10:24, 26 декабря 2024
Строка 23:		Строка 23:
	{\| class="wikitable"		{\| class="wikitable"
	\| rowspan="3" \|GET		\| rowspan="3" \|GET
	\|~~Managed~~		\|АппОптима
	\|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/metrics/query</nowiki></code>		\|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/metrics/query</nowiki></code>
	\|-		\|-
Строка 444:		Строка 444:

	=== JSON-модель тела ответа ===		=== JSON-модель тела ответа ===
	<~~code>~~{		<{
	"totalCount": 3,		"totalCount": 3,
	"nextPageKey": "null",		"nextPageKey": "null",
Строка 545:		Строка 545:
	==== Curl ====		==== Curl ====
	С непреобразованными метриками и фильтром entitySelector :		С непреобразованными метриками и фильтром entitySelector :
	<~~code>~~curl -L -X GET 'https://mySampleEnv.live.ruscomtech.ru<nowiki/>/api/v2/metrics/query?metricSelector=builtin:host.cpu.(usage,idle)&entitySelector=type(%22dt.entity.host%22),entityId(%22HOST-0990886B7D39FE29%22,%22HOST-0956C3557E9109C1%22)&from=now-5m' \		<curl -L -X GET 'https://mySampleEnv.live.ruscomtech.ru<nowiki/>/api/v2/metrics/query?metricSelector=builtin:host.cpu.(usage,idle)&entitySelector=type(%22dt.entity.host%22),entityId(%22HOST-0990886B7D39FE29%22,%22HOST-0956C3557E9109C1%22)&from=now-5m' \
	-H 'Authorization: Api-Token abcdefjhij1234567890' \		-H 'Authorization: Api-Token abcdefjhij1234567890' \
	-H 'Accept: application/json'</code>		-H 'Accept: application/json'</code>
	С преобразованием, применяемым непосредственно к метрикам:		С преобразованием, применяемым непосредственно к метрикам:
	<~~code>~~curl -L -X GET '<nowiki>https://mySampleEnv.live.ruscomtech.ru/api/v2/metrics/query?metricSelector=builtin:host.cpu.(usage,idle):filter(or(eq(%22dt.entity.host%22,%22HOST-0990886B7D39FE29%22),eq(%22dt.entity.host%22,%22HOST-0956C3557E9109C1%22)))&from=now-5m'</nowiki> \		<curl -L -X GET '<nowiki>https://mySampleEnv.live.ruscomtech.ru/api/v2/metrics/query?metricSelector=builtin:host.cpu.(usage,idle):filter(or(eq(%22dt.entity.host%22,%22HOST-0990886B7D39FE29%22),eq(%22dt.entity.host%22,%22HOST-0956C3557E9109C1%22)))&from=now-5m'</nowiki> \
	-H 'Authorization: Api-Token abcdefjhij1234567890' \		-H 'Authorization: Api-Token abcdefjhij1234567890' \
	-H 'Accept: application/json'</code>		-H 'Accept: application/json'</code>
Строка 561:		Строка 561:
	==== Тело ответа ====		==== Тело ответа ====
	Результат усекается до трех точек данных на измерение.		Результат усекается до трех точек данных на измерение.
	<~~code>~~{		<{
	"totalCount": 2,		"totalCount": 2,
	"nextPageKey": null,		"nextPageKey": null,
Строка 654:		Строка 654:
	}</code>		}</code>
	Таблица CSV со строкой заголовка выглядит следующим образом. Чтобы получить его, измените заголовок Accept<code>text/csv; header=present</code> на .		Таблица CSV со строкой заголовка выглядит следующим образом. Чтобы получить его, измените заголовок Accept<code>text/csv; header=present</code> на .
	<~~code>~~metricId,dt.entity.host,time,value		<metricId,dt.entity.host,time,value
	builtin:host.cpu.usage,HOST-0956C3557E9109C1,2020-05-14 11:35:00,19.0		builtin:host.cpu.usage,HOST-0956C3557E9109C1,2020-05-14 11:35:00,19.0
	builtin:host.cpu.usage,HOST-0956C3557E9109C1,2020-05-14 11:36:00,19.0		builtin:host.cpu.usage,HOST-0956C3557E9109C1,2020-05-14 11:36:00,19.0

ENetrebin в 11:55, 10 октября 2022

2022-10-10T11:55:55Z

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

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

2022-10-05T15:52:17Z

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

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