[ aws . autoscaling ]
Получение прогноза масштабирования
Описание
Получает данные прогноза для политики прогнозируемого масштабирования.
Прогнозы нагрузки — это прогнозы значений нагрузки в час, полученные с использованием исторических данных нагрузки из CloudWatch и анализа исторических трендов. Прогнозы емкости представлены как прогнозируемые значения минимальной емкости, необходимой в час, на основе прогноза почасовой нагрузки.
Для создания начальных прогнозов требуется не менее 24 часов данных. Однако наличие полных 14 дней исторических данных приводит к более точным прогнозам.
Дополнительную информацию см. в разделе Прогнозируемое масштабирование для Amazon EC2 Auto Scaling в руководстве пользователя Amazon EC2 Auto Scaling.
См. также: Документация API AWS
Синтаксис
get-predictive-scaling-forecast
--auto-scaling-group-name <value>
--policy-name <value>
--start-time <value>
--end-time <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]
Параметры
--auto-scaling-group-name (строка)
--policy-name (строка)
--start-time (метка времени)
--end-time (метка времени)
Исключительно конечное время диапазона для получения данных прогноза. Максимальная продолжительность времени между начальным и конечным временем составляет 30 дней.
Хотя этот параметр может принимать дату и время, которые находятся более чем за два дня в будущем, доступность данных прогноза ограничена. Amazon EC2 Auto Scaling выдает прогнозы только на периоды в два дня вперед.
--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной JSON-строки. JSON-строка следует формату, указанному в --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения переопределят значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного в JSON, так как строка будет взята буквально. Это может не быть указано вместе с --cli-input-yaml.
--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если предоставлено без значения или значением input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, он выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, оно проверяет входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет нестабилен между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.
Глобальные параметры
--debug (логическое значение)
Включить отладку логов.
--endpoint-url (строка)
Переопределить URL по умолчанию команды заданным URL.
--no-verify-ssl (логическое значение)
По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого подключения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение проверки сертификатов SSL по умолчанию.
--no-paginate (логическое значение)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI будет выполнять только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования вывода команды.
- json
- текст
- таблица
- yaml
- yaml-поток
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определенный профиль из файла учетных данных.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/окружения.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/выключить цветной вывод.
- включить
- выключить
- автоматически
--no-sign-request (логическое значение)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.
--ca-bundle (строка)
Файл сертификатов CA для использования при проверке сертификатов SSL. Переопределяет настройки конфигурации/окружения.
--cli-read-timeout (целое число)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться блокирующим образом и не будет иметь таймаута. Значение по умолчанию — 60 секунд.
--cli-connect-timeout (целое число)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться блокирующим образом и не будет иметь таймаута. Значение по умолчанию — 60 секунд.
--cli-binary-format (строка)
Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде закодированной строкой base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, отображающего двоичный блок, fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла напрямую независимо от настроек cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (логическое значение)
Отключить вывод пейджера CLI.
--cli-auto-prompt (логическое значение)
Автоматически запрашивать параметры CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическое запроса параметров CLI.
Вывод
LoadForecast -> (список)
Прогноз нагрузки.
(структура)
Вызов GetPredictiveScalingForecast возвращает прогноз нагрузки для политики предсказательного масштабирования. Эта структура включает точки данных для этого прогноза нагрузки, вместе со временем этих точек данных и спецификацией метрики.
Timestamps -> (список)
Временные метки для точек данных в формате UTC.
(временная метка)
Values -> (список)
Значения точек данных.
(двойное)
MetricSpecification -> (структура)
Спецификация метрики для прогноза нагрузки.
TargetValue -> (двойное)
Указывает целевую загрузку.
Примечание
Некоторые метрики основаны на подсчете, а не на проценте, например, количество запросов для Application Load Balancer или количество сообщений в очереди SQS. Если политика масштабирования определяет одну из этих метрик, укажите целевую загрузку как оптимальное среднее количество запросов или сообщений на экземпляр в течение любого интервала в одну минуту.PredefinedMetricPairSpecification -> (структура)
Спецификация предварительно определенной пары метрик, из которой Amazon EC2 Auto Scaling определяет подходящую метрику масштабирования и метрику нагрузки.
PredefinedMetricType -> (строка)
ASGCPUUtilization , общая метрика ЦП группы Auto Scaling используется в качестве метрики нагрузки, а средняя метрика ЦП используется для метрики масштабирования.ResourceLabel -> (строка)
Метка, которая однозначно идентифицирует определенную целевую группу Application Load Balancer, из которой можно определить общее и среднее количество запросов, обслуживаемых вашей группой Auto Scaling. Вы не можете указать метку ресурса, если целевая группа не прикреплена к группе Auto Scaling.
Вы создаете метку ресурса, объединяя конечную часть ARN балансировщика нагрузки и конечную часть ARN целевой группы в одно значение, разделенное косой чертой (/). Формат метки ресурса:
app/my-alb/778d41231b141a0f/targetgroup/my-alb-target-group/943f017f100becff .Где:
- app/<load-balancer-name>/<load-balancer-id> — конечная часть ARN балансировщика нагрузки
- targetgroup/<target-group-name>/<target-group-id> — конечная часть ARN целевой группы.
Чтобы найти ARN для Application Load Balancer, используйте операцию API DescribeLoadBalancers. Чтобы найти ARN для целевой группы, используйте операцию API DescribeTargetGroups.
PredefinedScalingMetricSpecification -> (структура)
Спецификация предварительно определенной метрики масштабирования.
PredefinedMetricType -> (строка)
ResourceLabel -> (строка)
Метка, которая однозначно идентифицирует определенную целевую группу Application Load Balancer, из которой можно определить среднее количество запросов, обслуживаемых вашей группой Auto Scaling. Вы не можете указать метку ресурса, если целевая группа не прикреплена к группе Auto Scaling.
Вы создаете метку ресурса, объединяя конечную часть ARN балансировщика нагрузки и конечную часть ARN целевой группы в одно значение, разделенное косой чертой (/). Формат метки ресурса:
app/my-alb/778d41231b141a0f/targetgroup/my-alb-target-group/943f017f100becff .Где:
- app/<load-balancer-name>/<load-balancer-id> — конечная часть ARN балансировщика нагрузки
- targetgroup/<target-group-name>/<target-group-id> — конечная часть ARN целевой группы.
Чтобы найти ARN для Application Load Balancer, используйте операцию API DescribeLoadBalancers. Чтобы найти ARN для целевой группы, используйте операцию API DescribeTargetGroups.
PredefinedLoadMetricSpecification -> (структура)
Спецификация предварительно определенной метрики нагрузки.
PredefinedMetricType -> (строка)
ResourceLabel -> (строка)
Метка, которая однозначно идентифицирует определенную целевую группу Application Load Balancer, из которой можно определить количество запросов, обслуживаемых вашей группой Auto Scaling. Вы не можете указать метку ресурса, если целевая группа не прикреплена к группе Auto Scaling.
Вы создаете метку ресурса, объединяя конечную часть ARN балансировщика нагрузки и конечную часть ARN целевой группы в одно значение, разделенное косой чертой (/). Формат метки ресурса:
app/my-alb/778d41231b141a0f/targetgroup/my-alb-target-group/943f017f100becff .Где:
- app/<load-balancer-name>/<load-balancer-id> — конечная часть ARN балансировщика нагрузки
- targetgroup/<target-group-name>/<target-group-id> — конечная часть ARN целевой группы.
Чтобы найти ARN для Application Load Balancer, используйте операцию API DescribeLoadBalancers. Чтобы найти ARN для целевой группы, используйте операцию API DescribeTargetGroups.
CustomizedScalingMetricSpecification -> (структура)
Спецификация настроенной метрики масштабирования.
MetricDataQueries -> (список)
Одна или несколько запросов данных метрики, которые предоставляют точки данных для метрики масштабирования. Используйте несколько запросов данных метрики только в том случае, если вы выполняете математическое выражение с возвращаемыми данными.
(структура)
Данные метрики для возврата. Также определяет, возвращает ли этот вызов данные только для одной метрики или выполняет ли он математическое выражение со значениями возвращаемых статистических данных метрики для создания новой временной серии. Временная серия — это последовательность точек данных, каждая из которых связана со временной меткой.
Дополнительную информацию и примеры см. в разделе «Расширенные конфигурации политики предсказательного масштабирования с использованием настраиваемых метрик» в Руководстве пользователя Amazon EC2 Auto Scaling.
Id -> (строка)
MetricDataQuery объектов, указанных для одной политики масштабирования. Если вы выполняете математические выражения с этим набором данных, это имя представляет эти данные и может использоваться как переменная в математическом выражении. Допустимые символы — буквы, цифры и символы подчеркивания. Первый символ должен быть строчной буквой.Expression -> (строка)
Математическое выражение для выполнения с возвращаемыми данными, если этот объект выполняет математическое выражение. Это выражение может использовать Id других метрик для ссылки на эти метрики и может также использовать Id других выражений для использования результатов этих выражений.
Условие: В каждом объекте MetricDataQuery вы должны указать либо Expression, либо MetricStat, но не оба.
MetricStat -> (структура)
Информация о данных метрики для возврата.
Условие: В каждом объекте MetricDataQuery вы должны указать либо Expression, либо MetricStat, но не оба.
Metric -> (структура)
Метрика CloudWatch для возврата, включая имя метрики, пространство имен и измерения. Чтобы получить точное имя метрики, пространство имен и измерения, проверьте объект Metric, возвращаемый вызовом ListMetrics.
Namespace -> (строка)
MetricName -> (строка)
Dimensions -> (список)
Измерения для метрики. Список доступных измерений см. в документации Amazon Web Services, доступной из таблицы в службах Amazon Web Services, которые публикуют метрики CloudWatch в Руководстве пользователя Amazon CloudWatch.
Условие: Если вы опубликовали метрику с измерениями, вы должны указать те же измерения в своей политике масштабирования.
(структура)
Описание измерения метрики.
Name -> (строка)
Value -> (строка)
Stat -> (строка)
Статистика для возврата. Она может включать любую статистику CloudWatch или расширенную статистику. Список допустимых значений см. в таблице Статистики в Руководстве пользователя Amazon CloudWatch.
Наиболее часто используемыми метриками для предсказательного масштабирования являются Average и Sum.
Unit -> (строка)
Label -> (строка)
ReturnData -> (логическое)
Указывает, следует ли возвращать временные метки и сырые значения данных этой метрики.
Если вы используете какие-либо математические выражения, укажите true для этого значения только для конечного математического выражения, на котором основана спецификация метрики. Вы должны указать false для ReturnData для всех других метрик и выражений, используемых в спецификации метрики.
Если вы только получаете метрики и не выполняете никаких математических выражений, не указывайте ничего для ReturnData. Это устанавливает значение по умолчанию (true).
CustomizedLoadMetricSpecification -> (структура)
Спецификация настраиваемого метрики загрузки.
MetricDataQueries -> (список)
Одна или несколько запросов к данным метрики для предоставления точек данных для метрики загрузки. Используйте несколько запросов к данным метрики только в том случае, если вы выполняете математическое выражение над возвращаемыми данными.
(структура)
Данные метрики для возврата. Также определяет, возвращает ли этот вызов данные только для одной метрики или выполняет ли он математическое выражение над значениями возвращаемых статистических данных метрики для создания новой временной серии. Временная серия — это ряд точек данных, каждая из которых связана со временной отметкой.
Дополнительную информацию и примеры см. в разделе «Настройка расширенных политик прогнозируемого масштабирования с использованием настраиваемых метрик» в руководстве пользователя Amazon EC2 Auto Scaling.
Id -> (строка)
MetricDataQuery, указанных для одной политики масштабирования. Если вы выполняете математические выражения над этим набором данных, это имя представляет эти данные и может служить переменной в математическом выражении. Допустимые символы — буквы, цифры и символы подчеркивания. Первый символ должен быть строчной буквой.Expression -> (строка)
Математическое выражение, которое выполняется над возвращаемыми данными, если этот объект выполняет математическое выражение. В этом выражении можно использовать Id других метрик для ссылки на эти метрики, а также можно использовать Id других выражений для использования результата этих выражений.
Условие: В каждом объекте MetricDataQuery необходимо указать либо Expression, либо MetricStat, но не оба.
MetricStat -> (структура)
Информация о данных метрики для возврата.
Условие: В каждом объекте MetricDataQuery необходимо указать либо Expression, либо MetricStat, но не оба.
Metric -> (структура)
Метрика CloudWatch для возврата, включая имя метрики, пространство имен и измерения. Чтобы получить точное имя метрики, пространство имен и измерения, проверьте объект Metric, возвращаемый вызовом ListMetrics.
Namespace -> (строка)
MetricName -> (строка)
Dimensions -> (список)
Измерения для метрики. Список доступных измерений см. в документации Amazon Web Services, доступной из таблицы Amazon Web Services services, публикующих метрики CloudWatch в руководстве пользователя Amazon CloudWatch.
Условие: Если вы опубликовали метрику с измерениями, вы должны указать те же измерения в своей политике масштабирования.
(структура)
Описывает измерение метрики.
Name -> (строка)
Value -> (строка)
Stat -> (строка)
Статистика для возврата. Она может включать в себя любую статистику CloudWatch или расширенную статистику. Список допустимых значений см. в таблице «Статистики» в руководстве пользователя Amazon CloudWatch.
Наиболее часто используемые метрики для прогнозируемого масштабирования — Average и Sum.
Unit -> (строка)
Label -> (строка)
ReturnData -> (булево)
Указывает, следует ли возвращать временные метки и исходные значения данных этой метрики.
Если вы используете математические выражения, укажите true для этого значения только для конечного математического выражения, на котором основана спецификация метрики. Для всех других метрик и выражений, используемых в спецификации метрики, необходимо указать false для ReturnData.
Если вы только получаете метрики и не выполняете математические выражения, ничего не указывайте для ReturnData. Это устанавливает его по умолчанию (true).
CustomizedCapacityMetricSpecification -> (структура)
Спецификация настраиваемой метрики емкости.
MetricDataQueries -> (список)
Одна или несколько запросов к данным метрики для предоставления точек данных для метрики емкости. Используйте несколько запросов к данным метрики только в том случае, если вы выполняете математическое выражение над возвращаемыми данными.
(структура)
Данные метрики для возврата. Также определяет, возвращает ли этот вызов данные только для одной метрики или выполняет ли он математическое выражение над значениями возвращаемых статистических данных метрики для создания новой временной серии. Временная серия — это ряд точек данных, каждая из которых связана со временной отметкой.
Дополнительную информацию и примеры см. в разделе «Настройка расширенных политик прогнозируемого масштабирования с использованием настраиваемых метрик» в руководстве пользователя Amazon EC2 Auto Scaling.
Id -> (строка)
MetricDataQuery, указанных для одной политики масштабирования. Если вы выполняете математические выражения над этим набором данных, это имя представляет эти данные и может служить переменной в математическом выражении. Допустимые символы — буквы, цифры и символы подчеркивания. Первый символ должен быть строчной буквой.Expression -> (строка)
Математическое выражение, которое выполняется над возвращаемыми данными, если этот объект выполняет математическое выражение. В этом выражении можно использовать Id других метрик для ссылки на эти метрики, а также можно использовать Id других выражений для использования результата этих выражений.
Условие: В каждом объекте MetricDataQuery необходимо указать либо Expression, либо MetricStat, но не оба.
MetricStat -> (структура)
Информация о данных метрики для возврата.
Условие: В каждом объекте MetricDataQuery необходимо указать либо Expression, либо MetricStat, но не оба.
Metric -> (структура)
Метрика CloudWatch для возврата, включая имя метрики, пространство имен и измерения. Чтобы получить точное имя метрики, пространство имен и измерения, проверьте объект Metric, возвращаемый вызовом ListMetrics.
Namespace -> (строка)
MetricName -> (строка)
Dimensions -> (список)
Измерения для метрики. Список доступных измерений см. в документации Amazon Web Services, доступной из таблицы Amazon Web Services services, публикующих метрики CloudWatch в руководстве пользователя Amazon CloudWatch.
Условие: Если вы опубликовали метрику с измерениями, вы должны указать те же измерения в своей политике масштабирования.
(структура)
Описывает измерение метрики.
Name -> (строка)
Value -> (строка)
Stat -> (строка)
Статистика для возврата. Она может включать в себя любую статистику CloudWatch или расширенную статистику. Список допустимых значений см. в таблице «Статистики» в руководстве пользователя Amazon CloudWatch.
Наиболее часто используемые метрики для прогнозируемого масштабирования — Average и Sum.
Unit -> (строка)
Label -> (строка)
ReturnData -> (булево)
Указывает, следует ли возвращать временные метки и исходные значения данных этой метрики.
Если вы используете математические выражения, укажите true для этого значения только для конечного математического выражения, на котором основана спецификация метрики. Для всех других метрик и выражений, используемых в спецификации метрики, необходимо указать false для ReturnData.
Если вы только получаете метрики и не выполняете математические выражения, ничего не указывайте для ReturnData. Это устанавливает его по умолчанию (true).
CapacityForecast -> (структура)
Прогноз емкости.
Timestamps -> (список)
Временные метки для точек данных в формате UTC.
(временная метка)
Values -> (список)
Значения точек данных.
(двойное)
UpdateTime -> (временная метка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.