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

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

2024-12-26T10:27:14Z

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

	=== JSON-модель тела ответа ===		=== JSON-модель тела ответа ===
	<~~code>~~{		<{
	"extensionEvents": [		"extensionEvents": [
	{		{

ENetrebin в 10:17, 12 июля 2022

2022-07-12T10:17:34Z

← Предыдущая версия		Версия от 10:17, 12 июля 2022
Строка 82:		Строка 82:

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

			* <code>ERROR</code>
			* <code>INFO</code>
			* <code>NONE</code>
			* <code>WARN</code>
	\|запрос		\|запрос
	\|по желанию		\|по желанию
Строка 95:		Строка 100:
	\|-		\|-
	\|200		\|200
	\|~~Список событий расширения~~		\|ExtensionEventsList
	\|Список последних событий конфигурации среды расширения		\|Список последних событий конфигурации среды расширения
	\|-		\|-
	\|404		\|404
	\|~~Конверт ошибки~~		\|ErrorEnvelope
	\|Не удалось. Запрошенный ресурс не существует.		\|Не удалось. Запрошенный ресурс не существует.
	\|}		\|}

ENetrebin: /* Шаг 2. Разверните Dynatrace */

2022-07-12T09:15:43Z

Шаг 2. Разверните Dynatrace

← Предыдущая версия		Версия от 09:15, 12 июля 2022
Строка 86:		Строка 86:
	\|}		\|}

	== ~~Шаг 2. Разверните Dynatrace~~ ==		== Схемы расширения ==

	=== Коды ответов ===		=== Коды ответов ===
Строка 105:		Строка 105:
	=== Объекты тела ответа ===		=== Объекты тела ответа ===

	==== Объект _ <code>ResponseBody</code> ====		==== Объект <code>ResponseBody</code> ====
	{\| class="wikitable"		{\| class="wikitable"
	!Элемент		!Элемент
Строка 112:		Строка 112:
	\|-		\|-
	\|extensionEvents		\|extensionEvents
	\|~~Событие расширения Dto~~ []		\|ExtensionEventDto[]
	\|Список событий расширения.		\|Список событий расширения.

Строка 118:		Строка 118:
	\|}		\|}

	==== Объект _ <code>ExtensionEventDto</code> ====		==== Объект <code>ExtensionEventDto</code> ====
	Список событий расширения.		Список событий расширения.
	{\| class="wikitable"		{\| class="wikitable"
Строка 125:		Строка 125:
	!Описание		!Описание
	\|-		\|-
	\|~~отметка времени~~		\|timestamp
	\|~~нить~~		\|string
	\|Отметка времени события		\|Отметка времени события

	Может быть <code>null</code>.		Может быть <code>null</code>.
	\|-		\|-
	\|~~строгость~~		\|severity
	\|~~нить~~		\|string
	\|Серьезность события		\|Серьезность события

	Может быть <code>null</code>.		Может быть <code>null</code>.
	\|-		\|-
	\|~~содержание~~		\|content
	\|~~нить~~		\|string
	\|Содержание мероприятия		\|Содержание мероприятия

Строка 144:		Строка 144:
	\|-		\|-
	\|dt.entity.host		\|dt.entity.host
	\|~~нить~~		\|string
	\|Хост, который использует эту конфигурацию мониторинга.		\|Хост, который использует эту конфигурацию мониторинга.

Строка 152:		Строка 152:
	\|-		\|-
	\|dt.active_gate.id		\|dt.active_gate.id
	\|~~нить~~		\|string
	\|Шестнадцатеричный идентификатор Active Gate, который использует эту конфигурацию мониторинга.		\|Шестнадцатеричный идентификатор Active Gate, который использует эту конфигурацию мониторинга.

Строка 160:		Строка 160:
	\|-		\|-
	\|dt.extension.ds		\|dt.extension.ds
	\|~~нить~~		\|string
	\|Источник данных, который использует эту конфигурацию мониторинга.		\|Источник данных, который использует эту конфигурацию мониторинга.

Строка 167:		Строка 167:
	Может быть <code>null</code>.		Может быть <code>null</code>.
	\|-		\|-
	\|~~статус~~		\|status
	\|~~нить~~		\|string
	\|Статус события		\|Статус события

ENetrebin: Новая страница: «Функция возвращает список событий, связанных с указанной конфигурацией среды. Запрос с...»

2022-07-12T08:49:29Z

Новая страница: «Функция возвращает список событий, связанных с указанной конфигурацией среды. Запрос с...»

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

Функция возвращает список событий, связанных с указанной конфигурацией среды.

Запрос создает <code>application/json</code>полезную нагрузку.
{| class="wikitable"
| rowspan="3" |GET
|Managed
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/environmentConfiguration/events</nowiki></code>
|-
|SaaS
|<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v2/extensions/{extensionName}/environmentConfiguration/events</nowiki></code>
|-
|Окружающая среда АктивногоШлюза
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/environmentConfiguration/events</nowiki></code>
|}

== Аутентификация ==
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия '''Чтение конфигураций среды расширения''' ( <code>extensionEnvironment.read</code>) . Чтобы узнать, как его получить и использовать, см. раздел [[Токены и аутентификация (API)|Токены и аутентификация]] .

== Параметры ==
{| class="wikitable"
!Параметр
!Тип
!Описание
!In
!Необходимый
|-
|extensionName
|string
|Имя запрошенного расширения 2.0.
|path
|требуется
|-
|from
|string
|Начало запрошенного таймфрейма.

Вы можете использовать один из следующих форматов:

* Отметка времени в миллисекундах UTC.
* Читаемый формат <code>2021-01-25T05:57:01.123+01:00</code>. Если часовой пояс не указан, используется UTC. Вы можете использовать пробел вместо <code>T</code>. Секунды и доли секунды не являются обязательными.
* Относительный таймфрейм, назад. Формат: <code>now-NU/A</code>, где <code>N</code>количество времени, <code>U</code>единица времени и <code>A</code>выравнивание. Выравнивание округляет все меньшие значения до ближайшего нуля в прошлом. Например, <code>now-1y/w</code>это один год назад, выровненный на неделю. Вы также можете указать относительный таймфрейм без выравнивания: <code>now-NU</code>. Поддерживаемые единицы времени для относительного таймфрейма:
** <code>m</code>: минуты
** <code>h</code>: часы
** <code>d</code>: дни
** <code>w</code>: недели
** <code>M</code>: месяцы
** <code>y</code>: годы

Если не установлено, используется относительный таймфрейм в два часа ( <code>now-2h</code>).
|запрос
|по желанию
|-
|to
|string
|Конец запрошенного периода времени.

Вы можете использовать один из следующих форматов:

* Отметка времени в миллисекундах UTC.
* Читаемый формат <code>2021-01-25T05:57:01.123+01:00</code>. Если часовой пояс не указан, используется UTC. Вы можете использовать пробел вместо <code>T</code>. Секунды и доли секунды не являются обязательными.
* Относительный таймфрейм, назад. Формат: <code>now-NU/A</code>, где <code>N</code>количество времени, <code>U</code>единица времени и <code>A</code>выравнивание. Выравнивание округляет все меньшие значения до ближайшего нуля в прошлом. Например, <code>now-1y/w</code>это один год назад, выровненный на неделю. Вы также можете указать относительный таймфрейм без выравнивания: <code>now-NU</code>. Поддерживаемые единицы времени для относительного таймфрейма:
** <code>m</code>: минуты
** <code>h</code>: часы
** <code>d</code>: дни
** <code>w</code>: недели
** <code>M</code>: месяцы
** <code>y</code>: годы

Если не установлено, используется текущая метка времени.
|запрос
|по желанию
|-
|content
|string
|Содержание мероприятия
|запрос
|по желанию
|-
|status
|string
|Статус события

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

== Шаг 2. Разверните Dynatrace ==

=== Коды ответов ===
{| class="wikitable"
!Код
|Тип
!Описание
|-
|200
|Список событий расширения
|Список последних событий конфигурации среды расширения
|-
|404
|Конверт ошибки
|Не удалось. Запрошенный ресурс не существует.
|}

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

==== Объект _ <code>ResponseBody</code> ====
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|extensionEvents
|Событие расширения Dto []
|Список событий расширения.

Может быть <code>null</code>.
|}

==== Объект _ <code>ExtensionEventDto</code> ====
Список событий расширения.
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|отметка времени
|нить
|Отметка времени события

Может быть <code>null</code>.
|-
|строгость
|нить
|Серьезность события

Может быть <code>null</code>.
|-
|содержание
|нить
|Содержание мероприятия

Может быть <code>null</code>.
|-
|dt.entity.host
|нить
|Хост, который использует эту конфигурацию мониторинга.

Пример:<code>HOST-ABCDEF0123456789</code>

Может быть <code>null</code>.
|-
|dt.active_gate.id
|нить
|Шестнадцатеричный идентификатор Active Gate, который использует эту конфигурацию мониторинга.

Пример:<code>0x1a2b3c4d</code>

Может быть <code>null</code>.
|-
|dt.extension.ds
|нить
|Источник данных, который использует эту конфигурацию мониторинга.

Пример:<code>snmp</code>

Может быть <code>null</code>.
|-
|статус
|нить
|Статус события

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

Может быть <code>null</code>.
|}

=== JSON-модель тела ответа ===
<code>{
"extensionEvents": [
{
"timestamp": "string",
"severity": "string",
"content": "string",
"dt.entity.host": "string",
"dt.active_gate.id": "string",
"dt.extension.ds": "string",
"status": "ERROR"
}
]
}</code>