Получение списка событий2: различия между версиями
ENetrebin (обсуждение | вклад)  (Новая страница: «Список событий, связанных с указанной конфигурацией мониторинга.  Запрос создает <code>applic...»)  | 
				ENetrebin (обсуждение | вклад)   | 
				||
| Строка 3: | Строка 3: | ||
Запрос создает <code>application/json</code>полезную нагрузку.  | Запрос создает <code>application/json</code>полезную нагрузку.  | ||
{| class="wikitable"  | {| class="wikitable"  | ||
| rowspan="3" |  | | rowspan="3" |GET  | ||
|  | |Managed  | ||
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/monitoringConfigurations/{configurationId}/events</nowiki></code>  | |<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/monitoringConfigurations/{configurationId}/events</nowiki></code>  | ||
|-  | |-  | ||
| Строка 10: | Строка 10: | ||
|<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v2/extensions/{extensionName}/monitoringConfigurations/{configurationId}/events</nowiki></code>  | |<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v2/extensions/{extensionName}/monitoringConfigurations/{configurationId}/events</nowiki></code>  | ||
|-  | |-  | ||
|Окружающая среда   | |Окружающая среда АктивныйШлюз  | ||
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/monitoringConfigurations/{configurationId}/events</nowiki></code>  | |<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/monitoringConfigurations/{configurationId}/events</nowiki></code>  | ||
|}  | |}  | ||
== Аутентификация ==  | == Аутентификация ==  | ||
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Чтение конфигураций мониторинга расширений ( <code>extensionConfigurations.read</code>) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .  | Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия '''Чтение конфигураций мониторинга расширений''' ( <code>extensionConfigurations.read</code>) . Чтобы узнать, как его получить и использовать, см. раздел [[Токены и аутентификация (API)|Токены и аутентификация]] .  | ||
== Параметры ==  | == Параметры ==  | ||
| Строка 22: | Строка 22: | ||
!Тип  | !Тип  | ||
!Описание  | !Описание  | ||
!  | !In  | ||
!  | !Необходимость  | ||
|-  | |-  | ||
|  | |extensionName  | ||
|  | |string  | ||
|Имя запрошенного расширения 2.0.  | |Имя запрошенного расширения 2.0.  | ||
|  | |path  | ||
|требуется  | |требуется  | ||
|-  | |-  | ||
|  | |configurationId  | ||
|  | |string  | ||
|Идентификатор запрошенной конфигурации мониторинга.  | |Идентификатор запрошенной конфигурации мониторинга.  | ||
|  | |path  | ||
|требуется  | |требуется  | ||
|-  | |-  | ||
|  | |from  | ||
|  | |string  | ||
|Начало запрошенного таймфрейма.  | |Начало запрошенного таймфрейма.  | ||
| Строка 54: | Строка 54: | ||
Если не установлено, используется относительный таймфрейм в два часа ( <code>now-2h</code>).  | Если не установлено, используется относительный таймфрейм в два часа ( <code>now-2h</code>).  | ||
|  | |query  | ||
|по желанию  | |по желанию  | ||
|-  | |-  | ||
|  | |to  | ||
|  | |string  | ||
|Конец запрошенного периода времени.  | |Конец запрошенного периода времени.  | ||
| Строка 74: | Строка 74: | ||
Если не установлено, используется текущая метка времени.  | Если не установлено, используется текущая метка времени.  | ||
|  | |query  | ||
|по желанию  | |по желанию  | ||
|-  | |-  | ||
|dt.entity.host  | |dt.entity.host  | ||
|  | |string  | ||
|Хост, который использует эту конфигурацию мониторинга.  | |Хост, который использует эту конфигурацию мониторинга.  | ||
Пример:<code>HOST-ABCDEF0123456789</code>  | Пример:<code>HOST-ABCDEF0123456789</code>  | ||
|  | |query  | ||
|по желанию  | |по желанию  | ||
|-  | |-  | ||
|dt.active_gate.id  | |dt.active_gate.id  | ||
|  | |string  | ||
|Шестнадцатеричный идентификатор Active Gate, который использует эту конфигурацию мониторинга.  | |Шестнадцатеричный идентификатор Active Gate, который использует эту конфигурацию мониторинга.  | ||
Пример:<code>0x1a2b3c4d</code>  | Пример:<code>0x1a2b3c4d</code>  | ||
|  | |query  | ||
|по желанию  | |по желанию  | ||
|-  | |-  | ||
|dt.extension.ds  | |dt.extension.ds  | ||
|  | |string  | ||
|Источник данных, который использует эту конфигурацию мониторинга.  | |Источник данных, который использует эту конфигурацию мониторинга.  | ||
Пример:<code>snmp</code>  | Пример:<code>snmp</code>  | ||
|  | |query  | ||
|по желанию  | |по желанию  | ||
|-  | |-  | ||
|  | |content  | ||
|  | |string  | ||
|Содержание мероприятия  | |Содержание мероприятия  | ||
|  | |query  | ||
|по желанию  | |по желанию  | ||
|-  | |-  | ||
|  | |status  | ||
|  | |string  | ||
|Статус события  | |Статус события  | ||
| Строка 117: | Строка 117: | ||
* <code>NONE</code>  | * <code>NONE</code>  | ||
* <code>WARN</code>  | * <code>WARN</code>  | ||
|  | |query  | ||
|по желанию  | |по желанию  | ||
|}  | |}  | ||
| Строка 158: | Строка 158: | ||
!Описание  | !Описание  | ||
|-  | |-  | ||
|  | |timestamp  | ||
|  | |string  | ||
|Отметка времени события  | |Отметка времени события  | ||
|-  | |-  | ||
|  | |severity  | ||
|  | |string  | ||
|Серьезность события  | |Серьезность события  | ||
|-  | |-  | ||
|  | |content  | ||
|  | |string  | ||
|Содержание мероприятия  | |Содержание мероприятия  | ||
|-  | |-  | ||
|dt.entity.host  | |dt.entity.host  | ||
|  | |string  | ||
|Хост, который использует эту конфигурацию мониторинга.  | |Хост, который использует эту конфигурацию мониторинга.  | ||
| Строка 177: | Строка 177: | ||
|-  | |-  | ||
|dt.active_gate.id  | |dt.active_gate.id  | ||
|  | |string  | ||
|Шестнадцатеричный идентификатор   | |Шестнадцатеричный идентификатор АктивногоШлюза, который использует эту конфигурацию мониторинга.  | ||
Пример:<code>0x1a2b3c4d</code>  | Пример:<code>0x1a2b3c4d</code>  | ||
|-  | |-  | ||
|dt.extension.ds  | |dt.extension.ds  | ||
|  | |string  | ||
|Источник данных, который использует эту конфигурацию мониторинга.  | |Источник данных, который использует эту конфигурацию мониторинга.  | ||
Пример:<code>snmp</code>  | Пример:<code>snmp</code>  | ||
|-  | |-  | ||
|  | |status  | ||
|  | |string  | ||
|Статус события  | |Статус события  | ||
Версия 06:37, 5 октября 2022
Список событий, связанных с указанной конфигурацией мониторинга.
Запрос создает application/jsonполезную нагрузку.
| GET | Managed | 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
 | |
| Окружающая среда АктивныйШлюз | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/monitoringConfigurations/{configurationId}/events
 | 
Аутентификация
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Чтение конфигураций мониторинга расширений ( extensionConfigurations.read) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
| Параметр | Тип | Описание | In | Необходимость | 
|---|---|---|---|---|
| extensionName | string | Имя запрошенного расширения 2.0. | path | требуется | 
| configurationId | string | Идентификатор запрошенной конфигурации мониторинга. | path | требуется | 
| from | string | Начало запрошенного таймфрейма.
 Вы можете использовать один из следующих форматов: 
 Если не установлено, используется относительный таймфрейм в два часа (   | 
query | по желанию | 
| to | string | Конец запрошенного периода времени.
 Вы можете использовать один из следующих форматов: 
 Если не установлено, используется текущая метка времени.  | 
query | по желанию | 
| dt.entity.host | string | Хост, который использует эту конфигурацию мониторинга.
 Пример:  | 
query | по желанию | 
| dt.active_gate.id | string | Шестнадцатеричный идентификатор Active Gate, который использует эту конфигурацию мониторинга.
 Пример:  | 
query | по желанию | 
| dt.extension.ds | string | Источник данных, который использует эту конфигурацию мониторинга.
 Пример:  | 
query | по желанию | 
| content | string | Содержание мероприятия | query | по желанию | 
| status | string | Статус события
 Элемент может содержать эти значения 
  | 
query | по желанию | 
Ответ
Коды ответов
| Код | Тип | Описание | 
|---|---|---|
| 200 | Список событий расширения | Успех | 
| 404 | ErrorEnvelope | Не удалось. Запрошенный ресурс не существует. | 
Объекты тела ответа
Объект _ ExtensionEventsList
| Элемент | Тип | Описание | 
|---|---|---|
| extensionEvents | Событие расширения Dto [] | Список событий расширения. | 
Объект _ ExtensionEventDto
Список событий расширения.
| Элемент | Тип | Описание | 
|---|---|---|
| timestamp | string | Отметка времени события | 
| severity | string | Серьезность события | 
| content | string | Содержание мероприятия | 
| dt.entity.host | string | Хост, который использует эту конфигурацию мониторинга.
 Пример:  | 
| dt.active_gate.id | string | Шестнадцатеричный идентификатор АктивногоШлюза, который использует эту конфигурацию мониторинга.
 Пример:  | 
| 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"
    }
  ]
}