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

ENetrebin в 18:20, 25 января 2023

2023-01-25T18:20:54Z

← Предыдущая		Версия 18:20, 25 января 2023
Строка 8:		Строка 8:
	\|-		\|-
	\|SaaS		\|SaaS
	\|<code><nowiki>https://{your-environment-id}.live.~~ruscomtech~~.ru/api/v2/extensions/{extensionName}/monitoringConfigurations/{configurationId}/events</nowiki></code>		\|<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v2/extensions/{extensionName}/monitoringConfigurations/{configurationId}/events</nowiki></code>
	\|-		\|-
	\|Окружающая среда АктивныйШлюз		\|Окружающая среда АктивныйШлюз

ENetrebin в 10:26, 7 октября 2022

2022-10-07T10:26:09Z

← Предыдущая		Версия 10:26, 7 октября 2022
Строка 8:		Строка 8:
	\|-		\|-
	\|SaaS		\|SaaS
	\|<code><nowiki>https://{your-environment-id}.live.~~dynatrace~~.~~com~~/api/v2/extensions/{extensionName}/monitoringConfigurations/{configurationId}/events</nowiki></code>		\|<code><nowiki>https://{your-environment-id}.live.ruscomtech.ru/api/v2/extensions/{extensionName}/monitoringConfigurations/{configurationId}/events</nowiki></code>
	\|-		\|-
	\|Окружающая среда АктивныйШлюз		\|Окружающая среда АктивныйШлюз
Строка 46:		Строка 46:
	* Человекочитаемый формат <code>2021-01-25T05:57:01.123+01:00</code>. Если часовой пояс не указан, используется UTC. Вы можете использовать пробел вместо <code>T</code>. Секунды и доли секунды не являются обязательными.		* Человекочитаемый формат <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>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>m</code>: минуты
	** <code>h</code>: часы		** <code>h</code>: часы
	** <code>d</code>: ~~дней~~		** <code>d</code>: дни
	** <code>w</code>: недели		** <code>w</code>: недели
	** <code>M</code>: месяцы		** <code>M</code>: месяцы
Строка 66:		Строка 66:
	* Человекочитаемый формат <code>2021-01-25T05:57:01.123+01:00</code>. Если часовой пояс не указан, используется UTC. Вы можете использовать пробел вместо <code>T</code>. Секунды и доли секунды не являются обязательными.		* Человекочитаемый формат <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>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>m</code>: минуты
	** <code>h</code>: часы		** <code>h</code>: часы
	** <code>d</code>: ~~дней~~		** <code>d</code>: дни
	** <code>w</code>: недели		** <code>w</code>: недели
	** <code>M</code>: месяцы		** <code>M</code>: месяцы
Строка 87:		Строка 87:
	\|dt.active_gate.id		\|dt.active_gate.id
	\|string		\|string
	\|Шестнадцатеричный идентификатор ~~Active Gate~~, который использует эту конфигурацию мониторинга.		\|Шестнадцатеричный идентификатор АктивногоШлюза, который использует эту конфигурацию мониторинга.

	Пример:<code>0x1a2b3c4d</code>		Пример:<code>0x1a2b3c4d</code>
Строка 140:		Строка 140:
	=== Объекты тела ответа ===		=== Объекты тела ответа ===

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

	==== Объект _ <code>ExtensionEventDto</code> ====		==== Объект <code>ExtensionEventDto</code> ====
	Список событий расширения.		Список событий расширения.
	{\| class="wikitable"		{\| class="wikitable"

ENetrebin в 06:37, 5 октября 2022

2022-10-05T06:37:25Z

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

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


2022-10-04T16:10:18Z
Новая страница: «Список событий, связанных с указанной конфигурацией мониторинга.  Запрос создает <code>applic...»
Новая страница
Список событий, связанных с указанной конфигурацией мониторинга.



Запрос создает <code>application/json</code>полезную нагрузку.

{| class="wikitable"

| rowspan="3" |ПОЛУЧИТЬ

|Удалось

|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/monitoringConfigurations/{configurationId}/events</nowiki></code>

|-

|SaaS

|<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v2/extensions/{extensionName}/monitoringConfigurations/{configurationId}/events</nowiki></code>

|-

|Окружающая среда ActiveGate

|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/monitoringConfigurations/{configurationId}/events</nowiki></code>

|}



== Аутентификация ==

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



== Параметры ==

{| class="wikitable"

!Параметр

!Тип

!Описание

!В

!Необходимый

|-

|имя_расширения

|нить

|Имя запрошенного расширения 2.0.

|дорожка

|требуется

|-

|идентификатор конфигурации

|нить

|Идентификатор запрошенной конфигурации мониторинга.

|дорожка

|требуется

|-

|из

|нить

|Начало запрошенного таймфрейма.



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



* Отметка времени в миллисекундах 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>).

|запрос

|по желанию

|-

|к

|нить

|Конец запрошенного периода времени.



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



* Отметка времени в миллисекундах 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>: годы



Если не установлено, используется текущая метка времени.

|запрос

|по желанию

|-

|dt.entity.host

|нить

|Хост, который использует эту конфигурацию мониторинга.



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

|запрос

|по желанию

|-

|dt.active_gate.id

|нить

|Шестнадцатеричный идентификатор Active Gate, который использует эту конфигурацию мониторинга.



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

|запрос

|по желанию

|-

|dt.extension.ds

|нить

|Источник данных, который использует эту конфигурацию мониторинга.



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

|запрос

|по желанию

|-

|содержание

|нить

|Содержание мероприятия

|запрос

|по желанию

|-

|статус

|нить

|Статус события



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



* <code>ERROR</code>

* <code>INFO</code>

* <code>NONE</code>

* <code>WARN</code>

|запрос

|по желанию

|}



== Ответ ==



=== Коды ответов ===

{| class="wikitable"

!Код

|Тип

!Описание

|-

|200

|Список событий расширения

|Успех

|-

|404

|ErrorEnvelope

|Не удалось. Запрошенный ресурс не существует.

|}



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



==== Объект _ <code>ExtensionEventsList</code> ====

{| class="wikitable"

!Элемент

!Тип

!Описание

|-

|extensionEvents

|Событие расширения Dto []

|Список событий расширения.

|}



==== Объект _ <code>ExtensionEventDto</code> ====

Список событий расширения.

{| class="wikitable"

!Элемент

!Тип

!Описание

|-

|отметка времени

|нить

|Отметка времени события

|-

|строгость

|нить

|Серьезность события

|-

|содержание

|нить

|Содержание мероприятия

|-

|dt.entity.host

|нить

|Хост, который использует эту конфигурацию мониторинга.



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

|-

|dt.active_gate.id

|нить

|Шестнадцатеричный идентификатор Active Gate, который использует эту конфигурацию мониторинга.



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

|-

|dt.extension.ds

|нить

|Источник данных, который использует эту конфигурацию мониторинга.



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

|-

|статус

|нить

|Статус события



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



* <code>ERROR</code>

* <code>INFO</code>

* <code>NONE</code>

* <code>WARN</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>

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

ENetrebin в 18:20, 25 января 2023

ENetrebin в 10:26, 7 октября 2022

ENetrebin в 06:37, 5 октября 2022

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

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