API обнаружения аномалий служб - PUT конфигурация - История изменений

IKuznetsov в 17:48, 2 января 2025

2025-01-02T17:48:39Z

← Предыдущая версия		Версия от 17:48, 2 января 2025
Строка 1:		Строка 1:
			'''''[[API АппОптима]] / [[API АппОптима\|Эндпойнты конфигурации]] / [https://docs.expert-apm.ru/index.php/API_%D0%90%D0%BF%D0%BF%D0%9E%D0%BF%D1%82%D0%B8%D0%BC%D0%B0#:~:text=%D0%9E%D0%B1%D0%BD%D0%B0%D1%80%D1%83%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20%D0%B0%D0%BD%D0%BE%D0%BC%D0%B0%D0%BB%D0%B8%D0%B9 Обнаружение аномалий] / [[API обнаружения аномалий - Службы\|Службы]] / PUT конфигурация'''''

	Обновляет конфигурацию обнаружения аномалий для сервисов.		Обновляет конфигурацию обнаружения аномалий для сервисов.

Строка 393:		Строка 395:
	}		}
	}		}
	}~~</code>~~		}

	== Ответ ==		== Ответ ==
Строка 480:		Строка 482:
	}		}
	}		}
	'~~</code>~~		'

	==== URL-адрес запроса ====		==== URL-адрес запроса ====
Строка 504:		Строка 506:
	}		}
	}		}
	}~~</code>~~		}

	==== Код ответа ====		==== Код ответа ====

IKuznetsov в 10:26, 26 декабря 2024

2024-12-26T10:26:55Z

← Предыдущая версия		Версия от 10:26, 26 декабря 2024
Строка 4:		Строка 4:
	{\| class="wikitable"		{\| class="wikitable"
	\| rowspan="2" \|PUT		\| rowspan="2" \|PUT
	\|~~Ключ-АСТРОМ Managed~~ для управления		\|АппОптима для управления
	\|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/services</nowiki></code>		\|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/services</nowiki></code>
	\|-		\|-
Строка 34:		Строка 34:

	==== Объект <code>ServiceAnomalyDetectionConfig</code> ====		==== Объект <code>ServiceAnomalyDetectionConfig</code> ====
	~~Ключ-АСТРОМ~~ автоматически обнаруживает аномалии производительности, связанные с обслуживанием, такие как снижение времени отклика и увеличение частоты отказов. Используйте эти параметры, чтобы настроить чувствительность обнаружения, установить пороги предупреждений или отключить предупреждения для определенных служб.		АппОптима автоматически обнаруживает аномалии производительности, связанные с обслуживанием, такие как снижение времени отклика и увеличение частоты отказов. Используйте эти параметры, чтобы настроить чувствительность обнаружения, установить пороги предупреждений или отключить предупреждения для определенных служб.
	{\| class="wikitable"		{\| class="wikitable"
	!Элемент		!Элемент
Строка 87:		Строка 87:
	\|clusterVersion		\|clusterVersion
	\|нить		\|нить
	\|Версия ~~Ключ-АСТРОМ~~.		\|Версия АппОптима.
	\|необязательный		\|необязательный
	\|}		\|}
Строка 360:		Строка 360:
	=== JSON-модель тела запроса ===		=== JSON-модель тела запроса ===
	Это модель тела запроса, показывающая возможные элементы. Его необходимо настроить для использования в реальном запросе.		Это модель тела запроса, показывающая возможные элементы. Его необходимо настроить для использования в реальном запросе.
	<~~code>~~{		<{
	"metadata": {		"metadata": {
	"configurationVersions": [		"configurationVersions": [
Строка 418:		Строка 418:
	{\| class="wikitable"		{\| class="wikitable"
	\| rowspan="2" \|POST		\| rowspan="2" \|POST
	\|~~Ключ-АСТРОМ Managed~~ для управления		\|АппОптима для управления
	\|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/services/validator</nowiki></code>		\|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/services/validator</nowiki></code>
	\|-		\|-
Строка 457:		Строка 457:

	==== Завиток ====		==== Завиток ====
	<~~code>~~curl -X PUT \		<curl -X PUT \
	<nowiki>https://mySampleEnv.live.astromkey.com/api/config/v1/anomalyDetection/services</nowiki> \		<nowiki>https://mySampleEnv.live.astromkey.com/api/config/v1/anomalyDetection/services</nowiki> \
	-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \		-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
Строка 486:		Строка 486:

	==== Тело запроса ====		==== Тело запроса ====
	<~~code>~~{		<{
	"responseTimeDegradation": {		"responseTimeDegradation": {
	"detectionMode": "DETECT_AUTOMATICALLY",		"detectionMode": "DETECT_AUTOMATICALLY",

ENetrebin: /* Объект _ LoadSpikeDetectionConfig */

2023-05-12T17:46:23Z

Объект _ LoadSpikeDetectionConfig

← Предыдущая версия		Версия от 17:46, 12 мая 2023
Строка 244:		Строка 244:
	\|}		\|}

	==== Объект _ <code>LoadSpikeDetectionConfig</code> ====		==== Объект <code>LoadSpikeDetectionConfig</code> ====
	Настройка обнаружения скачков нагрузки.		Настройка обнаружения скачков нагрузки.
	{\| class="wikitable"		{\| class="wikitable"
Строка 268:		Строка 268:
	\|}		\|}

	==== Объект _ <code>FailureRateIncreaseDetectionConfig</code> ====		==== Объект <code>FailureRateIncreaseDetectionConfig</code> ====
	Конфигурация обнаружения увеличения частоты отказов.		Конфигурация обнаружения увеличения частоты отказов.
	{\| class="wikitable"		{\| class="wikitable"
Строка 304:		Строка 304:
	\|}		\|}

	==== Объект _ <code>FailureRateIncreaseAutodetectionConfig</code> ====		==== Объект <code>FailureRateIncreaseAutodetectionConfig</code> ====
	Параметры автообнаружения увеличивают частоту отказов. Требуется, если режим обнаружения равен <code>DETECT_AUTOMATICALLY</code>. В противном случае неприменимо.		Параметры автообнаружения увеличивают частоту отказов. Требуется, если режим обнаружения равен <code>DETECT_AUTOMATICALLY</code>. В противном случае неприменимо.

Строка 327:		Строка 327:
	\|}		\|}

	==== Объект _ <code>FailureRateIncreaseThresholdConfig</code> ====		==== Объект <code>FailureRateIncreaseThresholdConfig</code> ====
	Фиксированные пороги для обнаружения увеличения частоты отказов.		Фиксированные пороги для обнаружения увеличения частоты отказов.

Строка 417:		Строка 417:
	Запрос потребляет <code>application/json</code>полезную нагрузку.		Запрос потребляет <code>application/json</code>полезную нагрузку.
	{\| class="wikitable"		{\| class="wikitable"
	\| rowspan="2" \|~~ПОЧТА~~		\| rowspan="2" \|POST
	\|Ключ-АСТРОМ Managed для управления		\|Ключ-АСТРОМ Managed для управления
	\|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/services/validator</nowiki></code>		\|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/services/validator</nowiki></code>
	\|-		\|-
	\|~~Окружающая среда ActiveGate~~		\|Cреда АктивногоШлюза
	\|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/services/validator</nowiki></code>		\|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/services/validator</nowiki></code>
	\|}		\|}
Строка 428:		Строка 428:
	Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия. <code>WriteConfig</code>		Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия. <code>WriteConfig</code>

	Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .		Чтобы узнать, как его получить и использовать, см. раздел [[Токены и аутентификация (API)\|Токены и аутентификация]] .

	=== Ответ ===		=== Ответ ===

ENetrebin: /* Объект _ ServiceAnomalyDetectionConfig */

2023-05-05T16:44:27Z

Объект _ ServiceAnomalyDetectionConfig

← Предыдущая версия		Версия от 16:44, 5 мая 2023
Строка 33:		Строка 33:
	=== Объекты тела запроса ===		=== Объекты тела запроса ===

	==== Объект _ <code>ServiceAnomalyDetectionConfig</code> ====		==== Объект <code>ServiceAnomalyDetectionConfig</code> ====
	Ключ-АСТРОМ автоматически обнаруживает аномалии производительности, связанные с обслуживанием, такие как снижение времени отклика и увеличение частоты отказов. Используйте эти параметры, чтобы настроить чувствительность обнаружения, установить пороги предупреждений или отключить предупреждения для определенных служб.		Ключ-АСТРОМ автоматически обнаруживает аномалии производительности, связанные с обслуживанием, такие как снижение времени отклика и увеличение частоты отказов. Используйте эти параметры, чтобы настроить чувствительность обнаружения, установить пороги предупреждений или отключить предупреждения для определенных служб.
	{\| class="wikitable"		{\| class="wikitable"

ENetrebin: /* Объект ConfigurationMetadata */

2023-05-03T15:32:36Z

Объект ConfigurationMetadata

← Предыдущая версия		Версия от 15:32, 3 мая 2023
Строка 73:		Строка 73:
	!Тип		!Тип
	!Описание		!Описание
	!~~Необходимый~~		!Необходимость
	\|-		\|-
	\|конфигурацияВерсии		\|конфигурацияВерсии
Строка 133:		Строка 133:
	!Тип		!Тип
	!Описание		!Описание
	!~~Необходимый~~		!Необходимость
	\|-		\|-
	\|responseTimeDegradationMilliseconds		\|responseTimeDegradationMilliseconds
Строка 178:		Строка 178:
	!Тип		!Тип
	!Описание		!Описание
	!~~Необходимый~~		!Необходимость
	\|-		\|-
	\|responseTimeThresholdMilliseconds		\|responseTimeThresholdMilliseconds
Строка 226:		Строка 226:
	!Тип		!Тип
	!Описание		!Описание
	!~~Необходимый~~		!Необходимость
	\|-		\|-
	\|включено		\|включено
Строка 250:		Строка 250:
	!Тип		!Тип
	!Описание		!Описание
	!~~Необходимый~~		!Необходимость
	\|-		\|-
	\|включено		\|включено
Строка 274:		Строка 274:
	!Тип		!Тип
	!Описание		!Описание
	!~~Необходимый~~		!Необходимость
	\|-		\|-
	\|режим обнаружения		\|режим обнаружения
Строка 314:		Строка 314:
	!Тип		!Тип
	!Описание		!Описание
	!~~Необходимый~~		!Необходимость
	\|-		\|-
	\|фейлингсервицекаллперцентажеинкреасеабсолют		\|фейлингсервицекаллперцентажеинкреасеабсолют
Строка 335:		Строка 335:
	!Тип		!Тип
	!Описание		!Описание
	!~~Необходимый~~		!Необходимость
	\|-		\|-
	\|порог		\|порог

ENetrebin: /* Объект ResponseTimeDegradationDetectionConfig */

2023-04-24T16:55:06Z

Объект ResponseTimeDegradationDetectionConfig

← Предыдущая версия		Версия от 16:55, 24 апреля 2023
Строка 97:		Строка 97:
	!Тип		!Тип
	!Описание		!Описание
	!~~Необходимый~~		!Необходимость
	\|-		\|-
	\|режим обнаружения		\|режим обнаружения
	\|~~нить~~		\|string
	\|Как обнаружить ухудшение времени отклика: автоматически, или на основе фиксированных порогов, или не обнаруживать.		\|Как обнаружить ухудшение времени отклика: автоматически, или на основе фиксированных порогов, или не обнаруживать.

ENetrebin: /* Объект ConfigurationMetadata */

2023-04-22T15:45:38Z

Объект ConfigurationMetadata

← Предыдущая версия		Версия от 15:45, 22 апреля 2023
Строка 87:		Строка 87:
	\|clusterVersion		\|clusterVersion
	\|нить		\|нить
	\|Версия ~~Дайнатрейс~~.		\|Версия Ключ-АСТРОМ.
	\|необязательный		\|необязательный
	\|}		\|}

ENetrebin: /* Параметры */

2023-04-22T15:45:09Z

Параметры

← Предыдущая версия		Версия от 15:45, 22 апреля 2023
Строка 39:		Строка 39:
	!Тип		!Тип
	!Описание		!Описание
	!~~Необходимый~~		!Необходимость
	\|-		\|-
	\|метаданные		\|метаданные
Строка 67:		Строка 67:
	\|}		\|}

	==== Объект _ <code>ConfigurationMetadata</code> ====		==== Объект <code>ConfigurationMetadata</code> ====
	Метаданные, полезные для отладки		Метаданные, полезные для отладки
	{\| class="wikitable"		{\| class="wikitable"
Строка 91:		Строка 91:
	\|}		\|}

	==== Объект _ <code>ResponseTimeDegradationDetectionConfig</code> ====		==== Объект <code>ResponseTimeDegradationDetectionConfig</code> ====
	Настройка обнаружения ухудшения времени отклика.		Настройка обнаружения ухудшения времени отклика.
	{\| class="wikitable"		{\| class="wikitable"
Строка 125:		Строка 125:
	\|}		\|}

	==== Объект _ <code>ResponseTimeDegradationAutodetectionConfig</code> ====		==== Объект <code>ResponseTimeDegradationAutodetectionConfig</code> ====
	Параметры автоматического определения деградации времени отклика. Требуется, если для параметра discoveryMode установлено значение <code>DETECT_AUTOMATICALLY</code>. В противном случае неприменимо.		Параметры автоматического определения деградации времени отклика. Требуется, если для параметра discoveryMode установлено значение <code>DETECT_AUTOMATICALLY</code>. В противном случае неприменимо.

ENetrebin в 08:04, 13 апреля 2023

2023-04-13T08:04:36Z

← Предыдущая версия		Версия от 08:04, 13 апреля 2023
Строка 34:		Строка 34:

	==== Объект _ <code>ServiceAnomalyDetectionConfig</code> ====		==== Объект _ <code>ServiceAnomalyDetectionConfig</code> ====
	~~Dynatrace~~ автоматически обнаруживает аномалии производительности, связанные с обслуживанием, такие как снижение времени отклика и увеличение частоты отказов. Используйте эти параметры, чтобы настроить чувствительность обнаружения, установить пороги предупреждений или отключить предупреждения для определенных служб.		Ключ-АСТРОМ автоматически обнаруживает аномалии производительности, связанные с обслуживанием, такие как снижение времени отклика и увеличение частоты отказов. Используйте эти параметры, чтобы настроить чувствительность обнаружения, установить пороги предупреждений или отключить предупреждения для определенных служб.
	{\| class="wikitable"		{\| class="wikitable"
	!Элемент		!Элемент
Строка 417:		Строка 417:
	Запрос потребляет <code>application/json</code>полезную нагрузку.		Запрос потребляет <code>application/json</code>полезную нагрузку.
	{\| class="wikitable"		{\| class="wikitable"
	\| rowspan="3" \|ПОЧТА		\| rowspan="2" \|ПОЧТА
	\|~~УдалосьDynatrace~~ для ~~правительства~~		\|Ключ-АСТРОМ Managed для управления
	\|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/services/validator</nowiki></code>		\|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/services/validator</nowiki></code>
	\|-
	~~\|SaaS~~
	~~\|<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/config/v1/anomalyDetection/services/validator</nowiki></code>~~
	\|-		\|-
	\|Окружающая среда ActiveGate		\|Окружающая среда ActiveGate
Строка 461:		Строка 458:
	==== Завиток ====		==== Завиток ====
	<code>curl -X PUT \		<code>curl -X PUT \
	<nowiki>https://mySampleEnv.live.~~dynatrace~~.com/api/config/v1/anomalyDetection/services</nowiki> \		<nowiki>https://mySampleEnv.live.astromkey.com/api/config/v1/anomalyDetection/services</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' \
Строка 486:		Строка 483:

	==== URL-адрес запроса ====		==== URL-адрес запроса ====
	<code>PUT <nowiki>https://mySampleEnv.live.~~dynatrace~~.com/api/config/v1/anomalyDetection/services</nowiki></code>		<code>PUT <nowiki>https://mySampleEnv.live.astromkey.com/api/config/v1/anomalyDetection/services</nowiki></code>

	==== Тело запроса ====		==== Тело запроса ====

ENetrebin: Новая страница: «Обновляет конфигурацию обнаружения аномалий для сервисов. Запрос использует в качеств...»

2023-03-02T18:05:02Z

Новая страница: «Обновляет конфигурацию обнаружения аномалий для сервисов. Запрос использует в качеств...»

Новая страница

Обновляет конфигурацию обнаружения аномалий для сервисов.

Запрос использует в качестве полезной нагрузки <code>application/json</code>формат.
{| class="wikitable"
| rowspan="2" |PUT
|Ключ-АСТРОМ Managed для управления
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/services</nowiki></code>
|-
|Среда АктивногоШлюза
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/services</nowiki></code>
|}

== Аутентификация ==
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия. <code>WriteConfig</code>

Чтобы узнать, как его получить и использовать, см. раздел [[Токены и аутентификация (API)|Токены и аутентификация]] .

== Параметры ==
{| class="wikitable"
!Параметр
!Тип
!Описание
!В
!Необходимый
|-
|тело
|Конфигурация обнаружения аномалий обслуживания
|Тело JSON запроса. Содержит параметры конфигурации обнаружения аномалий службы.
|тело
|необязательный
|}

=== Объекты тела запроса ===

==== Объект _ <code>ServiceAnomalyDetectionConfig</code> ====
Dynatrace автоматически обнаруживает аномалии производительности, связанные с обслуживанием, такие как снижение времени отклика и увеличение частоты отказов. Используйте эти параметры, чтобы настроить чувствительность обнаружения, установить пороги предупреждений или отключить предупреждения для определенных служб.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимый
|-
|метаданные
|Метаданные конфигурации
|Метаданные, полезные для отладки
|необязательный
|-
|ответВремядеградации
|Конфигурация обнаружения деградации времени отклика
|Настройка обнаружения ухудшения времени отклика.
|необходимый
|-
|loadDrop
|Конфигурация обнаружения сброса загрузки
|Конфигурация обнаружения падения нагрузки.
|необязательный
|-
|loadSpike
|Загрузить конфигурацию обнаружения всплесков
|Настройка обнаружения скачков нагрузки.
|необязательный
|-
|отказRateIncrease
|Конфигурация обнаружения увеличения частоты отказов
|Конфигурация обнаружения увеличения частоты отказов.
|необходимый
|}

==== Объект _ <code>ConfigurationMetadata</code> ====
Метаданные, полезные для отладки
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимый
|-
|конфигурацияВерсии
|целое []
|Отсортированный список номеров версий конфигурации.
|необязательный
|-
|текущие версии конфигурации
|строка []
|Отсортированный список номеров версий конфигурации.
|необязательный
|-
|clusterVersion
|нить
|Версия Дайнатрейс.
|необязательный
|}

==== Объект _ <code>ResponseTimeDegradationDetectionConfig</code> ====
Настройка обнаружения ухудшения времени отклика.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимый
|-
|режим обнаружения
|нить
|Как обнаружить ухудшение времени отклика: автоматически, или на основе фиксированных порогов, или не обнаруживать.

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

* <code>DETECT_AUTOMATICALLY</code>
* <code>DETECT_USING_FIXED_THRESHOLDS</code>
* <code>DONT_DETECT</code>
|необходимый
|-
|автоматическое обнаружение
|Конфигурация автоопределения деградации времени отклика
|Параметры автоматического определения деградации времени отклика. Требуется, если для параметра discoveryMode установлено значение <code>DETECT_AUTOMATICALLY</code>. В противном случае неприменимо.

Нарушение любого критерия вызывает предупреждение.
|необязательный
|-
|пороги
|Конфигурация порога деградации времени отклика
|Фиксированные пороги для обнаружения ухудшения времени отклика.

Требуется, если режим обнаружения равен <code>DETECT_USING_FIXED_THRESHOLDS</code>. В противном случае неприменимо.
|необязательный
|}

==== Объект _ <code>ResponseTimeDegradationAutodetectionConfig</code> ====
Параметры автоматического определения деградации времени отклика. Требуется, если для параметра discoveryMode установлено значение <code>DETECT_AUTOMATICALLY</code>. В противном случае неприменимо.

Нарушение любого критерия вызывает предупреждение.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимый
|-
|responseTimeDegradationMilliseconds
|целое число
|Предупреждать, если время отклика ухудшится за ''X'' миллисекунд.
|необходимый
|-
|ответтимедеградатионперцент
|целое число
|Предупреждать, если время отклика превышает ''X'' %.
|необходимый
|-
|slowestResponseTimeDegradationMilliseconds
|целое число
|Предупреждать, если время отклика самых медленных 10% ухудшится за ''X'' миллисекунд.
|необходимый
|-
|slowestResponseTimeDegradationPercent
|целое число
|Предупреждать, если время отклика самых медленных 10% ухудшится за ''X'' %.
|необходимый
|-
|Порог нагрузки
|нить
|Минимальная нагрузка на сервис для обнаружения ухудшения времени отклика.

Ухудшение времени отклика служб с меньшей нагрузкой не приведет к срабатыванию предупреждений.

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

* <code>FIFTEEN_REQUESTS_PER_MINUTE</code>
* <code>FIVE_REQUESTS_PER_MINUTE</code>
* <code>ONE_REQUEST_PER_MINUTE</code>
* <code>TEN_REQUESTS_PER_MINUTE</code>
|необходимый
|}

==== Объект _ <code>ResponseTimeDegradationThresholdConfig</code> ====
Фиксированные пороги для обнаружения ухудшения времени отклика.

Требуется, если режим обнаружения равен <code>DETECT_USING_FIXED_THRESHOLDS</code>. В противном случае неприменимо.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимый
|-
|responseTimeThresholdMilliseconds
|целое число
|Время отклика в течение любого 5-минутного периода для срабатывания оповещения в миллисекундах.
|необходимый
|-
|slowestResponseTimeThresholdMilliseconds
|целое число
|Время отклика 10 % самых медленных в течение любого 5-минутного периода времени для срабатывания оповещения, в миллисекундах.
|необходимый
|-
|Порог нагрузки
|нить
|Минимальная нагрузка на сервис для обнаружения ухудшения времени отклика.

Ухудшение времени отклика служб с меньшей нагрузкой не приведет к срабатыванию предупреждений.

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

* <code>FIFTEEN_REQUESTS_PER_MINUTE</code>
* <code>FIVE_REQUESTS_PER_MINUTE</code>
* <code>ONE_REQUEST_PER_MINUTE</code>
* <code>TEN_REQUESTS_PER_MINUTE</code>
|необходимый
|-
|чувствительность
|нить
|Чувствительность порога.

При <code>low</code>чувствительности используется высокая статистическая достоверность. Кратковременные нарушения (например, из-за резкого скачка нагрузки) не вызывают оповещения.

В случае <code>high</code>чувствительности статистическая достоверность не используется. Каждое нарушение вызывает оповещение.

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

* <code>HIGH</code>
* <code>LOW</code>
* <code>MEDIUM</code>
|необходимый
|}

==== Объект _ <code>LoadDropDetectionConfig</code> ====
Конфигурация обнаружения падения нагрузки.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимый
|-
|включено
|логический
|Обнаружение включено ( <code>true</code>) или отключено ( <code>false</code>).
|необходимый
|-
|loadDropPercent
|целое число
|Предупреждать, если наблюдаемая нагрузка меньше ''X'' % от ожидаемого значения.
|необязательный
|-
|minAbnormalStateDurationInMinutes
|целое число
|Оповещение, если служба остается в ненормальном состоянии не менее ''X'' минут.
|необязательный
|}

==== Объект _ <code>LoadSpikeDetectionConfig</code> ====
Настройка обнаружения скачков нагрузки.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимый
|-
|включено
|логический
|Обнаружение включено ( <code>true</code>) или отключено ( <code>false</code>).
|необходимый
|-
|loadSpikePercent
|целое число
|Предупреждать, если наблюдаемая нагрузка превышает ''X'' % ожидаемого значения.
|необязательный
|-
|minAbnormalStateDurationInMinutes
|целое число
|Оповещение, если служба остается в ненормальном состоянии не менее ''X'' минут.
|необязательный
|}

==== Объект _ <code>FailureRateIncreaseDetectionConfig</code> ====
Конфигурация обнаружения увеличения частоты отказов.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимый
|-
|режим обнаружения
|нить
|Как обнаружить увеличение частоты отказов: автоматически, или на основе фиксированных порогов, или не обнаруживать.

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

* <code>DETECT_AUTOMATICALLY</code>
* <code>DETECT_USING_FIXED_THRESHOLDS</code>
* <code>DONT_DETECT</code>
|необходимый
|-
|автоматическое обнаружение
|Конфигурация автообнаружения увеличения частоты отказов
|Параметры автообнаружения увеличивают частоту отказов. Требуется, если режим обнаружения равен <code>DETECT_AUTOMATICALLY</code>. В противном случае неприменимо.

Абсолютный и относительный пороги должны быть превышены, чтобы сработало оповещение.

Пример: если ожидаемая частота ошибок составляет 1,5 %, и вы установили абсолютное увеличение на 1 % и относительное увеличение на 50 %, пороговые значения будут следующими: Абсолютный: 1,5 % + 1 % = 2,5 % Относительный: 1,5 % + 1,5 % * 50% = 2,25%
|необязательный
|-
|пороги
|Конфигурация порога увеличения частоты отказов
|Фиксированные пороги для обнаружения увеличения частоты отказов.

Требуется, если режим обнаружения равен <code>DETECT_USING_FIXED_THRESHOLDS</code>. В противном случае неприменимо.
|необязательный
|}

==== Объект _ <code>FailureRateIncreaseAutodetectionConfig</code> ====
Параметры автообнаружения увеличивают частоту отказов. Требуется, если режим обнаружения равен <code>DETECT_AUTOMATICALLY</code>. В противном случае неприменимо.

Абсолютный и относительный пороги должны быть превышены, чтобы сработало оповещение.

Пример: если ожидаемая частота ошибок составляет 1,5 %, и вы установили абсолютное увеличение на 1 % и относительное увеличение на 50 %, пороговые значения будут следующими: Абсолютный: 1,5 % + 1 % = 2,5 % Относительный: 1,5 % + 1,5 % * 50% = 2,25%
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимый
|-
|фейлингсервицекаллперцентажеинкреасеабсолют
|целое число
|Абсолютный прирост числа неудачных вызовов службы для срабатывания оповещения, %.
|необходимый
|-
|сбойServiceCallPercentageIncreaseRelative
|целое число
|Относительное увеличение числа неудачных вызовов службы для срабатывания оповещения, %.
|необходимый
|}

==== Объект _ <code>FailureRateIncreaseThresholdConfig</code> ====
Фиксированные пороги для обнаружения увеличения частоты отказов.

Требуется, если режим обнаружения равен <code>DETECT_USING_FIXED_THRESHOLDS</code>. В противном случае неприменимо.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимый
|-
|порог
|целое число
|Частота отказов в течение любого 5-минутного периода для срабатывания оповещения, %.
|необходимый
|-
|чувствительность
|нить
|Чувствительность порога.

При <code>low</code>чувствительности используется высокая статистическая достоверность. Кратковременные нарушения (например, из-за резкого скачка нагрузки) не вызывают оповещения.

В случае <code>high</code>чувствительности статистическая достоверность не используется. Каждое нарушение вызывает оповещение.

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

* <code>HIGH</code>
* <code>LOW</code>
* <code>MEDIUM</code>
|необходимый
|}

=== JSON-модель тела запроса ===
Это модель тела запроса, показывающая возможные элементы. Его необходимо настроить для использования в реальном запросе.
<code>{
"metadata": {
"configurationVersions": [
4,
2
],
"clusterVersion": "Mock version"
},
"responseTimeDegradation": {
"detectionMode": "DETECT_AUTOMATICALLY",
"automaticDetection": {
"responseTimeDegradationMilliseconds": 250,
"responseTimeDegradationPercent": 90,
"slowestResponseTimeDegradationMilliseconds": 500,
"slowestResponseTimeDegradationPercent": 200,
"loadThreshold": "ONE_REQUEST_PER_MINUTE"
}
},
"loadDrop": {
"enabled": true,
"loadDropPercent": 40,
"minAbnormalStateDurationInMinutes": 5
},
"loadSpike": {
"enabled": false
},
"failureRateIncrease": {
"detectionMode": "DETECT_USING_FIXED_THRESHOLDS",
"thresholds": {
"threshold": 10,
"sensitivity": "LOW"
}
}
}</code>

== Ответ ==

=== Коды ответов ===
{| class="wikitable"
!Код
|Тип
!Описание
|-
|204
|
|Успех. Конфигурация обновлена. Ответ не имеет тела.
|-
|400
|ErrorEnvelope
|Неуспешный. Ввод недействителен
|}

== Проверить полезную нагрузку ==
Мы рекомендуем вам проверить полезную нагрузку перед ее отправкой с фактическим запросом. Код ответа 204 указывает на действительную полезную нагрузку.

Запрос потребляет <code>application/json</code>полезную нагрузку.
{| class="wikitable"
| rowspan="3" |ПОЧТА
|УдалосьDynatrace для правительства
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/services/validator</nowiki></code>
|-
|SaaS
|<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/config/v1/anomalyDetection/services/validator</nowiki></code>
|-
|Окружающая среда ActiveGate
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/services/validator</nowiki></code>
|}

=== Аутентификация ===
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия. <code>WriteConfig</code>

Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .

=== Ответ ===

==== Коды ответов ====
{| class="wikitable"
!Код
|Тип
!Описание
|-
|204
|
|Подтверждено. Представленная конфигурация действительна. Ответ не имеет тела.
|-
|400
|ErrorEnvelope
|Неуспешный. Ввод недействителен
|}

== Пример ==
В этом примере запрос обновляет конфигурацию обнаружения аномалий для сервисов из примера запроса GET . Он изменяет режим Обнаружение увеличения частоты отказов на используемые фиксированные пороги и устанавливает следующий порог с высокой чувствительностью:

* Оповещение при превышении 3 % пользовательского порога частоты отказов в течение любого 5-минутного периода.

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

Вы можете скачать или скопировать образец тела запроса, чтобы попробовать его самостоятельно. Обязательно создайте резервную копию текущей конфигурации с помощью вызова конфигурации обнаружения аномалий служб GET .

==== Завиток ====
<code>curl -X PUT \
<nowiki>https://mySampleEnv.live.dynatrace.com/api/config/v1/anomalyDetection/services</nowiki> \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
-H 'Content-Type: application/json' \
-d '{
"responseTimeDegradation": {
"detectionMode": "DETECT_AUTOMATICALLY",
"automaticDetection": {
"responseTimeDegradationMilliseconds": 100,
"responseTimeDegradationPercent": 50,
"slowestResponseTimeDegradationMilliseconds": 100,
"slowestResponseTimeDegradationPercent": 100,
"loadThreshold": "TEN_REQUESTS_PER_MINUTE"
}
},
"failureRateIncrease": {
"detectionMode": "DETECT_USING_FIXED_THRESHOLDS",
"thresholds": {
"threshold": 3,
"sensitivity": "HIGH"
}
}
}
'</code>

==== URL-адрес запроса ====
<code>PUT <nowiki>https://mySampleEnv.live.dynatrace.com/api/config/v1/anomalyDetection/services</nowiki></code>

==== Тело запроса ====
<code>{
"responseTimeDegradation": {
"detectionMode": "DETECT_AUTOMATICALLY",
"automaticDetection": {
"responseTimeDegradationMilliseconds": 100,
"responseTimeDegradationPercent": 50,
"slowestResponseTimeDegradationMilliseconds": 100,
"slowestResponseTimeDegradationPercent": 100,
"loadThreshold": "TEN_REQUESTS_PER_MINUTE"
}
},
"failureRateIncrease": {
"detectionMode": "DETECT_USING_FIXED_THRESHOLDS",
"thresholds": {
"threshold": 3,
"sensitivity": "HIGH"
}
}
}</code>

==== Код ответа ====
204

==== Результат ====
Обновленная конфигурация имеет следующие параметры: