Получение списка событий2

Материал из Dynatrace
Версия от 16:10, 4 октября 2022; ENetrebin (обсуждение | вклад) (Новая страница: «Список событий, связанных с указанной конфигурацией мониторинга. Запрос создает <code>applic...»)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)

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

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

ПОЛУЧИТЬ Удалось https://{your-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/monitoringConfigurations/{configurationId}/events
SaaS https://{your-environment-id}.live.dynatrace.com/api/v2/extensions/{extensionName}/monitoringConfigurations/{configurationId}/events
Окружающая среда ActiveGate https://{your-activegate-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/monitoringConfigurations/{configurationId}/events

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

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

Параметры

Параметр Тип Описание В Необходимый
имя_расширения нить Имя запрошенного расширения 2.0. дорожка требуется
идентификатор конфигурации нить Идентификатор запрошенной конфигурации мониторинга. дорожка требуется
из нить Начало запрошенного таймфрейма.

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

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

Если не установлено, используется относительный таймфрейм в два часа ( now-2h).

запрос по желанию
к нить Конец запрошенного периода времени.

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

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

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

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

Пример:HOST-ABCDEF0123456789

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

Пример:0x1a2b3c4d

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

Пример:snmp

запрос по желанию
содержание нить Содержание мероприятия запрос по желанию
статус нить Статус события

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

  • ERROR
  • INFO
  • NONE
  • WARN
запрос по желанию

Ответ

Коды ответов

Код Тип Описание
200 Список событий расширения Успех
404 ErrorEnvelope Не удалось. Запрошенный ресурс не существует.

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

Объект _ ExtensionEventsList

Элемент Тип Описание
extensionEvents Событие расширения Dto [] Список событий расширения.

Объект _ ExtensionEventDto

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

Элемент Тип Описание
отметка времени нить Отметка времени события
строгость нить Серьезность события
содержание нить Содержание мероприятия
dt.entity.host нить Хост, который использует эту конфигурацию мониторинга.

Пример:HOST-ABCDEF0123456789

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

Пример:0x1a2b3c4d

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

Пример:snmp

статус нить Статус события

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

  • ERROR
  • INFO
  • NONE
  • WARN

JSON-модель тела ответа

{
  "extensionEvents": [
    {
      "timestamp": "string",
      "severity": "string",
      "content": "string",
      "dt.entity.host": "string",
      "dt.active_gate.id": "string",
      "dt.extension.ds": "string",
      "status": "ERROR"
    }
  ]
}