get-ec2-instance-recommendations

Описание

Возвращает рекомендации по типам экземпляров Amazon EC2.

Compute Optimizer генерирует рекомендации по типам экземпляров Amazon Elastic Compute Cloud (Amazon EC2), которые соответствуют определенному набору требований. Дополнительную информацию см. в разделе Поддерживаемые ресурсы и требования в Руководстве пользователя Compute Optimizer.

См. также: Документацию API AWS

Синтаксис

  get-ec2-instance-recommendations
[--instance-arns <value>]
[--next-token <value>]
[--max-results <value>]
[--filters <value>]
[--account-ids <value>]
[--recommendation-preferences <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]

Параметры

--instance-arns (список)

Amazon Resource Name (ARN) экземпляров, для которых требуется вернуть рекомендации.

(строка)

Синтаксис:

"string" "string" ...

--next-token (строка)

Токен для перехода к следующей странице рекомендаций по экземплярам.

--max-results (целое число)

Максимальное количество рекомендаций по типам экземпляров, возвращаемых в одном запросе.

Для получения оставшихся результатов отправьте еще один запрос со значением nextToken.

--filters (список)

Массив объектов для задания фильтра, возвращающего более точный список рекомендаций по типам экземпляров.

(структура)

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

Вы можете использовать EBSFilter с действием GetEBSVolumeRecommendations, LambdaFunctionRecommendationFilter с действием GetLambdaFunctionRecommendations и JobFilter с действием DescribeRecommendationExportJobs.

name -> (строка)

Имя фильтра.

Укажите Finding, чтобы получить рекомендации с определенной классификацией вывода. Например, Underprovisioned.

Укажите RecommendationSourceType, чтобы получить рекомендации определенного типа ресурса. Например, Ec2Instance.

Укажите FindingReasonCodes, чтобы получить рекомендации с определенным кодом причины вывода. Например, CPUUnderprovisioned.

Укажите InferredWorkloadTypes, чтобы получить рекомендации определенной выявленной рабочей нагрузки. Например, Redis.

Вы можете отфильтровать рекомендации по экземплярам EC2 по меткам tag:key и tag-key.

tag:key — это комбинация ключа и значения метки, назначенной вашим рекомендациям. Используйте ключ метки в имени фильтра и значение метки в качестве значения фильтра. Например, чтобы найти все рекомендации, имеющие метку с ключом Owner и значением TeamA, укажите tag:Owner в качестве имени фильтра и TeamA в качестве значения фильтра.

tag-key — это ключ метки, назначенной вашим рекомендациям. Используйте этот фильтр, чтобы найти все ваши рекомендации, имеющие метку с определенным ключом. Это не учитывает значение метки. Например, вы можете найти свои рекомендации с ключом метки Owner или без назначенных ключей меток.

values -> (список)

Значение фильтра.

Допустимые значения для этого параметра зависят от того, что вы указали для параметра name и типа ресурса, для которого вы хотите отфильтровать результаты:

Укажите Optimized или NotOptimized, если вы указали параметр name как Finding и хотите отфильтровать результаты для групп Auto Scaling.
Укажите Underprovisioned, Overprovisioned или Optimized, если вы указали параметр name как Finding и хотите отфильтровать результаты для экземпляров EC2.
Укажите Ec2Instance или AutoScalingGroup, если вы указали параметр name как RecommendationSourceType.
Укажите один из следующих вариантов, если вы указали параметр name как FindingReasonCodes:
- **CPUOverprovisioned ** — Конфигурация процессора экземпляра может быть уменьшена, при этом удовлетворяя требованиям производительности вашей рабочей нагрузки.
- **CPUUnderprovisioned ** — Конфигурация процессора экземпляра не соответствует требованиям производительности вашей рабочей нагрузки, и существует альтернативный тип экземпляра, обеспечивающий лучшую производительность процессора.
- **MemoryOverprovisioned ** — Конфигурация памяти экземпляра может быть уменьшена, при этом удовлетворяя требованиям производительности вашей рабочей нагрузки.
- **MemoryUnderprovisioned ** — Конфигурация памяти экземпляра не соответствует требованиям производительности вашей рабочей нагрузки, и существует альтернативный тип экземпляра, обеспечивающий лучшую производительность памяти.
- **EBSThroughputOverprovisioned ** — Конфигурация пропускной способности EBS экземпляра может быть уменьшена, при этом удовлетворяя требованиям производительности вашей рабочей нагрузки.
- **EBSThroughputUnderprovisioned ** — Конфигурация пропускной способности EBS экземпляра не соответствует требованиям производительности вашей рабочей нагрузки, и существует альтернативный тип экземпляра, обеспечивающий лучшую производительность пропускной способности EBS.
- **EBSIOPSOverprovisioned ** — Конфигурация IOPS EBS экземпляра может быть уменьшена, при этом удовлетворяя требованиям производительности вашей рабочей нагрузки.
- **EBSIOPSUnderprovisioned ** — Конфигурация IOPS EBS экземпляра не соответствует требованиям производительности вашей рабочей нагрузки, и существует альтернативный тип экземпляра, обеспечивающий лучшую производительность IOPS EBS.
- **NetworkBandwidthOverprovisioned ** — Конфигурация пропускной способности сети экземпляра может быть уменьшена, при этом удовлетворяя требованиям производительности вашей рабочей нагрузки.
- **NetworkBandwidthUnderprovisioned ** — Конфигурация пропускной способности сети экземпляра не соответствует требованиям производительности вашей рабочей нагрузки, и существует альтернативный тип экземпляра, обеспечивающий лучшую производительность пропускной способности сети. Этот вывод происходит, когда производительность NetworkIn или NetworkOut экземпляра снижается.
- **NetworkPPSOverprovisioned ** — Конфигурация PPS сети (пакетов в секунду) экземпляра может быть уменьшена, при этом удовлетворяя требованиям производительности вашей рабочей нагрузки.
- **NetworkPPSUnderprovisioned ** — Конфигурация PPS сети (пакетов в секунду) экземпляра не соответствует требованиям производительности вашей рабочей нагрузки, и существует альтернативный тип экземпляра, обеспечивающий лучшую производительность PPS сети.
- **DiskIOPSOverprovisioned ** — Конфигурация IOPS диска экземпляра может быть уменьшена, при этом удовлетворяя требованиям производительности вашей рабочей нагрузки.
- **DiskIOPSUnderprovisioned ** — Конфигурация IOPS диска экземпляра не соответствует требованиям производительности вашей рабочей нагрузки, и существует альтернативный тип экземпляра, обеспечивающий лучшую производительность IOPS диска.
- **DiskThroughputOverprovisioned ** — Конфигурация пропускной способности диска экземпляра может быть уменьшена, при этом удовлетворяя требованиям производительности вашей рабочей нагрузки.
- **DiskThroughputUnderprovisioned ** — Конфигурация пропускной способности диска экземпляра не соответствует требованиям производительности вашей рабочей нагрузки, и существует альтернативный тип экземпляра, обеспечивающий лучшую производительность пропускной способности диска.

(строка)

Сокращенный синтаксис:

name=string,values=string,string ...

Синтаксис JSON:

[
  {
    "name": "Finding"|"FindingReasonCodes"|"RecommendationSourceType"|"InferredWorkloadTypes",
    "values": ["string", ...]
  }
  ...
]

--account-ids (список)

ID учетной записи Amazon Web Services, для которой требуется вернуть рекомендации по типам экземпляров.

Если ваша учетная запись является учетной записью управления организацией, используйте этот параметр для указания учетной записи участника, для которой вы хотите вернуть рекомендации по типам экземпляров.

В одном запросе можно указать только один идентификатор учетной записи.

(строка)

Синтаксис:

"string" "string" ...

--recommendation-preferences (структура)

Объект для задания параметров для рекомендаций по типам экземпляров Amazon EC2, которые должны быть возвращены в ответе.

cpuVendorArchitectures -> (список)

Указывает производителя процессора и архитектуру для рекомендаций по типам экземпляров Amazon EC2 и групп Auto Scaling.

Например, при указании AWS_ARM64 с:

Запросом GetEC2InstanceRecommendations или GetAutoScalingGroupRecommendations, Compute Optimizer возвращает рекомендации, содержащие только типы экземпляров Graviton.
Запросом GetEC2RecommendationProjectedMetrics, Compute Optimizer возвращает прогнозируемые показатели использования только для рекомендаций типов экземпляров Graviton.
Запросом ExportEC2InstanceRecommendations или ExportAutoScalingGroupRecommendations, Compute Optimizer экспортирует рекомендации, содержащие только типы экземпляров Graviton.

(строка)

Сокращенный синтаксис:

cpuVendorArchitectures=string,string

Синтаксис JSON:

{
  "cpuVendorArchitectures": ["AWS_ARM64"|"CURRENT", ...]
}

--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 (boolean)

Включить отладку регистрации.

--endpoint-url (string)

Переопределить URL по умолчанию команды заданным URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение по умолчанию проверки SSL-сертификатов.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования вывода команды.

json
text
table
yaml
yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

Использовать определенный профиль из файла учетных данных.

--region (string)

Регион для использования. Переопределяет настройки из конфигурации/окружения.

--version (string)

Показать версию этого инструмента.

--color (string)

Включить/выключить цветной вывод.

on
off
auto

--no-sign-request (boolean)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (string)

Файл с набором CA-сертификатов для проверки SSL-сертификатов. Переопределяет настройки из конфигурации/окружения.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (string)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI версии 1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, соответствующего двоичному блоку fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла напрямую независимо от настроек cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.

base64
raw-in-base64-out

--no-cli-pager (boolean)

Отключить кли-пейджер для вывода.

--cli-auto-prompt (boolean)

Автоматически запрашивать параметры ввода для CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматическую запрос параметров ввода для CLI.

Вывод

nextToken -> (string)

Токен для перехода на следующую страницу рекомендаций по экземплярам.

Это значение равно null, если больше нет страниц рекомендаций по экземплярам для возврата.

instanceRecommendations -> (list)

Массив объектов, описывающих рекомендации по экземплярам.

(structure)

Описывает рекомендацию по экземпляру Amazon EC2.

instanceArn -> (string)

Amazon Resource Name (ARN) текущего экземпляра.

accountId -> (string)

Идентификатор учетной записи Amazon Web Services экземпляра.

instanceName -> (string)

Имя текущего экземпляра.

currentInstanceType -> (string)

Тип экземпляра текущего экземпляра.

finding -> (string)

Классификация вывода экземпляра.

Выводы для экземпляров включают:

**Underprovisioned ** —Экземпляр считается недообеспеченным, если хотя бы одна спецификация вашего экземпляра, такая как ЦП, память или сеть, не соответствует требованиям к производительности вашей рабочей нагрузки. Недоообеспеченные экземпляры могут привести к ухудшению производительности приложений.
**Overprovisioned ** —Экземпляр считается избыточно предоставленным, если хотя бы одна спецификация вашего экземпляра, такая как ЦП, память или сеть, может быть уменьшена в размере, при этом по-прежнему соответствуя требованиям к производительности вашей рабочей нагрузки, и ни одна спецификация не является недообеспеченной. Избыточно предоставленные экземпляры могут привести к ненужным затратам на инфраструктуру.
**Optimized ** —Экземпляр считается оптимизированным, когда все спецификации вашего экземпляра, такие как ЦП, память и сеть, соответствуют требованиям к производительности вашей рабочей нагрузки и не являются избыточно предоставленными. Для оптимизированных ресурсов Compute Optimizer может рекомендовать тип экземпляра нового поколения.

Примечание

Допустимые значения в ваших ответах API отображаются как OVER_PROVISIONED, UNDER_PROVISIONED или OPTIMIZED.

findingReasonCodes -> (list)

Причина классификации вывода экземпляра.

Коды причин для экземпляров включают:

**CPUOverprovisioned ** — Конфигурацию ЦП экземпляра можно уменьшить, по-прежнему соответствуя требованиям к производительности вашей рабочей нагрузки. Это определяется путем анализа метрики CPUUtilization текущего экземпляра в течение периода анализа.
**CPUUnderprovisioned ** — Конфигурация ЦП экземпляра не соответствует требованиям к производительности вашей рабочей нагрузки, и существует альтернативный тип экземпляра, который обеспечивает лучшую производительность ЦП. Это определяется путем анализа метрики CPUUtilization текущего экземпляра в течение периода анализа.
**MemoryOverprovisioned ** — Конфигурацию памяти экземпляра можно уменьшить, по-прежнему соответствуя требованиям к производительности вашей рабочей нагрузки. Это определяется путем анализа метрики использования памяти текущего экземпляра в течение периода анализа.
**MemoryUnderprovisioned ** — Конфигурация памяти экземпляра не соответствует требованиям к производительности вашей рабочей нагрузки, и существует альтернативный тип экземпляра, который обеспечивает лучшую производительность памяти. Это определяется путем анализа метрики использования памяти текущего экземпляра в течение периода анализа.

Примечание

Использование памяти анализируется только для ресурсов, на которых установлен единый агент CloudWatch. Дополнительную информацию см. в разделе Включение использования памяти с помощью Amazon CloudWatch Agent в Руководстве пользователя Compute Optimizer . В экземплярах Linux Compute Optimizer анализирует метрику mem_used_percent в пространстве имен CWAgent или устаревшую метрику MemoryUtilization в пространстве имен System/Linux. В экземплярах Windows Compute Optimizer анализирует метрику Memory % Committed Bytes In Use в пространстве имен CWAgent.

**EBSThroughputOverprovisioned ** — Конфигурацию пропускной способности EBS экземпляра можно уменьшить, по-прежнему соответствуя требованиям к производительности вашей рабочей нагрузки. Это определяется путем анализа метрик VolumeReadBytes и VolumeWriteBytes томов EBS, прикрепленных к текущему экземпляру, в течение периода анализа.
**EBSThroughputUnderprovisioned ** — Конфигурация пропускной способности EBS экземпляра не соответствует требованиям к производительности вашей рабочей нагрузки, и существует альтернативный тип экземпляра, который обеспечивает лучшую производительность пропускной способности EBS. Это определяется путем анализа метрик VolumeReadBytes и VolumeWriteBytes томов EBS, прикрепленных к текущему экземпляру, в течение периода анализа.
**EBSIOPSOverprovisioned ** — Конфигурацию IOPS EBS экземпляра можно уменьшить, по-прежнему соответствуя требованиям к производительности вашей рабочей нагрузки. Это определяется путем анализа метрики VolumeReadOps и VolumeWriteOps томов EBS, прикрепленных к текущему экземпляру, в течение периода анализа.
**EBSIOPSUnderprovisioned ** — Конфигурация IOPS EBS экземпляра не соответствует требованиям к производительности вашей рабочей нагрузки, и существует альтернативный тип экземпляра, который обеспечивает лучшую производительность IOPS EBS. Это определяется путем анализа метрик VolumeReadOps и VolumeWriteOps томов EBS, прикрепленных к текущему экземпляру, в течение периода анализа.
**NetworkBandwidthOverprovisioned ** — Конфигурацию пропускной способности сети экземпляра можно уменьшить, по-прежнему соответствуя требованиям к производительности вашей рабочей нагрузки. Это определяется путем анализа метрик NetworkIn и NetworkOut текущего экземпляра в течение периода анализа.
**NetworkBandwidthUnderprovisioned ** — Конфигурация пропускной способности сети экземпляра не соответствует требованиям к производительности вашей рабочей нагрузки, и существует альтернативный тип экземпляра, который обеспечивает лучшую производительность пропускной способности сети. Это определяется путем анализа метрик NetworkIn и NetworkOut текущего экземпляра в течение периода анализа. Эта причина поиска возникает, когда на производительность NetworkIn или NetworkOut экземпляра оказывается влияние.
**NetworkPPSOverprovisioned ** — Конфигурацию PPS (пакетов в секунду) сети экземпляра можно уменьшить, по-прежнему соответствуя требованиям к производительности вашей рабочей нагрузки. Это определяется путем анализа метрик NetworkPacketsIn и NetworkPacketsIn текущего экземпляра в течение периода анализа.
**NetworkPPSUnderprovisioned ** — Конфигурация PPS (пакетов в секунду) сети экземпляра не соответствует требованиям к производительности вашей рабочей нагрузки, и существует альтернативный тип экземпляра, который обеспечивает лучшую производительность PPS сети. Это определяется путем анализа метрик NetworkPacketsIn и NetworkPacketsIn текущего экземпляра в течение периода анализа.
**DiskIOPSOverprovisioned ** — Конфигурацию IOPS диска экземпляра можно уменьшить, по-прежнему соответствуя требованиям к производительности вашей рабочей нагрузки. Это определяется путем анализа метрик DiskReadOps и DiskWriteOps текущего экземпляра в течение периода анализа.
**DiskIOPSUnderprovisioned ** — Конфигурация IOPS диска экземпляра не соответствует требованиям к производительности вашей рабочей нагрузки, и существует альтернативный тип экземпляра, который обеспечивает лучшую производительность IOPS диска. Это определяется путем анализа метрик DiskReadOps и DiskWriteOps текущего экземпляра в течение периода анализа.
**DiskThroughputOverprovisioned ** — Конфигурацию пропускной способности диска экземпляра можно уменьшить, по-прежнему соответствуя требованиям к производительности вашей рабочей нагрузки. Это определяется путем анализа метрик DiskReadBytes и DiskWriteBytes текущего экземпляра в течение периода анализа.
**DiskThroughputUnderprovisioned ** — Конфигурация пропускной способности диска экземпляра не соответствует требованиям к производительности вашей рабочей нагрузки, и существует альтернативный тип экземпляра, который обеспечивает лучшую производительность пропускной способности диска. Это определяется путем анализа метрик DiskReadBytes и DiskWriteBytes текущего экземпляра в течение периода анализа.

Примечание

Дополнительную информацию о метриках экземпляра см. в разделе List the available CloudWatch metrics for your instances в Руководстве пользователя Amazon Elastic Compute Cloud . Дополнительную информацию о метриках тома EBS см. в разделе Amazon CloudWatch metrics for Amazon EBS в Руководстве пользователя Amazon Elastic Compute Cloud .

(string)

utilizationMetrics -> (list)

Массив объектов, описывающих метрики использования экземпляра.

(структура)

Описывает метрику использования ресурса, такого как экземпляр Amazon EC2.

Сравните данные метрики использования вашего ресурса с прогнозируемыми данными метрики использования, чтобы определить разницу в производительности между вашим текущим ресурсом и рекомендуемым вариантом.

name -> (строка)

Название метрики использования.

Доступны следующие метрики использования:

Cpu - Процент выделенных вычислительных единиц EC2, которые в настоящее время используются на экземпляре. Эта метрика определяет вычислительную мощность, необходимую для запуска приложения на экземпляре. В зависимости от типа экземпляра инструменты вашей операционной системы могут показывать меньший процент, чем CloudWatch, когда экземпляру не выделен полный процессорный ядро. Единицы: Процент
Memory - Процент памяти, который в настоящее время используется на экземпляре. Эта метрика определяет объем памяти, необходимый для запуска приложения на экземпляре. Единицы: Процент

Примечание

Метрика Memory возвращается только для ресурсов, на которых установлен унифицированный агент CloudWatch. Дополнительная информация приведена в разделе Включение метрики использования памяти с помощью агента CloudWatch.

GPU - Процент выделенных GPU, которые в настоящее время работают на экземпляре.
GPU_MEMORY - Процент всей памяти GPU, которая в настоящее время работает на экземпляре.

Примечание

Метрики GPU и GPU_MEMORY возвращаются только для ресурсов с установленным унифицированным агентом CloudWatch. Дополнительная информация приведена в разделе Включение использования NVIDIA GPU с помощью агента CloudWatch.

EBS_READ_OPS_PER_SECOND - Завершенные операции чтения со всех подключенных к экземпляру томов EBS за указанный период времени. Единица: Количество
EBS_WRITE_OPS_PER_SECOND - Завершенные операции записи на все тома EBS, подключенные к экземпляру, за указанный период времени. Единица: Количество
EBS_READ_BYTES_PER_SECOND - Объем байтов, прочитанных со всех подключенных к экземпляру томов EBS за указанный период времени. Единица: Байты
EBS_WRITE_BYTES_PER_SECOND - Объем байтов, записанных на все тома EBS, подключенные к экземпляру, за указанный период времени. Единица: Байты
DISK_READ_OPS_PER_SECOND - Завершенные операции чтения со всех доступных томов хранилища экземпляра за указанный период времени. Если томов хранилища экземпляра нет, значение равно 0 или метрика не сообщается.
DISK_WRITE_OPS_PER_SECOND - Завершенные операции записи с всех доступных томов хранилища экземпляра за указанный период времени. Если томов хранилища экземпляра нет, значение равно 0 или метрика не сообщается.
DISK_READ_BYTES_PER_SECOND - Объем байтов, прочитанных со всех доступных томов хранилища экземпляра. Эта метрика используется для определения объема данных, считываемых приложением с диска экземпляра. Это может использоваться для определения скорости приложения. Если томов хранилища экземпляра нет, значение равно 0 или метрика не сообщается.
DISK_WRITE_BYTES_PER_SECOND - Объем байтов, записанных на все доступные тома хранилища экземпляра. Эта метрика используется для определения объема данных, записываемых приложением на диск экземпляра. Это может использоваться для определения скорости приложения. Если томов хранилища экземпляра нет, значение равно 0 или метрика не сообщается.
NETWORK_IN_BYTES_PER_SECOND - Количество байтов, полученных экземпляром по всем сетевым интерфейсам. Эта метрика определяет объем входящего сетевого трафика для одного экземпляра.
NETWORK_OUT_BYTES_PER_SECOND - Количество байтов, отправленных экземпляром по всем сетевым интерфейсам. Эта метрика определяет объем исходящего сетевого трафика с одного экземпляра.
NETWORK_PACKETS_IN_PER_SECOND - Количество пакетов, полученных экземпляром по всем сетевым интерфейсам. Эта метрика определяет объем входящего трафика в терминах количества пакетов на одном экземпляре.
NETWORK_PACKETS_OUT_PER_SECOND - Количество пакетов, отправленных экземпляром по всем сетевым интерфейсам. Эта метрика определяет объем исходящего трафика в терминах количества пакетов на одном экземпляре.

statistic -> (строка)

Статистика метрики использования.

API, командная строка (CLI) и SDK Compute Optimizer возвращают метрики использования, используя только статистику Maximum, которая является максимальным значением, наблюдаемым за указанный период.

Консоль Compute Optimizer отображает графики для некоторых метрик использования, используя статистику Average, которая является значением Sum / SampleCount за указанный период. Дополнительную информацию см. в руководстве пользователя Compute Optimizer. Вы также можете получить усредненные данные метрик использования ваших ресурсов с помощью Amazon CloudWatch. Дополнительную информацию см. в руководстве пользователя Amazon CloudWatch.

value -> (двойное)

Значение метрики использования.

lookBackPeriodInDays -> (двойное)

Количество дней, в течение которых анализировались метрики использования экземпляра.

recommendationOptions -> (список)

Массив объектов, описывающих варианты рекомендаций для экземпляра.

(структура)

Описывает вариант рекомендации для экземпляра Amazon EC2.

instanceType -> (строка)

Тип экземпляра для рекомендации экземпляра.

instanceGpuInfo -> (структура)

Описывает настройки ускорителей GPU для рекомендуемого типа экземпляра.

gpus -> (список)

Описывает ускорители GPU для типа экземпляра.

(структура)

Описывает ускорители GPU для типа экземпляра.

gpuCount -> (целое число)

Количество GPU для типа экземпляра.

gpuMemorySizeInMiB -> (целое число)

Общий размер памяти для ускорителей GPU для типа экземпляра в MiB.

projectedUtilizationMetrics -> (список)

Массив объектов, описывающих прогнозируемые метрики использования для варианта рекомендации экземпляра.

Примечание

Метрики Cpu и Memory — это единственные прогнозируемые метрики использования, которые возвращаются. Кроме того, метрика Memory возвращается только для ресурсов, на которых установлен объединённый агент CloudWatch. Для получения дополнительной информации см. Раздел Включение метрики использования памяти с помощью агента CloudWatch .

(структура)

Описывает метрику использования ресурса, такого как экземпляр Amazon EC2.

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

name -> (строка)

Имя метрики использования.

Доступны следующие метрики использования:

Cpu — Процент выделенных вычислительных единиц EC2, которые в настоящее время используются на экземпляре. Эта метрика определяет вычислительную мощность, необходимую для запуска приложения на экземпляре. В зависимости от типа экземпляра инструменты в вашей операционной системе могут показывать меньший процент, чем CloudWatch, когда экземпляру не выделен полный процессорный ядро. Единицы: Процент
Memory — Процент памяти, который в настоящее время используется на экземпляре. Эта метрика определяет объем памяти, необходимый для запуска приложения на экземпляре. Единицы: Процент

Примечание

Метрика Memory возвращается только для ресурсов, на которых установлен объединённый агент CloudWatch. Для получения дополнительной информации см. Раздел Включение метрики использования памяти с помощью агента CloudWatch .

GPU — Процент выделенных GPU, которые в настоящее время работают на экземпляре.
GPU_MEMORY — Процент общей памяти GPU, которая в настоящее время работает на экземпляре.

Примечание

Метрики GPU и GPU_MEMORY возвращаются только для ресурсов с установленным объединённым агентом CloudWatch. Для получения дополнительной информации см. Раздел Включение метрики использования NVIDIA GPU с помощью агента CloudWatch .

EBS_READ_OPS_PER_SECOND — Завершенные операции чтения со всех подключенных к экземпляру томов EBS за указанный период времени. Единица: Счёт
EBS_WRITE_OPS_PER_SECOND — Завершенные операции записи на все тома EBS, подключенные к экземпляру, за указанный период времени. Единица: Счёт
EBS_READ_BYTES_PER_SECOND — Байт, прочитанных со всех подключенных к экземпляру томов EBS за указанный период времени. Единица: Байты
EBS_WRITE_BYTES_PER_SECOND — Байт, записанных на все тома EBS, подключенные к экземпляру, за указанный период времени. Единица: Байты
DISK_READ_OPS_PER_SECOND — Завершенные операции чтения со всех томов локального хранилища, доступных экземпляру, за указанный период времени. Если томов локального хранилища нет, значение равно 0, или метрика не сообщается.
DISK_WRITE_OPS_PER_SECOND — Завершенные операции записи со всех томов локального хранилища, доступных экземпляру, за указанный период времени. Если томов локального хранилища нет, значение равно 0, или метрика не сообщается.
DISK_READ_BYTES_PER_SECOND — Байт, прочитанных со всех томов локального хранилища, доступных экземпляру. Эта метрика используется для определения объема данных, которые приложение считывает с диска экземпляра. Это может использоваться для определения скорости приложения. Если томов локального хранилища нет, значение равно 0, или метрика не сообщается.
DISK_WRITE_BYTES_PER_SECOND — Байт, записанных на все тома локального хранилища, доступные экземпляру. Эта метрика используется для определения объема данных, которые приложение записывает на диск экземпляра. Это может использоваться для определения скорости приложения. Если томов локального хранилища нет, значение равно 0, или метрика не сообщается.
NETWORK_IN_BYTES_PER_SECOND — Количество байт, полученных экземпляром по всем сетевым интерфейсам. Эта метрика определяет объём входящего сетевого трафика на один экземпляр.
NETWORK_OUT_BYTES_PER_SECOND — Количество байт, отправленных экземпляром по всем сетевым интерфейсам. Эта метрика определяет объём исходящего сетевого трафика с одного экземпляра.
NETWORK_PACKETS_IN_PER_SECOND — Количество пакетов, полученных экземпляром по всем сетевым интерфейсам. Эта метрика определяет объём входящего трафика в терминах количества пакетов на одном экземпляре.
NETWORK_PACKETS_OUT_PER_SECOND — Количество пакетов, отправленных экземпляром по всем сетевым интерфейсам. Эта метрика определяет объём исходящего трафика в терминах количества пакетов на одном экземпляре.

statistic -> (строка)

Статистика метрики использования.

API Compute Optimizer, командная строка (CLI) и SDK возвращают метрики использования, используя только статистику Maximum, которая представляет собой наибольшее значение, наблюдаемое в течение указанного периода.

Консоль Compute Optimizer отображает графики для некоторых метрик использования, используя статистику Average, которая представляет собой значение Sum / SampleCount в течение указанного периода. Для получения дополнительной информации см. раздел Просмотр рекомендаций по ресурсам в Руководстве пользователя Compute Optimizer . Вы также можете получить усредненные данные метрик использования для своих ресурсов с помощью Amazon CloudWatch. Для получения дополнительной информации см. Руководство пользователя Amazon CloudWatch .

value -> (двойное число)

Значение метрики использования.

platformDifferences -> (список)

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

Различия в платформах включают:

**Hypervisor ** — Гипервизор рекомендуемого типа экземпляра отличается от гипервизора текущего экземпляра. Например, рекомендуемый тип экземпляра использует гипервизор Nitro, а текущий экземпляр — Xen. Различия, которые необходимо учитывать между этими гипервизорами, описаны в разделе Гипервизор Nitro в часто задаваемых вопросах Amazon EC2. Для получения дополнительной информации см. Экземпляры, созданные на основе системы Nitro в Руководстве пользователя Amazon EC2 для Linux или Экземпляры, созданные на основе системы Nitro в Руководстве пользователя Amazon EC2 для Windows .
**NetworkInterface ** — Сетевой интерфейс рекомендуемого типа экземпляра отличается от сетевого интерфейса текущего экземпляра. Например, рекомендуемый тип экземпляра поддерживает расширенную сеть, а текущий экземпляр может ее не поддерживать. Чтобы включить расширенную сеть для рекомендуемого типа экземпляра, необходимо установить драйвер Elastic Network Adapter (ENA) или драйвер Intel 82599 Virtual Function. Для получения дополнительной информации см. Сетевые и хранилищные функции и Расширенная сеть в Linux в Руководстве пользователя Amazon EC2 для Linux или Сетевые и хранилищные функции и Расширенная сеть в Windows в Руководстве пользователя Amazon EC2 для Windows .
**StorageInterface ** — Интерфейс хранения рекомендуемого типа экземпляра отличается от интерфейса хранения текущего экземпляра. Например, рекомендуемый тип экземпляра использует интерфейс хранения NVMe, а текущий экземпляр — нет. Для доступа к томам NVMe для рекомендуемого типа экземпляра потребуется установить или обновить драйвер NVMe. Для получения дополнительной информации см. Сетевые и хранилищные функции и Amazon EBS и NVMe на экземплярах Linux в Руководстве пользователя Amazon EC2 для Linux или Сетевые и хранилищные функции и Amazon EBS и NVMe на экземплярах Windows в Руководстве пользователя Amazon EC2 для Windows .
**InstanceStoreAvailability ** — Рекомендуемый тип экземпляра не поддерживает тома локального хранилища, а текущий экземпляр — поддерживает. Перед миграцией может потребоваться создать резервную копию данных на томах локального хранилища, если вы хотите сохранить их. Для получения дополнительной информации см. Как создать резервную копию тома локального хранилища на экземпляре Amazon EC2 в Amazon EBS? в Базе знаний службы поддержки Amazon Web Services Premium . Для получения дополнительной информации см. Сетевые и хранилищные функции и Тома локального хранилища Amazon EC2 в Руководстве пользователя Amazon EC2 для Linux или Сетевые и хранилищные функции и Тома локального хранилища Amazon EC2 в Руководстве пользователя Amazon EC2 для Windows .
**VirtualizationType ** — Рекомендуемый тип экземпляра использует тип виртуализации аппаратной виртуальной машины (HVM), а текущий экземпляр — тип виртуализации парвиртуальной машины (PV). Для получения дополнительной информации о различиях между этими типами виртуализации см. Типы виртуализации AMI Linux в Руководстве пользователя Amazon EC2 для Linux или Типы виртуализации AMI Windows в Руководстве пользователя Amazon EC2 для Windows .
**Architecture ** — Архитектура процессора между рекомендуемым типом экземпляра и текущим экземпляром отличается. Например, рекомендуемый тип экземпляра может использовать архитектуру процессора Arm, а текущий тип экземпляра — другую, например x86. Перед миграцией следует рассмотреть вопрос о перекомпиляции программного обеспечения на вашем экземпляре для новой архитектуры. В качестве альтернативы можно переключиться на Amazon Machine Image (AMI), поддерживающую новую архитектуру. Для получения дополнительной информации об архитектуре процессора для каждого типа экземпляра см. Типы экземпляров Amazon EC2 .

(строка)

performanceRisk -> (двойное число)

Риск производительности при рекомендации типа экземпляра.

Риск производительности указывает на вероятность того, что рекомендованный тип экземпляра не удовлетворит потребности вашей рабочей нагрузки в ресурсах. Compute Optimizer вычисляет индивидуальный балл риска производительности для каждой спецификации рекомендованного экземпляра, включая процессор, память, пропускную способность EBS, IOPS EBS, пропускную способность диска, IOPS диска, пропускную способность сети и PPS сети. Риск производительности рекомендованного экземпляра рассчитывается как максимальный балл риска производительности по всем анализируемым характеристикам ресурсов.

Значение варьируется от 0 до 4, причём 0 означает, что рекомендованный ресурс, по прогнозу, всегда будет предоставлять достаточную вычислительную мощность. Чем выше риск производительности, тем больше вероятность того, что вам следует проверить, соответствует ли рекомендация требованиям производительности вашей рабочей нагрузки перед миграцией ресурса.

rank -> (целое число)

Ранг рекомендации типа экземпляра.

Лучшая рекомендация имеет ранг 1.

savingsOpportunity -> (структура)

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

savingsOpportunityPercentage -> (двойное)

Прогнозируемая ежемесячная экономия в процентах от ежемесячных затрат при принятии рекомендаций Compute Optimizer для данного ресурса.

estimatedMonthlySavings -> (структура)

Объект, описывающий прогнозируемое значение экономии в месяц, возможную при принятии рекомендаций Compute Optimizer для данного ресурса. Это основано на ценах на экземпляры по требованию.

currency -> (строка)

Валюта прогнозируемой ежемесячной экономии.

value -> (двойное)

Значение прогнозируемой ежемесячной экономии.

savingsOpportunityAfterDiscounts -> (структура)

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

savingsOpportunityPercentage -> (двойное)

Прогнозируемая ежемесячная экономия в процентах от ежемесячных затрат после применения скидок по планам экономии и резервированным экземплярам. Эту экономию можно получить, приняв рекомендации Compute Optimizer по экземплярам EC2.

estimatedMonthlySavings -> (структура)

Объект, описывающий прогнозируемое значение экономии в месяц, возможную при принятии рекомендаций Compute Optimizer по экземплярам Amazon EC2. Это основано на ценах после применения скидок по планам экономии и резервированным экземплярам.

currency -> (строка)

Валюта прогнозируемой ежемесячной экономии.

value -> (двойное)

Значение прогнозируемой ежемесячной экономии.

migrationEffort -> (строка)

Уровень усилий, необходимый для миграции с текущего типа экземпляра на рекомендованный тип экземпляра.

Например, усилия по миграции составляют Low, если предполагаемый тип рабочей нагрузки — Amazon EMR, а рекомендованный тип экземпляра — тип экземпляра Amazon Web Services Graviton. Усилия по миграции составляют Medium, если тип рабочей нагрузки не может быть определён, но рекомендованный тип экземпляра — тип экземпляра Amazon Web Services Graviton. Усилия по миграции составляют VeryLow, если текущий и рекомендованный типы экземпляров имеют одинаковую архитектуру процессора.

recommendationSources -> (список)

Массив объектов, описывающих исходный ресурс рекомендации.

(структура)

Описание источника рекомендации, такого как экземпляр Amazon EC2 или группа Auto Scaling.

recommendationSourceArn -> (строка)

Amazon Resource Name (ARN) источника рекомендации.

recommendationSourceType -> (строка)

Тип ресурса источника рекомендации.

lastRefreshTimestamp -> (метка времени)

Метка времени последнего обновления рекомендации по экземплярам.

currentPerformanceRisk -> (строка)

Риск того, что текущий экземпляр не сможет удовлетворить потребности рабочих нагрузок в производительности. Чем выше риск, тем больше вероятность того, что текущий экземпляр не сможет удовлетворить требованиям производительности рабочей нагрузки.

effectiveRecommendationPreferences -> (структура)

Объект, описывающий эффективные предпочтения для рекомендации по экземплярам.

cpuVendorArchitectures -> (список)

Описание поставщика и архитектуры процессора для экземпляра или рекомендаций группы Auto Scaling.

Например, при указании AWS_ARM64 с:

Запросом GetEC2InstanceRecommendations или GetAutoScalingGroupRecommendations Compute Optimizer возвращает рекомендации, состоящие только из типов экземпляров Graviton.
Запросом GetEC2RecommendationProjectedMetrics Compute Optimizer возвращает прогнозируемые метрики использования только для рекомендаций по типу экземпляра Graviton.
Запросом ExportEC2InstanceRecommendations или ExportAutoScalingGroupRecommendations Compute Optimizer экспортирует рекомендации, состоящие только из типов экземпляров Graviton.

(строка)

enhancedInfrastructureMetrics -> (строка)

Описание состояния активации предпочтения расширенных метрик инфраструктуры.

Состояние Active подтверждает, что предпочтение применено в последнем обновлении рекомендации, а состояние Inactive подтверждает, что оно ещё не применено к рекомендациям.

Дополнительную информацию см. в разделе Расширенные метрики инфраструктуры в Руководстве пользователя Compute Optimizer.

inferredWorkloadTypes -> (строка)

Описание состояния активации предпочтения выведенных типов рабочих нагрузок.

Состояние Active подтверждает, что предпочтение применено в последнем обновлении рекомендации. Состояние Inactive подтверждает, что оно ещё не применено к рекомендациям.

externalMetricsPreference -> (структура)

Объект, описывающий предпочтение внешних метрик рекомендации.

Если предпочтение применено в последнем обновлении рекомендации, в ответе появится объект с действительным значением source. Если предпочтение ещё не применено к рекомендациям, то этот объект в ответе отсутствует.

source -> (строка)

Содержит варианты источников для предпочтений внешних метрик.

lookBackPeriod -> (строка)

Количество дней, в течение которых анализируются метрики использования ресурсов Amazon Web Services.

utilizationPreferences -> (список)

Предпочтения использования процессора и памяти ресурса, такие как порог и резерв, которые используются для генерации рекомендаций по ресайзингу.

Примечание

Это предпочтение доступно только для типа ресурса экземпляра Amazon EC2.

(структура)

Предпочтение для управления порогом использования процессора, резервом использования процессора и резервом использования памяти.

Примечание

Это предпочтение доступно только для типа ресурса экземпляра Amazon EC2.

metricName -> (строка)

Имя метрики использования ресурса для настройки.

metricParameters -> (структура)

Параметры для настройки порогов использования ресурса.

threshold -> (строка)

Значение порога, используемое для указанного параметра метрики.

Примечание

Вы можете указать только значение порога для использования процессора.

headroom -> (строка)

Значение резерва в процентах, используемое для указанного параметра метрики.

Ниже приведены допустимые значения для использования процессора и памяти.

Использование процессора: PERCENT_30 | PERCENT_20 | PERCENT_0
Использование памяти: PERCENT_30 | PERCENT_20 | PERCENT_10

preferredResources -> (список)

Значения типа ресурса, которые рассматриваются в качестве кандидатов при генерации рекомендаций по ресайзингу.

(структура)

Описание эффективных предпочтительных ресурсов, которые Compute Optimizer рассматривает в качестве кандидатов для рекомендаций по ресайзингу.

Примечание

Compute Optimizer поддерживает только типы экземпляров Amazon EC2.

name -> (строка)

Имя списка предпочтительных ресурсов.

includeList -> (список)

Список предпочтительных значений ресурса, которые вы хотите рассмотреть в качестве кандидатов для рекомендаций по ресайзингу.

(строка)

effectiveIncludeList -> (список)

Расширенный вариант вашего списка предпочтительных ресурсов.

(строка)

excludeList -> (список)

Список предпочтительных значений ресурса, которые вы хотите исключить из кандидатов для рекомендаций по ресайзингу.

(строка)

savingsEstimationMode -> (структура)

Описание режима оценки экономии, применяемого для расчета возможности экономии для ресурса.

source -> (строка)

Описание источника для расчета возможности экономии для экземпляров Amazon EC2.

inferredWorkloadTypes -> (список)

Приложения, которые могут выполняться на экземпляре, как определено Compute Optimizer.

Compute Optimizer может определить, возможно ли выполнение одного из следующих приложений на экземпляре:

AmazonEmr — Определяет, что на экземпляре, возможно, выполняется Amazon EMR.
ApacheCassandra — Определяет, что на экземпляре, возможно, выполняется Apache Cassandra.
ApacheHadoop — Определяет, что на экземпляре, возможно, выполняется Apache Hadoop.
Memcached — Определяет, что на экземпляре, возможно, выполняется Memcached.
NGINX — Определяет, что на экземпляре, возможно, выполняется NGINX.
PostgreSql — Определяет, что на экземпляре, возможно, выполняется PostgreSQL.
Redis — Определяет, что на экземпляре, возможно, выполняется Redis.
Kafka — Определяет, что на экземпляре, возможно, выполняется Kafka.
SQLServer — Определяет, что на экземпляре, возможно, выполняется SQLServer.

(строка)

instanceState -> (строка)

Состояние экземпляра при генерации рекомендации.

tags -> (список)

Список тегов, назначенных рекомендациям по экземплярам Amazon EC2.

(структура)

Список пар значений ключа и значения тега, которые вы определяете.

key -> (строка)

Одна часть пары ключ-значение, составляющей тег. Ключ — это общая метка, которая действует как категория для более конкретных значений тегов.

value -> (строка)

Одна часть пары ключ-значение, составляющей тег. Значение действует как описание в категории тега (ключ). Значение может быть пустым или нулевым.

externalMetricStatus -> (структура)

Объект, описывающий состояние интеграции Compute Optimizer с вашим внешним поставщиком метрик.

statusCode -> (строка)

Код состояния интеграции Compute Optimizer с внешним поставщиком метрик.

statusReason -> (строка)

Причина состояния интеграции Compute Optimizer с вашим внешним поставщиком метрик.

currentInstanceGpuInfo -> (структура)

Описание настроек ускорителей графических процессоров (GPU) для текущего типа экземпляра.

gpus -> (список)

Описание ускорителей графических процессоров (GPU) для типа экземпляра.

(структура)

Описание ускорителей графических процессоров (GPU) для типа экземпляра.

gpuCount -> (целое число)

Количество графических процессоров (GPU) для типа экземпляра.

gpuMemorySizeInMiB -> (целое число)

Общий размер памяти для ускорителей графических процессоров (GPU) для типа экземпляра в МБ.

idle -> (строка)

Описание состояния бездействия экземпляра Amazon EC2.

errors -> (список)

Массив объектов, описывающих ошибки запроса.

Например, ошибка возвращается, если вы запрашиваете рекомендации для экземпляра неподдерживаемой семейства экземпляров.

(структура)

Описание ошибки, возникшей при получении рекомендаций.

Например, ошибка возвращается, если вы запрашиваете рекомендации для неподдерживаемой группы Auto Scaling или для экземпляра неподдерживаемой семейства экземпляров.

identifier -> (строка)

Идентификатор ошибки.

code -> (строка)

Код ошибки.

message -> (строка)

Сообщение или причина ошибки.

END_OF_DOCUMENT_MARKER