ENetrebin в 16:44, 14 февраля 2023

2023-02-14T16:44:06Z

← Предыдущая		Версия 16:44, 14 февраля 2023
Строка 7:		Строка 7:
	\|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/aws</nowiki></code>		\|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/aws</nowiki></code>
	\|-		\|-
	\|Среда ~~АктивногоШлюза~~		\|Среда ActiveGate
	\|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/aws</nowiki></code>		\|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/aws</nowiki></code>
	\|}		\|}
Строка 105:		Строка 105:
	\|clusterVersion		\|clusterVersion
	\|string		\|string
	\|Версия ~~Ключ-АСТРОМ~~.		\|Версия Dynatrace.
	\|по желанию		\|по желанию
	\|}		\|}
Строка 502:		Строка 502:
	==== Curl ====		==== Curl ====
	<code>curl -X PUT \		<code>curl -X PUT \
	<nowiki>https://mySampleEnv.live.~~ruscomtech~~.ru/api/config/v1/anomalyDetection/aws</nowiki> \		<nowiki>https://mySampleEnv.live.dynatrace.com/api/config/v1/anomalyDetection/aws</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' \
Строка 534:		Строка 534:

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

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

ENetrebin в 13:58, 27 октября 2022

2022-10-27T13:58:28Z

← Предыдущая		Версия 13:58, 27 октября 2022
Строка 569:		Строка 569:
	==== Результат ====		==== Результат ====
	Обновленная конфигурация имеет следующие параметры:		Обновленная конфигурация имеет следующие параметры:

			[[Файл:aws2.png]]

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

2022-10-27T13:56:25Z

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

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

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

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

== Аутентификация ==
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Запись конфигурации ( <code>WriteConfig</code>) . Чтобы узнать, как его получить и использовать, см. раздел [[Токены и аутентификация (API)|Токены и аутентификация]] .

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

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

==== Объект <code>AwsAnomalyDetectionConfig</code> ====
Конфигурация обнаружения аномалий для AWS.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|metadata
|ConfigurationMetadata
|Метаданные, полезные для отладки
|по желанию
|-
|rdsHighCpuDetection
|RdsHighCpuDetectionConfig
|Конфигурация высокой загрузки ЦП при обнаружении RDS.
|требуется
|-
|rdsHighWriteReadLatencyDetection
|RdsHighWriteReadLatencyDetectionConfig
|Конфигурация обнаружения высокой задержки записи/чтения RDS.
|требуется
|-
|rdsLowStorageDetection
|RdsLowStorageDetectionConfig
|Конфигурация низкого свободного места на диске при обнаружении RDS.
|требуется
|-
|rdsHighMemoryDetection
|RdsHighMemoryDetectionConfig
|Конфигурация RDS с обнаружением нехватки памяти.
|требуется
|-
|elbHighConnectionErrorsDetection
|ElbHighConnectionErrorsDetectionConfig
|Конфигурация большого количества ошибок соединения с серверной частью при обнаружении ELB.
|требуется
|-
|rdsRestartsSequenceDetection
|RdsRestartsSequenceDetectionConfig
|Конфигурация последовательности перезапусков при обнаружении RDS.
|требуется
|-
|lambdaHighErrorRateDetection
|LambdaHighErrorRateDetectionConfig
|Конфигурация обнаружения высокой частоты ошибок AWS Lambda.
|требуется
|-
|ec2CandidateCpuSaturationDetection
|Ec2CandidateCpuSaturationDetectionConfig
|Конфигурация высокой загрузки ЦП на EC2 без установленного агента (кандидат на мониторинг). Если null, то эта конфигурация не будет изменена.
|по желанию
|}

==== Объект <code>ConfigurationMetadata</code> ====
Метаданные, полезные для отладки
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|configurationVersions
|integer[]
|Отсортированный список номеров версий конфигурации.
|по желанию
|-
|currentConfigurationVersions
|string[]
|Отсортированный список номеров версий конфигурации.
|по желанию
|-
|clusterVersion
|string
|Версия Ключ-АСТРОМ.
|по желанию
|}

==== Объект <code>RdsHighCpuDetectionConfig</code> ====
Конфигурация высокой загрузки ЦП при обнаружении RDS.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|enabled
|boolean
|Обнаружение включено ( <code>true</code>) или отключено ( <code>false</code>).
|требуется
|-
|customThresholds
|RdsHighCpuThresholds
|Пользовательские пороги высокой загрузки ЦП в RDS. Если не установлено, используется автоматический режим.
|по желанию
|}

==== Объект <code>RdsHighCpuThresholds</code> ====
Пользовательские пороги высокой загрузки ЦП в RDS. Если не установлено, используется автоматический режим.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|cpuUsagePercentage
|integer
|Предупреждать, если загрузка ЦП превышает ''X'' % в 3 из 5 выборок.
|требуется
|}

==== Объект <code>RdsHighWriteReadLatencyDetectionConfig</code> ====
Конфигурация обнаружения высокой задержки записи/чтения RDS.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|enabled
|boolean
|Обнаружение включено ( <code>true</code>) или отключено ( <code>false</code>).
|требуется
|-
|customThresholds
|RdsHighLatencyThresholds
|Пользовательские пороговые значения для высокой задержки записи/чтения RDS. Если не установлено, используется автоматический режим
|по желанию
|}

==== Объект <code>RdsHighLatencyThresholds</code> ====
Пользовательские пороговые значения для высокой задержки записи/чтения RDS. Если не установлено, используется автоматический режим
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|writeReadLatency
|integer
|Оповещение, если задержка чтения/записи превышает ''X'' миллисекунд в 3 из 5 выборок.
|требуется
|}

==== Объект _ <code>RdsLowStorageDetectionConfig</code> ====
Конфигурация низкого свободного места на диске при обнаружении RDS.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|enabled
|boolean
|Обнаружение включено ( <code>true</code>) или отключено ( <code>false</code>).
|требуется
|-
|customThresholds
|RdsLowStorageThresholds
|Пользовательские пороги для низкого свободного места на RDS. Если не установлено, используется автоматический режим.
|по желанию
|}

==== Объект <code>RdsLowStorageThresholds</code> ====
Пользовательские пороги для низкого свободного места на RDS. Если не установлено, используется автоматический режим.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|freeStoragePercentage
|integer
|Предупреждать, если свободное пространство хранения, разделенное на выделенное хранилище, меньше ''X'' % в 3 из 5 выборок.
|требуется
|}

==== Объект <code>RdsHighMemoryDetectionConfig</code> ====
Конфигурация RDS с обнаружением нехватки памяти.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|enabled
|boolean
|Обнаружение включено ( <code>true</code>) или отключено ( <code>false</code>).
|требуется
|-
|customThresholds
|RdsHighMemoryThresholds
|Пользовательские пороги для RDS, у которых заканчивается память. Если не установлено, используется автоматический режим.

Для срабатывания оповещения должны быть выполнены все условия.
|по желанию
|}

==== Объект <code>RdsHighMemoryThresholds</code> ====
Пользовательские пороги для RDS, у которых заканчивается память. Если не установлено, используется автоматический режим.

Для срабатывания оповещения должны быть выполнены все условия.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|freeMemory
|number
|Свободная память меньше ''X'' мегабайт в 3 из 5 образцов.
|требуется
|-
|swapUsage
|number
|Использование подкачки превышает ''X'' гигабайт в 3 из 5 образцов.
|требуется
|}

==== Объект <code>ElbHighConnectionErrorsDetectionConfig</code> ====
Конфигурация большого количества ошибок соединения с серверной частью при обнаружении ELB.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|enabled
|boolean
|Обнаружение включено ( <code>true</code>) или отключено ( <code>false</code>).
|требуется
|-
|customThresholds
|ElbHighConnectionErrorsThresholds
|Пользовательские пороги для большого количества ошибок соединения с серверной частью на ELB. Если не установлено, используется автоматический режим.
|по желанию
|}

==== Объект <code>ElbHighConnectionErrorsThresholds</code> ====
Пользовательские пороги для большого количества ошибок соединения с серверной частью на ELB. Если не установлено, используется автоматический режим.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|connectionErrorsPerMinute
|integer
|Оповещение, если количество ошибок соединения с серверной частью превышает ''X'' в минуту в 3 из 5 выборок.
|требуется
|}

==== Объект <code>RdsRestartsSequenceDetectionConfig</code> ====
Конфигурация последовательности перезапусков при обнаружении RDS.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|enabled
|boolean
|Обнаружение включено ( <code>true</code>) или отключено ( <code>false</code>).
|требуется
|-
|customThresholds
|RdsRestartsThresholds
|Пользовательские пороги для последовательности перезапусков в RDS. Если не установлено, используется автоматический режим.
|по желанию
|}

==== Объект <code>RdsRestartsThresholds</code> ====
Пользовательские пороги для последовательности перезапусков в RDS. Если не установлено, используется автоматический режим.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|restartsPerMinute
|integer
|Предупреждать, если количество перезапусков ''X'' в минуту или выше в 3 из 20 образцов.
|требуется
|}

==== Объект <code>LambdaHighErrorRateDetectionConfig</code> ====
Конфигурация обнаружения высокой частоты ошибок AWS Lambda.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|enabled
|boolean
|Обнаружение включено ( <code>true</code>) или отключено ( <code>false</code>).
|требуется
|-
|customThresholds
|LambdaHighErrorRateThresholds
|Пользовательские пороговые значения для высокой частоты ошибок AWS Lambda. Если не установлено, используется автоматический режим.
|по желанию
|}

==== Объект <code>LambdaHighErrorRateThresholds</code> ====
Пользовательские пороговые значения для высокой частоты ошибок AWS Lambda. Если не установлено, используется автоматический режим.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|failedInvocationsRate
|integer
|Оповещение, если частота неудачных вызовов превышает ''X'' % в 3 из 5 выборок.
|требуется
|}

==== Объект <code>Ec2CandidateCpuSaturationDetectionConfig</code> ====
Конфигурация высокой загрузки ЦП на EC2 без установленного агента (кандидат на мониторинг). Если null, то эта конфигурация не будет изменена.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|enabled
|boolean
|Обнаружение включено ( <code>true</code>) или отключено ( <code>false</code>).
|требуется
|-
|customThresholds
|Ec2CandidateCpuSaturationThresholds
|Пользовательские пороги высокой загрузки ЦП для кандидата на мониторинг EC2. Если не установлено, используется автоматический режим.
|по желанию
|}

==== Объект <code>Ec2CandidateCpuSaturationThresholds</code> ====
Пользовательские пороги высокой загрузки ЦП для кандидата на мониторинг EC2. Если не установлено, используется автоматический режим.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|cpuUsagePercentage
|integer
|Предупреждать, если загрузка ЦП превышает ''X'' % в 3 из 5 выборок.
|требуется
|}

=== JSON-модель тела запроса ===
Это модель тела запроса, показывающая возможные элементы. Его необходимо настроить для использования в реальном запросе.
<code>{
"metadata": {
"configurationVersions": [
4,
2
],
"clusterVersion": "Mock version"
},
"rdsHighCpuDetection": {
"enabled": true,
"customThresholds": {
"cpuUsagePercentage": 99
}
},
"rdsHighWriteReadLatencyDetection": {
"enabled": true,
"customThresholds": {
"writeReadLatency": 800
}
},
"rdsLowStorageDetection": {
"enabled": true,
"customThresholds": {
"freeStoragePercentage": 7
}
},
"rdsHighMemoryDetection": {
"enabled": true,
"customThresholds": {
"freeMemory": 96.99,
"swapUsage": 5.5
}
},
"elbHighConnectionErrorsDetection": {
"enabled": true,
"customThresholds": {
"connectionErrorsPerMinute": 4
}
},
"rdsRestartsSequenceDetection": {
"enabled": true,
"customThresholds": {
"restartsPerMinute": 3
}
},
"lambdaHighErrorRateDetection": {
"enabled": true,
"customThresholds": {
"failedInvocationsRate": 2
}
},
"ec2CandidateCpuSaturationDetection": {
"enabled": true,
"customThresholds": {
"cpuUsagePercentage": 98
}
}
}</code>

== Ответ ==

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

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

Запрос использует в качестве полезной нагрузки <code>application/json</code> формат.
{| class="wikitable"
| rowspan="2" |POST
|Managed
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/aws/validator</nowiki></code>
|-
|Среда ActiveGate
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/aws/validator</nowiki></code>
|}

=== Аутентификация ===
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Запись конфигурации ( <code>WriteConfig</code>) . Чтобы узнать, как его получить и использовать, см. раздел [[Токены и аутентификация (API)|Токены и аутентификация]] .

=== Ответ ===

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

== Пример ==
В этом примере запрос обновляет конфигурацию обнаружения аномалий для AWS из примера запроса GET . Он переключает высокую загрузку ЦП при обнаружении RDS в режим настраиваемого порога и устанавливает порог 90 %. Он также отключает обнаружение нехватки памяти RDS .

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

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

==== Curl ====
<code>curl -X PUT \
<nowiki>https://mySampleEnv.live.ruscomtech.ru/api/config/v1/anomalyDetection/aws</nowiki> \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
-H 'Content-Type: application/json' \
-d '{
"rdsHighCpuDetection": {
"enabled": true,
"customThresholds": {
"cpuUsagePercentage": 90
}
},
"rdsHighWriteReadLatencyDetection": {
"enabled": true
},
"rdsLowStorageDetection": {
"enabled": true
},
"rdsHighMemoryDetection": {
"enabled": false
},
"elbHighConnectionErrorsDetection": {
"enabled": true
},
"rdsRestartsSequenceDetection": {
"enabled": true
},
"lambdaHighErrorRateDetection": {
"enabled": true
}
}
'</code>

==== URL-адрес запроса ====
<code><nowiki>https://mySampleEnv.live.ruscomtech.ru/api/config/v1/anomalyDetection/aws</nowiki></code>

==== Тело запроса ====
<code>{
"rdsHighCpuDetection": {
"enabled": true,
"customThresholds": {
"cpuUsagePercentage": 90
}
},
"rdsHighWriteReadLatencyDetection": {
"enabled": true
},
"rdsLowStorageDetection": {
"enabled": true
},
"rdsHighMemoryDetection": {
"enabled": false
},
"elbHighConnectionErrorsDetection": {
"enabled": true
},
"rdsRestartsSequenceDetection": {
"enabled": true
},
"lambdaHighErrorRateDetection": {
"enabled": true
}
}</code>

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

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

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

ENetrebin в 16:44, 14 февраля 2023

ENetrebin в 13:58, 27 октября 2022

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