Открыть меню
Открыть персональное меню
Вы не представились системе
Your IP address will be publicly visible if you make any edits.

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

Материал из Документация АппОптима
Версия от 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"
    }
  ]
}