Получение списка событий 2: различия между версиями
ENetrebin (обсуждение | вклад) (Новая страница: «Функция возвращает список событий, связанных с указанной конфигурацией среды. Запрос с...») |
ENetrebin (обсуждение | вклад) |
||
| (не показана 1 промежуточная версия этого же участника) | |||
| Строка 82: | Строка 82: | ||
Элемент может содержать эти значения | Элемент может содержать эти значения | ||
* <code>ERROR</code> | |||
* <code>INFO</code> | |||
* <code>NONE</code> | |||
* <code>WARN</code> | |||
|запрос | |запрос | ||
|по желанию | |по желанию | ||
|} | |} | ||
== | == Схемы расширения == | ||
=== Коды ответов === | === Коды ответов === | ||
| Строка 95: | Строка 100: | ||
|- | |- | ||
|200 | |200 | ||
| | |ExtensionEventsList | ||
|Список последних событий конфигурации среды расширения | |Список последних событий конфигурации среды расширения | ||
|- | |- | ||
|404 | |404 | ||
| | |ErrorEnvelope | ||
|Не удалось. Запрошенный ресурс не существует. | |Не удалось. Запрошенный ресурс не существует. | ||
|} | |} | ||
| Строка 105: | Строка 110: | ||
=== Объекты тела ответа === | === Объекты тела ответа === | ||
==== Объект | ==== Объект <code>ResponseBody</code> ==== | ||
{| class="wikitable" | {| class="wikitable" | ||
!Элемент | !Элемент | ||
| Строка 112: | Строка 117: | ||
|- | |- | ||
|extensionEvents | |extensionEvents | ||
| | |ExtensionEventDto[] | ||
|Список событий расширения. | |Список событий расширения. | ||
| Строка 118: | Строка 123: | ||
|} | |} | ||
==== Объект | ==== Объект <code>ExtensionEventDto</code> ==== | ||
Список событий расширения. | Список событий расширения. | ||
{| class="wikitable" | {| class="wikitable" | ||
| Строка 125: | Строка 130: | ||
!Описание | !Описание | ||
|- | |- | ||
| | |timestamp | ||
| | |string | ||
|Отметка времени события | |Отметка времени события | ||
Может быть <code>null</code>. | Может быть <code>null</code>. | ||
|- | |- | ||
| | |severity | ||
| | |string | ||
|Серьезность события | |Серьезность события | ||
Может быть <code>null</code>. | Может быть <code>null</code>. | ||
|- | |- | ||
| | |content | ||
| | |string | ||
|Содержание мероприятия | |Содержание мероприятия | ||
| Строка 144: | Строка 149: | ||
|- | |- | ||
|dt.entity.host | |dt.entity.host | ||
| | |string | ||
|Хост, который использует эту конфигурацию мониторинга. | |Хост, который использует эту конфигурацию мониторинга. | ||
| Строка 152: | Строка 157: | ||
|- | |- | ||
|dt.active_gate.id | |dt.active_gate.id | ||
| | |string | ||
|Шестнадцатеричный идентификатор Active Gate, который использует эту конфигурацию мониторинга. | |Шестнадцатеричный идентификатор Active Gate, который использует эту конфигурацию мониторинга. | ||
| Строка 160: | Строка 165: | ||
|- | |- | ||
|dt.extension.ds | |dt.extension.ds | ||
| | |string | ||
|Источник данных, который использует эту конфигурацию мониторинга. | |Источник данных, который использует эту конфигурацию мониторинга. | ||
| Строка 167: | Строка 172: | ||
Может быть <code>null</code>. | Может быть <code>null</code>. | ||
|- | |- | ||
| | |status | ||
| | |string | ||
|Статус события | |Статус события | ||
Текущая версия на 10:17, 12 июля 2022
Функция возвращает список событий, связанных с указанной конфигурацией среды.
Запрос создает application/jsonполезную нагрузку.
| GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/environmentConfiguration/events
|
| SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/extensions/{extensionName}/environmentConfiguration/events
| |
| Окружающая среда АктивногоШлюза | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/environmentConfiguration/events
|
Аутентификация
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Чтение конфигураций среды расширения ( extensionEnvironment.read) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
| Параметр | Тип | Описание | In | Необходимый |
|---|---|---|---|---|
| extensionName | string | Имя запрошенного расширения 2.0. | path | требуется |
| from | string | Начало запрошенного таймфрейма.
Вы можете использовать один из следующих форматов:
Если не установлено, используется относительный таймфрейм в два часа ( |
запрос | по желанию |
| to | string | Конец запрошенного периода времени.
Вы можете использовать один из следующих форматов:
Если не установлено, используется текущая метка времени. |
запрос | по желанию |
| content | string | Содержание мероприятия | запрос | по желанию |
| status | string | Статус события
Элемент может содержать эти значения
|
запрос | по желанию |
Схемы расширения
Коды ответов
| Код | Тип | Описание |
|---|---|---|
| 200 | ExtensionEventsList | Список последних событий конфигурации среды расширения |
| 404 | ErrorEnvelope | Не удалось. Запрошенный ресурс не существует. |
Объекты тела ответа
Объект ResponseBody
| Элемент | Тип | Описание |
|---|---|---|
| extensionEvents | ExtensionEventDto[] | Список событий расширения.
Может быть |
Объект ExtensionEventDto
Список событий расширения.
| Элемент | Тип | Описание |
|---|---|---|
| timestamp | string | Отметка времени события
Может быть |
| severity | string | Серьезность события
Может быть |
| content | string | Содержание мероприятия
Может быть |
| dt.entity.host | string | Хост, который использует эту конфигурацию мониторинга.
Пример: Может быть |
| dt.active_gate.id | string | Шестнадцатеричный идентификатор Active Gate, который использует эту конфигурацию мониторинга.
Пример: Может быть |
| dt.extension.ds | string | Источник данных, который использует эту конфигурацию мониторинга.
Пример: Может быть |
| status | string | Статус события
Элемент может содержать эти значения Может быть |
JSON-модель тела ответа
{
"extensionEvents": [
{
"timestamp": "string",
"severity": "string",
"content": "string",
"dt.entity.host": "string",
"dt.active_gate.id": "string",
"dt.extension.ds": "string",
"status": "ERROR"
}
]
}