Получение списка событий 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"
    }
  ]
}