Обнаружение аномалий дисковых событий API - PUT событие: различия между версиями
ENetrebin (обсуждение | вклад) (Новая страница: «Обновляет указанное правило событий диска. Запрос создает и использует в качестве поле...») |
ENetrebin (обсуждение | вклад) |
||
(не показана 1 промежуточная версия этого же участника) | |||
Строка 7: | Строка 7: | ||
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/diskEvents/{id}</nowiki></code> | |<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/diskEvents/{id}</nowiki></code> | ||
|- | |- | ||
|Среда | |Среда ActiveGate | ||
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/diskEvents/{id}</nowiki></code> | |<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/diskEvents/{id}</nowiki></code> | ||
|} | |} | ||
Строка 130: | Строка 130: | ||
|clusterVersion | |clusterVersion | ||
|string | |string | ||
|Версия | |Версия Dynatrace. | ||
|по желанию | |по желанию | ||
|} | |} | ||
Строка 266: | Строка 266: | ||
==== Объект <code>EntityShortRepresentation</code> ==== | ==== Объект <code>EntityShortRepresentation</code> ==== | ||
Краткое представление объекта | Краткое представление объекта Dynatrace. | ||
{| class="wikitable" | {| class="wikitable" | ||
!Элемент | !Элемент | ||
Строка 274: | Строка 274: | ||
|id | |id | ||
|string | |string | ||
|Идентификатор объекта | |Идентификатор объекта Dynatrace. | ||
|- | |- | ||
|name | |name | ||
|string | |string | ||
|Имя объекта | |Имя объекта Dynatrace. | ||
|- | |- | ||
|description | |description | ||
|string | |string | ||
|Краткое описание сущности | |Краткое описание сущности Dynatrace. | ||
|} | |} | ||
Строка 288: | Строка 288: | ||
<code>{ | <code>{ | ||
"id": "6a98d7bc-abb9-44f8-ae6a-73e68e71812a", | "id": "6a98d7bc-abb9-44f8-ae6a-73e68e71812a", | ||
"name": " | "name": "Dynatrace entity", | ||
"description": " | "description": "Dynatrace entity for the REST API example" | ||
}</code> | }</code> | ||
Строка 301: | Строка 301: | ||
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/diskEvents/{id}/validator</nowiki></code> | |<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/diskEvents/{id}/validator</nowiki></code> | ||
|- | |- | ||
|Среда | |Среда ActiveGate | ||
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/diskEvents/{id}/validator</nowiki></code> | |<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/diskEvents/{id}/validator</nowiki></code> | ||
|} | |} | ||
Строка 338: | Строка 338: | ||
==== Curl ==== | ==== Curl ==== | ||
<code>curl -X PUT \ | <code>curl -X PUT \ | ||
<nowiki>https://mySampleEnv.live. | <nowiki>https://mySampleEnv.live.dynatrace.com/api/config/v1/anomalyDetection/diskEvents/fdd83212-9c08-44ba-a0cf-dbb471cd819a</nowiki> \ | ||
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \ | -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \ | ||
-H 'Content-Type: application/json' \ | -H 'Content-Type: application/json' \ | ||
Строка 357: | Строка 357: | ||
==== URL-адрес запроса ==== | ==== URL-адрес запроса ==== | ||
<code><nowiki>https://mySampleEnv.live. | <code><nowiki>https://mySampleEnv.live.dynatrace.com/api/config/v1/anomalyDetection/diskEvents/fdd83212-9c08-44ba-a0cf-dbb471cd819a</nowiki></code> | ||
==== Тело запроса ==== | ==== Тело запроса ==== | ||
Строка 379: | Строка 379: | ||
==== Результат ==== | ==== Результат ==== | ||
Обновленная конфигурация имеет следующие параметры: | Обновленная конфигурация имеет следующие параметры: | ||
[[Файл:disk4.png]] |
Текущая версия на 17:07, 14 февраля 2023
Обновляет указанное правило событий диска.
Запрос создает и использует в качестве полезной нагрузки application/json
формат.
PUT | Managed | https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/diskEvents/{id}
|
Среда ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/diskEvents/{id}
|
Аутентификация
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Запись конфигурации ( WriteConfig
) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
Параметр | Тип | Описание | In | Необходимость |
---|---|---|---|---|
id | string | Идентификатор правила события диска, которое необходимо обновить. | path | требуется |
body | DiskEventAnomalyDetectionConfig | Тело запроса в формате JSON. Содержит обновленные параметры правил событий диска. | body | по желанию |
Объекты тела запроса
Объект DiskEventAnomalyDetectionConfig
Элемент | Тип | Описание | Необходимость |
---|---|---|---|
metadata | ConfigurationMetadata | Метаданные, полезные для отладки | по желанию |
id | string | Идентификатор правила события диска. | по желанию |
name | string | Имя правила событий диска. | требуется |
enabled | boolean | Правило событий диска включено/выключено. | требуется |
metric | string | Метрика для мониторинга.
Элемент может содержать эти значения
|
требуется |
threshold | number | Порог для срабатывания дискового события.
|
требуется |
samples | integer | Количество образцов для оценки. | требуется |
violatingSamples | integer | Количество выборок, которые должны нарушить пороговое значение, чтобы вызвать событие. Не должно превышать количество оцениваемых образцов. | требуется |
diskNameFilter | DiskNameFilter | Сужает использование правила до дисков, соответствующих указанным критериям. | по желанию |
tagFilters | TagFilter[] | Сужает использование правила до хостов, соответствующих указанным тегам. | по желанию |
hostGroupId | string | Сужает использование правила до дисков, которые работают на хостах, которые сами работают в указанной группе хостов. | по желанию |
Объект ConfigurationMetadata
Метаданные, полезные для отладки
Элемент | Тип | Описание | Необходимость |
---|---|---|---|
configurationVersions | integer[] | Отсортированный список номеров версий конфигурации. | по желанию |
currentConfigurationVersions | string[] | Отсортированный список номеров версий конфигурации. | по желанию |
clusterVersion | string | Версия Dynatrace. | по желанию |
Объект DiskNameFilter
Сужает использование правила до дисков, соответствующих указанным критериям.
Элемент | Тип | Описание | Необходимость |
---|---|---|---|
operator | string | Оператор сравнения.
Элемент может содержать эти значения
|
требуется |
value | string | Значение для сравнения. | требуется |
Объект TagFilter
Фильтр контролируемых объектов на основе тегов.
Элемент | Тип | Описание | Необходимость |
---|---|---|---|
context | string | Происхождение тега, например AWS или Cloud Foundry.
Пользовательские теги используют это Элемент может содержать эти значения
|
требуется |
key | string | Ключ тега.
Пользовательские теги имеют здесь значение тега. |
требуется |
value | string | Значение тега.
Не применимо к пользовательским тегам. |
по желанию |
JSON-модель тела запроса
Это модель тела запроса, показывающая возможные элементы. Его необходимо настроить для использования в реальном запросе.
{
"metadata": {
"configurationVersions": [
4,
2
],
"currentConfigurationVersions": [
"1.0.4",
"1.23"
],
"clusterVersion": "1.192.1"
},
"id": "string",
"name": "string",
"enabled": true,
"metric": "LOW_DISK_SPACE",
"threshold": 1,
"samples": 10,
"violatingSamples": 8,
"diskNameFilter": {
"operator": "CONTAINS",
"value": "string"
},
"tagFilters": [
{
"context": "AWS",
"key": "string",
"value": "string"
}
],
"hostGroupId": "string"
}
Ответ
Коды ответов
Код | Тип | Описание |
---|---|---|
201 | EntityShortRepresentation | Успех. Создано новое правило событий диска. Возвращается идентификатор нового правила событий диска. |
204 | Успех. Обновлено правило событий диска. Ответ не имеет тела. | |
400 | ErrorEnvelope | Не удалось. Ввод недействителен |
403 | Не удалось. Указанный идентификатор зарезервирован для внутреннего использования. |
Объекты тела ответа
Объект EntityShortRepresentation
Краткое представление объекта Dynatrace.
Элемент | Тип | Описание |
---|---|---|
id | string | Идентификатор объекта Dynatrace. |
name | string | Имя объекта Dynatrace. |
description | string | Краткое описание сущности Dynatrace. |
JSON-модель тела ответа
{
"id": "6a98d7bc-abb9-44f8-ae6a-73e68e71812a",
"name": "Dynatrace entity",
"description": "Dynatrace entity for the REST API example"
}
Проверка полезную нагрузку
Мы рекомендуем вам проверить полезную нагрузку перед ее отправкой с фактическим запросом. Код ответа 204 указывает на действительную полезную нагрузку.
Запрос использует в качестве полезной нагрузки application/json
формат.
POST | Managed | https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/diskEvents/{id}/validator
|
Среда ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/diskEvents/{id}/validator
|
Аутентификация
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Запись конфигурации ( WriteConfig
) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Ответ
Коды ответов
Код | Тип | Описание |
---|---|---|
204 | Подтверждено. Представленное правило события диска допустимо. Ответ не имеет тела. | |
400 | ErrorEnvelope | Не удалось. Ввод недействителен |
403 | Не удалось. Указанный идентификатор зарезервирован для внутреннего использования. |
Пример
В этом примере запрос обновляет правило очень медленного диска , которое мы создали в примере запроса POST . Он изменяет пороговое значение на 180 миллисекунд в 9 из 10 выборок.
Маркер API передается в заголовке авторизации .
Вы можете скачать или скопировать образец тела запроса, чтобы попробовать его самостоятельно.
Curl
curl -X PUT \
https://mySampleEnv.live.dynatrace.com/api/config/v1/anomalyDetection/diskEvents/fdd83212-9c08-44ba-a0cf-dbb471cd819a \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
-H 'Content-Type: application/json' \
-d '{
"name": "very slow disk",
"enabled": true,
"metric": "READ_TIME_EXCEEDING",
"threshold": 180,
"samples": 10,
"violatingSamples": 9,
"diskNameFilter": {
"operator": "STARTS_WITH",
"value": "C"
},
"tagFilters": []
}
'
URL-адрес запроса
https://mySampleEnv.live.dynatrace.com/api/config/v1/anomalyDetection/diskEvents/fdd83212-9c08-44ba-a0cf-dbb471cd819a
Тело запроса
{
"name": "very slow disk",
"enabled": true,
"metric": "READ_TIME_EXCEEDING",
"threshold": 180,
"samples": 10,
"violatingSamples": 9,
"diskNameFilter": {
"operator": "STARTS_WITH",
"value": "C"
},
"tagFilters": []
}
Код ответа
204
Результат
Обновленная конфигурация имеет следующие параметры: