Получение события v2: различия между версиями

Материал из Документация Ключ-АСТРОМ
Строка 114: Строка 114:
Может быть <code>null</code>.
Может быть <code>null</code>.
|-
|-
|идентификатор события
|eventId
|string
|string
|Идентификатор события.
|Идентификатор события.
Строка 120: Строка 120:
Может быть <code>null</code>.
Может быть <code>null</code>.
|-
|-
|характеристики
|properties
|Свойство события []
|EventProperty[]
|Список свойств события.
|Список свойств события.


Строка 127: Строка 127:
|-
|-
|статус
|статус
|нить
|string
|Статус события.
|Статус события.


Строка 134: Строка 134:
Может быть <code>null</code>.
Может быть <code>null</code>.
|-
|-
|время начала
|startTime
|целое число
|integer
|Отметка времени возникновения события в миллисекундах UTC.
|Отметка времени возникновения события в миллисекундах UTC.


Может быть <code>null</code>.
Может быть <code>null</code>.
|-
|-
|время окончания
|endTime
|целое число
|integer
|Отметка времени закрытия события в миллисекундах UTC.
|Отметка времени закрытия события в миллисекундах UTC.


Строка 148: Строка 148:
Может быть <code>null</code>.
Может быть <code>null</code>.
|-
|-
|заглавие
|title
|нить
|string
|Название события.
|Название события.


Может быть <code>null</code>.
Может быть <code>null</code>.
|-
|-
|идентификатор корреляции
|correlationId
|нить
|string
|Идентификатор корреляции события.
|Идентификатор корреляции события.



Версия 07:38, 13 апреля 2022

Получает все свойства указанного события.

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

Первых компаний, внедривших

Этот запрос является выпуском Early Adopter и может быть изменен несовместимым образом.

GET Managed https://{your-domain}/e/{your-environment-id}/api/v2/events/{eventId}
SaaS https://{your-environment-id}.live.dynatrace.com/api/v2/events/{eventId}
Окружающая среда АктивногоШлюза https://{your-activegate-domain}/e/{your-environment-id}/api/v2/events/{eventId}

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

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

Параметры

Параметр Тип Описание In Необходимый
eventId string ID требуемого события. path обязательный

Ответ

Коды ответов

Код Тип Описание
200 Event Успех. Ответ содержит конфигурацию события.

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

Объект _ Event

Конфигурация события.

Элемент Тип Описание
eventType string Тип события.

Может быть null.

entityId EntityStub Краткое представление отслеживаемого объекта.

Может быть null.

entityTags METag[] Список тегов связанного объекта.

Может быть null.

underMaintenance boolean Если true, событие произошло, когда отслеживаемая система находилась на обслуживании.

Может быть null.

suppressAlert boolean Состояние предупреждения во время технического обслуживания :
  • false: Оповещение работает как обычно.
  • true: Оповещение отключено.

Может быть null.

suppressProblem boolean Статус обнаружения проблемы во время технического обслуживания :
  • false: Обнаружение проблем работает как обычно.
  • true: обнаружение проблем отключено.

Может быть null.

frequentEvent boolean Если true, событие происходит часто .

Частое событие не вызывает проблем.

Может быть null.

managementZones ManagementZone[] Список всех зон управления, которым принадлежит событие.

Может быть null.

eventId string Идентификатор события.

Может быть null.

properties EventProperty[] Список свойств события.

Может быть null.

статус string Статус события.

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

Может быть null.

startTime integer Отметка времени возникновения события в миллисекундах UTC.

Может быть null.

endTime integer Отметка времени закрытия события в миллисекундах UTC.

Имеет значение, nullесли событие все еще активно.

Может быть null.

title string Название события.

Может быть null.

correlationId string Идентификатор корреляции события.

Может быть null.

Объект _ EntityStub

Краткое представление отслеживаемого объекта.

Элемент Тип Описание
идентификатор объекта Идентификатор объекта Краткое представление отслеживаемого объекта.

Может быть null.

название нить Имя сущности.

Не включается в ответ, если сущность с соответствующим идентификатором не найдена.

Может быть null.

Объект _ EntityId

Краткое представление отслеживаемого объекта.

Элемент Тип Описание
я бы нить Идентификатор сущности.

Может быть null.

тип нить Тип сущности.

Может быть null.

Объект _ METag

Тег отслеживаемого объекта.

Элемент Тип Описание
представление строки нить Строковое представление тега.

Может быть null.

ценность нить Значение тега.

Может быть null.

ключ нить Ключ тега.

Может быть null.

контекст нить Происхождение тега, например AWS или Cloud Foundry.

Пользовательские теги используют это CONTEXTLESSзначение.

Может быть null.

Объект _ ManagementZone

Краткое представление зоны управления.

Элемент Тип Описание
название нить Имя зоны управления.

Может быть null.

я бы нить Идентификатор зоны управления.

Может быть null.

Объект _ EventProperty

Свойство события.

Элемент Тип Описание
ценность нить Значение свойства события.

Может быть null.

ключ нить Ключ свойства события.

Может быть null.

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

{
  "eventType": "LOW_DISK_SPACE",
  "entityId": {
    "entityId": {
      "id": "string",
      "type": "string"
    },
    "name": "string"
  },
  "entityTags": [
    {
      "stringRepresentation": "string",
      "value": "string",
      "key": "string",
      "context": "string"
    }
  ],
  "underMaintenance": true,
  "suppressAlert": true,
  "suppressProblem": true,
  "frequentEvent": true,
  "managementZones": [
    {
      "name": "string",
      "id": "string"
    }
  ],
  "eventId": "4293884258445543163_1564039524182",
  "properties": [
    {
      "value": "string",
      "key": "string"
    }
  ],
  "status": "OPEN",
  "startTime": 1564039524182,
  "endTime": 1564039524182,
  "title": "High CPU load on host X",
  "correlationId": "933613657e1c8fcf"
}

Пример

В этом примере запрос запрашивает параметры события с идентификатором 6375436663535938547_1628496488654 .

Это событие SYNTHETIC_GLOBAL_OUTAGE , указывающее на глобальное отключение мониторов браузера.

Маркер API передается в заголовке авторизации .

Завиток

curl --request GET \
  --url https://mySampleEnv.live.dynatrace.com/api/v2/events/6375436663535938547_1628496488654 \
  --header 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

URL-адрес запроса

https://mySampleEnv.live.dynatrace.com/api/v2/events/6375436663535938547_1628496488654

Тело ответа

{
  "eventId": "6375436663535938547_1628496488654",
  "startTime": 1628496488654,
  "endTime": 1628503679796,
  "eventType": "SYNTHETIC_GLOBAL_OUTAGE",
  "title": "Browser monitor global outage",
  "entityId": {
    "entityId": {
      "id": "SYNTHETIC_TEST-03ABB7F6446D1727",
      "type": "SYNTHETIC_TEST"
    },
    "name": "Maintenance window test"
  },
  "properties": [
    {
      "key": "dt.event.group_label",
      "value": "Browser monitor global outage"
    },
    {
      "key": "dt.event.is_rootcause_relevant",
      "value": "true"
    }
  ],
  "status": "CLOSED",
  "correlationId": "aecd1653df38ef50",
  "entityTags": [
    {
      "context": "CONTEXTLESS",
      "key": "Synthetic",
      "value": "Browser",
      "stringRepresentation": "Synthetic:Browser"
    }
  ],
  "managementZones": [
    {
      "id": "-7832237287622819191",
      "name": "Synthetic tests"
    }
  ],
  "underMaintenance": true,
  "suppressAlert": false,
  "suppressProblem": false,
  "frequentEvent": false
}

Код ответа

200