describe-db-recommendations

Описание

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

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

describe-db-recommendations является постраничной операцией. Для получения всего набора результатов могут потребоваться несколько вызовов API. Вы можете отключить постраничность, предоставив аргумент --no-paginate. При использовании --output text и аргумента --query в ответ на постраничный запрос аргумент --query должен извлечь данные из результатов следующих выражений запроса: DBRecommendations

Синтаксис

  describe-db-recommendations
[--last-updated-after <value>]
[--last-updated-before <value>]
[--locale <value>]
[--filters <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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]

Параметры

--last-updated-after (отметка времени)

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

--last-updated-before (отметка времени)

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

--locale (строка)

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

Допустимые значения:

en
en_UK
de
es
fr
id
it
ja
ko
pt_BR
zh_TW
zh_CN

--filters (список)

Фильтр, который определяет одну или несколько рекомендаций для описания.

Поддерживаемые фильтры:

recommendation-id - Принимает список идентификаторов рекомендаций. В списке результатов будут только рекомендации, идентификатор которых совпадает с одним из указанных значений фильтра.
status - Принимает список статусов рекомендаций. Допустимые значения:
- active - Рекомендации, готовые к применению.
- pending - Применяемые или запланированные рекомендации, которые находятся в процессе выполнения.
- resolved - Рекомендации, которые завершены.
- dismissed - Рекомендации, которые вы отклонили.

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

severity - Принимает список уровней важности рекомендаций. В списке результатов будут только рекомендации, уровень важности которых совпадает с одним из указанных значений фильтра. Допустимые значения:
- high
- medium
- low
- informational
type-id - Принимает список идентификаторов типов рекомендаций. В списке результатов будут только рекомендации, тип которых совпадает с одним из указанных значений фильтра.
dbi-resource-id - Принимает список идентификаторов ресурсов баз данных. В списке результатов будут только рекомендации, сгенерированные для указанных баз данных.
cluster-resource-id - Принимает список идентификаторов ресурсов кластеров. В списке результатов будут только рекомендации, сгенерированные для указанных кластеров.
pg-arn - Принимает список ARNs групп параметров. В списке результатов будут только рекомендации, сгенерированные для указанных групп параметров.
cluster-pg-arn - Принимает список ARNs групп параметров кластера. В списке результатов будут только рекомендации, сгенерированные для указанных групп параметров кластера.

(структура)

Пара имя-значение фильтра, используемая для возврата более конкретного списка результатов операции describe. Фильтры могут использоваться для сопоставления набора ресурсов по определенным критериям, таким как идентификаторы. Поддерживаемые фильтры для операции describe документированы с операцией describe.

Примечание

В настоящее время подстановка символов не поддерживается в фильтрах.

Следующие действия могут быть отфильтрованы:

DescribeDBClusterBacktracks
DescribeDBClusterEndpoints
DescribeDBClusters
DescribeDBInstances
DescribeDBRecommendations
DescribeDBShardGroups
DescribePendingMaintenanceActions

Имя -> (строка)

Имя фильтра. Имена фильтров чувствительны к регистру.

Значения -> (список)

Одно или несколько значений фильтра. Значения фильтров чувствительны к регистру.

(строка)

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

Name=string,Values=string,string ...

Синтаксис JSON:

[
  {
    "Name": "string",
    "Values": ["string", ...]
  }
  ...
]

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения переопределяют значения, предоставленные JSON. Передача произвольных двоичных значений с помощью значения, предоставленного JSON, невозможна, так как строка будет воспринята буквально. Это не может быть указано вместе с --cli-input-yaml.

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

Токен, указывающий, с какой позиции начать постраничную обработку. Это NextToken из ранее усеченного ответа.

Примеры использования см. в разделе Постраничная обработка в руководстве пользователя AWS Command Line Interface.

--page-size (целое число)

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

Примеры использования см. в разделе Постраничная обработка в руководстве пользователя AWS Command Line Interface.

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

Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов больше указанного значения, в выводе команды предоставляется NextToken. Для возобновления постраничной обработки укажите значение NextToken в аргументе starting-token последующей команды. **Не** используйте элемент ответа NextToken напрямую вне AWS CLI.

Примеры использования см. в разделе Постраничная обработка в руководстве пользователя AWS Command Line Interface.

--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
text
таблица
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.

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы с руководством пользователя AWS CLI.

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

Пример 1: Просмотр всех рекомендаций по базам данных

Следующий describe-db-recommendations пример отображает все рекомендации по базам данных в вашей учетной записи AWS.

aws rds describe-db-recommendations

Вывод:

{
    "DBRecommendations": [
        {
            "RecommendationId": "12ab3cde-f456-7g8h-9012-i3j45678k9lm",
            "TypeId": "config_recommendation::old_minor_version",
            "Severity": "informational",
            "ResourceArn": "arn:aws:rds:us-west-2:111122223333:db:database-1",
            "Status": "active",
            "CreatedTime": "2024-02-21T23:14:19.292000+00:00",
            "UpdatedTime": "2024-02-21T23:14:19+00:00",
            "Detection": "**[resource-name]** is not running the latest minor DB engine version",
            "Recommendation": "Upgrade to latest engine version",
            "Description": "Your database resources aren't running the latest minor DB engine version. The latest minor version contains the latest security fixes and other improvements.",
            "RecommendedActions": [
                {
                    "ActionId": "12ab34c5de6fg7h89i0jk1lm234n5678",
                    "Operation": "modifyDbInstance",
                    "Parameters": [
                        {
                            "Key": "EngineVersion",
                            "Value": "5.7.44"
                        },
                        {
                            "Key": "DBInstanceIdentifier",
                            "Value": "database-1"
                        }
                    ],
                    "ApplyModes": [
                        "immediately",
                        "next-maintenance-window"
                    ],
                    "Status": "ready",
                    "ContextAttributes": [
                        {
                            "Key": "Recommended value",
                            "Value": "5.7.44"
                        },
                        {
                            "Key": "Current engine version",
                            "Value": "5.7.42"
                        }
                    ]
                }
            ],
            "Category": "security",
            "Source": "RDS",
            "TypeDetection": "**[resource-count] resources** are not running the latest minor DB engine version",
            "TypeRecommendation": "Upgrade to latest engine version",
            "Impact": "Reduced database performance and data security at risk",
            "AdditionalInfo": "We recommend that you maintain your database with the latest DB engine minor version as this version includes the latest security and functionality fixes. The DB engine minor version upgrades contain only the changes which are backward-compatible with earlier minor versions of the same major version of the DB engine.",
            "Links": [
                {
                    "Text": "Upgrading an RDS DB instance engine version",
                    "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Upgrading.html"
                },
                {
                    "Text": "Using Amazon RDS Blue/Green Deployments for database updates for Amazon Aurora",
                    "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments.html"
                },
                {
                    "Text": "Using Amazon RDS Blue/Green Deployments for database updates for Amazon RDS",
                    "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments.html"
                }
            ]
        }
    ]
}

Дополнительную информацию см. в разделе Просмотр и принятие решений по рекомендациям Amazon RDS в руководстве пользователя Amazon RDS и Просмотр и принятие решений по рекомендациям Amazon RDS в руководстве пользователя Amazon Aurora.

Пример 2: Просмотр рекомендаций по базам данных с высоким уровнем критичности

Следующий describe-db-recommendations пример отображает рекомендации по базам данных с высоким уровнем критичности в вашей учетной записи AWS.

aws rds describe-db-recommendations \
    --filters Name=severity,Values=high

Вывод:

{
    "DBRecommendations": [
        {
            "RecommendationId": "12ab3cde-f456-7g8h-9012-i3j45678k9lm",
            "TypeId": "config_recommendation::rds_extended_support",
            "Severity": "high",
            "ResourceArn": "arn:aws:rds:us-west-2:111122223333:db:database-1",
            "Status": "active",
            "CreatedTime": "2024-02-21T23:14:19.392000+00:00",
            "UpdatedTime": "2024-02-21T23:14:19+00:00",
            "Detection": "Your databases will be auto-enrolled to RDS Extended Support on February 29",
            "Recommendation": "Upgrade your major version before February 29, 2024 to avoid additional charges",
            "Description": "Your PostgreSQL 11 and MySQL 5.7 databases will be automatically enrolled into RDS Extended Support on February 29, 2024. To avoid the increase in charges due to RDS Extended Support, we recommend upgrading your databases to a newer major engine version before February 29, 2024.\nTo learn more about the RDS Extended Support pricing, refer to the pricing page.",
            "RecommendedActions": [
                {
                    "ActionId": "12ab34c5de6fg7h89i0jk1lm234n5678",
                    "Parameters": [],
                    "ApplyModes": [
                        "manual"
                    ],
                    "Status": "ready",
                    "ContextAttributes": []
                }
            ],
            "Category": "cost optimization",
            "Source": "RDS",
            "TypeDetection": "Your database will be auto-enrolled to RDS Extended Support on February 29",
            "TypeRecommendation": "Upgrade your major version before February 29, 2024 to avoid additional charges",
            "Impact": "Increase in charges due to RDS Extended Support",
            "AdditionalInfo": "With Amazon RDS Extended Support, you can continue running your database on a major engine version past the RDS end of standard support date for an additional cost. This paid feature gives you more time to upgrade to a supported major engine version.\nDuring Extended Support, Amazon RDS will supply critical CVE patches and bug fixes.",
            "Links": [
                {
                    "Text": "Amazon RDS Extended Support pricing for RDS for MySQL",
                    "Url": "https://aws.amazon.com/rds/mysql/pricing/"
                },
                {
                    "Text": "Amazon RDS Extended Support for RDS for MySQL and PostgreSQL databases",
                    "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/extended-support.html"
                },
                {
                    "Text": "Amazon RDS Extended Support pricing for Amazon Aurora PostgreSQL",
                    "Url": "https://aws.amazon.com/rds/aurora/pricing/"
                },
                {
                    "Text": "Amazon RDS Extended Support for Aurora PostgreSQL databases",
                    "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/extended-support.html"
                },
                {
                    "Text": "Amazon RDS Extended Support pricing for RDS for PostgreSQL",
                    "Url": "https://aws.amazon.com/rds/postgresql/pricing/"
                }
            ]
        }
    ]
}

Пример 3: Просмотр рекомендаций по базе данных для указанного экземпляра базы данных

Следующий describe-db-recommendations пример отображает все рекомендации по базе данных для указанного экземпляра базы данных.

aws rds describe-db-recommendations \
    --filters Name=dbi-resource-id,Values=database-1

Вывод:

{
    "DBRecommendations": [
        {
            "RecommendationId": "12ab3cde-f456-7g8h-9012-i3j45678k9lm",
            "TypeId": "config_recommendation::old_minor_version",
            "Severity": "informational",
            "ResourceArn": "arn:aws:rds:us-west-2:111122223333:db:database-1",
            "Status": "active",
            "CreatedTime": "2024-02-21T23:14:19.292000+00:00",
            "UpdatedTime": "2024-02-21T23:14:19+00:00",
            "Detection": "**[resource-name]** is not running the latest minor DB engine version",
            "Recommendation": "Upgrade to latest engine version",
            "Description": "Your database resources aren't running the latest minor DB engine version. The latest minor version contains the latest security fixes and other improvements.",
            "RecommendedActions": [
                {
                    "ActionId": "12ab34c5de6fg7h89i0jk1lm234n5678",
                    "Operation": "modifyDbInstance",
                    "Parameters": [
                        {
                            "Key": "EngineVersion",
                            "Value": "5.7.44"
                        },
                        {
                            "Key": "DBInstanceIdentifier",
                            "Value": "database-1"
                        }
                    ],
                    "ApplyModes": [
                        "immediately",
                        "next-maintenance-window"
                    ],
                    "Status": "ready",
                    "ContextAttributes": [
                        {
                            "Key": "Recommended value",
                            "Value": "5.7.44"
                        },
                        {
                            "Key": "Current engine version",
                            "Value": "5.7.42"
                        }
                    ]
                }
            ],
            "Category": "security",
            "Source": "RDS",
            "TypeDetection": "**[resource-count] resources** are not running the latest minor DB engine version",
            "TypeRecommendation": "Upgrade to latest engine version",
            "Impact": "Reduced database performance and data security at risk",
            "AdditionalInfo": "We recommend that you maintain your database with the latest DB engine minor version as this version includes the latest security and functionality fixes. The DB engine minor version upgrades contain only the changes which are backward-compatible with earlier minor versions of the same major version of the DB engine.",
            "Links": [
                {
                    "Text": "Upgrading an RDS DB instance engine version",
                    "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Upgrading.html"
                },
                {
                    "Text": "Using Amazon RDS Blue/Green Deployments for database updates for Amazon Aurora",
                    "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments.html"
                },
                {
                    "Text": "Using Amazon RDS Blue/Green Deployments for database updates for Amazon RDS",
                    "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments.html"
                }
            ]
        }
    ]
}

Пример 4: Просмотр всех активных рекомендаций по базам данных

Следующий describe-db-recommendations пример отображает все активные рекомендации по базам данных в вашей учетной записи AWS.

aws rds describe-db-recommendations \
    --filters Name=status,Values=active

Вывод:

{
    "DBRecommendations": [
        {
            "RecommendationId": "12ab3cde-f456-7g8h-9012-i3j45678k9lm",
            "TypeId": "config_recommendation::old_minor_version",
            "Severity": "informational",
            "ResourceArn": "arn:aws:rds:us-west-2:111122223333:db:database-1",
            "Status": "active",
            "CreatedTime": "2024-02-21T23:14:19.292000+00:00",
            "UpdatedTime": "2024-02-21T23:14:19+00:00",
            "Detection": "**[resource-name]** is not running the latest minor DB engine version",
            "Recommendation": "Upgrade to latest engine version",
            "Description": "Your database resources aren't running the latest minor DB engine version. The latest minor version contains the latest security fixes and other improvements.",
            "RecommendedActions": [
                {
                    "ActionId": "12ab34c5de6fg7h89i0jk1lm234n5678",
                    "Operation": "modifyDbInstance",
                    "Parameters": [
                        {
                            "Key": "EngineVersion",
                            "Value": "5.7.44"
                        },
                        {
                            "Key": "DBInstanceIdentifier",
                            "Value": "database-1"
                        }
                    ],
                    "ApplyModes": [
                        "immediately",
                        "next-maintenance-window"
                    ],
                    "Status": "ready",
                    "ContextAttributes": [
                        {
                            "Key": "Recommended value",
                            "Value": "5.7.44"
                        },
                        {
                            "Key": "Current engine version",
                            "Value": "5.7.42"
                        }
                    ]
                }
            ],
            "Category": "security",
            "Source": "RDS",
            "TypeDetection": "**[resource-count] resources** are not running the latest minor DB engine version",
            "TypeRecommendation": "Upgrade to latest engine version",
            "Impact": "Reduced database performance and data security at risk",
            "AdditionalInfo": "We recommend that you maintain your database with the latest DB engine minor version as this version includes the latest security and functionality fixes. The DB engine minor version upgrades contain only the changes which are backward-compatible with earlier minor versions of the same major version of the DB engine.",
            "Links": [
                {
                    "Text": "Upgrading an RDS DB instance engine version",
                    "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Upgrading.html"
                },
                {
                    "Text": "Using Amazon RDS Blue/Green Deployments for database updates for Amazon Aurora",
                    "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments.html"
                },
                {
                    "Text": "Using Amazon RDS Blue/Green Deployments for database updates for Amazon RDS",
                    "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments.html"
                }
            ]
        }
    ]
}

Вывод

DBRecommendations -> (список)

Список рекомендаций, возвращаемых запросом к API DescribeDBRecommendations.

(структура)

Рекомендации для ваших экземпляров БД, кластеров БД и групп параметров БД.

RecommendationId -> (строка)

Уникальный идентификатор рекомендации.

TypeId -> (строка)

Значение, указывающее тип рекомендации. Это значение определяет, как отображается описание.

Severity -> (строка)

Уровень серьезности рекомендации. Уровень серьезности поможет вам определить срочность принятия решения по рекомендации.

Допустимые значения:

high
medium
low
informational

ResourceArn -> (строка)

Идентификатор ресурса Amazon (ARN) источника RDS, связанного с рекомендацией.

Status -> (строка)

Текущий статус рекомендации.

Допустимые значения:

active - Рекомендации, готовые к применению.
pending - Применяемые или запланированные рекомендации, находящиеся в процессе выполнения.
resolved - Рекомендации, завершенные.
dismissed - Рекомендации, отклоненные вами.

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

Время создания рекомендации. Например, 2023-09-28T01:13:53.931000+00:00 .

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

Время последнего обновления рекомендации.

Detection -> (строка)

Краткое описание проблемы, выявленной для этой рекомендации. Описание может содержать разметку Markdown.

Recommendation -> (строка)

Краткое описание рекомендации для решения проблемы. Описание может содержать разметку Markdown.

Description -> (строка)

Подробное описание рекомендации. Описание может содержать разметку Markdown.

Reason -> (строка)

Причина создания этой рекомендации. Информация может содержать разметку Markdown.

RecommendedActions -> (список)

Список рекомендуемых действий.

(структура)

Рекомендуемые действия для устранения проблем, связанных с вашими экземплярами БД, кластерами БД и группами параметров БД.

ActionId -> (строка)

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

Title -> (строка)

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

Description -> (строка)

Подробное описание действия. Описание может содержать разметку Markdown.

Operation -> (строка)

Операция API для действия.

Parameters -> (список)

Параметры для операции API.

(структура)

Один параметр для использования с операцией API RecommendedAction для применения действия.

Key -> (строка)

Ключ параметра для использования с операцией API RecommendedAction.

Value -> (строка)

Значение параметра для использования с операцией API RecommendedAction.

ApplyModes -> (список)

Способы применения рекомендуемого действия.

Допустимые значения:

manual - Действие требует ручного решения рекомендации.
immediately - Действие применяется немедленно.
next-maintainance-window - Действие применяется во время следующего запланированного обслуживания.

(строка)

Status -> (строка)

Статус действия.

ready
applied
scheduled
resolved

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

Детали проблемы.

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

Подробное описание проблемы, когда категория рекомендации - performance.

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

Время начала проблемы производительности.

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

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

Metrics -> (список)

Метрики, имеющие отношение к проблеме производительности.

(структура)

Представление метрики.

Name -> (строка)

Название метрики.

References -> (список)

Список ссылок на метрики (пороговые значения).

(структура)

Ссылка (пороговое значение) на метрику.

Name -> (строка)

Название ссылки на метрику.

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

Детали проблемы производительности.

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

Детали ссылки на метрику, когда ссылка - скалярное значение.

Value -> (двойное значение)

Значение скалярной ссылки.

StatisticsDetails -> (строка)

Детали различных статистических данных для метрики. Описание может содержать разметку Markdown.

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

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

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

Запрос Performance Insights, который можно использовать для получения точек данных метрики Performance Insights.

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

Указание, как агрегировать точки данных из результата запроса. Вы должны указать допустимую группу измерений. Performance Insights вернет все измерения в этой группе, если вы не предоставите имена конкретных измерений в этой группе. Вы также можете запросить, чтобы Performance Insights вернул ограниченное количество значений для измерения.

Dimensions -> (список)

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

(строка)

Group -> (строка)

Доступные группы измерений для типа метрики Performance Insights.

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

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

Metric -> (строка)

Имя метрики Performance Insights, которая будет измеряться.

Допустимые значения:

db.load.avg - Масштабированное представление количества активных сеансов для движка базы данных.
db.sampledload.avg - Необработанное количество активных сеансов для движка базы данных.
Метрики счетчиков, перечисленные в руководстве по операционной системе Amazon Aurora в разделе «Метрики Performance Insights».

Если количество активных сеансов меньше внутреннего порога Performance Insights, db.load.avg и db.sampledload.avg имеют одинаковое значение. Если количество активных сеансов больше внутреннего порога, Performance Insights выбирает активные сеансы, а db.load.avg отображает масштабированные значения, db.sampledload.avg отображает необработанные значения, и db.sampledload.avg меньше db.load.avg . В большинстве случаев достаточно запросить только db.load.avg.

Analysis -> (строка)

Анализ проблемы производительности. Информация может содержать разметку Markdown.

ContextAttributes -> (список)

Поддерживающие атрибуты для объяснения рекомендуемого действия.

(структура)

Дополнительные атрибуты типа данных RecommendedAction.

Key -> (строка)

Ключ ContextAttribute.

Value -> (строка)

Значение ContextAttribute.

Category -> (строка)

Категория рекомендации.

Допустимые значения:

performance efficiency
security
reliability
cost optimization
operational excellence
sustainability

Source -> (строка)

Сервис Amazon Web Services, сгенерировавший рекомендации.

TypeDetection -> (строка)

Краткое описание типа рекомендации. Описание может содержать разметку Markdown.

TypeRecommendation -> (строка)

Краткое описание, суммирующее рекомендацию для исправления всех проблем типа рекомендации. Описание может содержать разметку Markdown.

Impact -> (строка)

Краткое описание возможного влияния проблемы.

AdditionalInfo -> (строка)

Дополнительная информация о рекомендации. Информация может содержать разметку Markdown.

Links -> (список)

Ссылка на документацию, которая предоставляет дополнительную информацию о рекомендации.

(структура)

Ссылка на документацию, предоставляющую дополнительную информацию для рекомендации.

Text -> (строка)

Текст со ссылкой на документацию для рекомендации.

Url -> (строка)

URL документации для рекомендации.

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

Подробности проблемы, которая вызвала рекомендацию.

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

Подробное описание проблемы, когда категория рекомендации равна performance.

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

Время начала проблемы производительности.

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

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

Metrics -> (список)

Метрики, относящиеся к проблеме производительности.

(структура)

Представление метрики.

Name -> (строка)

Имя метрики.

References -> (список)

Список ссылок на метрики (пороговые значения).

(структура)

Ссылка (пороговое значение) на метрику.

Name -> (строка)

Имя ссылки на метрику.

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

Подробности проблемы производительности.

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

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

Value -> (вещественное число)

Значение скалярной ссылки.

StatisticsDetails -> (строка)

Подробности различных статистических данных для метрики. Описание может содержать разметку Markdown.

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

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

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

Запрос Performance Insights, который можно использовать для получения точек данных метрики Performance Insights.

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

Указание, как агрегировать точки данных из результата запроса. Вы должны указать допустимую группу измерений. Performance Insights вернёт все измерения в этой группе, если вы не укажете имена конкретных измерений в этой группе. Вы также можете запросить, чтобы Performance Insights вернул ограниченное количество значений для измерения.

Dimensions -> (список)

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

(строка)

Group -> (строка)

Доступные группы измерений для типа метрики Performance Insights.

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

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

Metric -> (строка)

Имя метрики Performance Insights, подлежащей измерению.

Допустимые значения:

db.load.avg - Масштабированное представление количества активных сессий для движка базы данных.
db.sampledload.avg - Числовое значение активных сессий для движка базы данных.
Метрики счётчиков, перечисленные в Performance Insights в операционных счётчиках в руководстве пользователя Amazon Aurora.

Если количество активных сессий меньше внутреннего порога Performance Insights, db.load.avg и db.sampledload.avg имеют одинаковое значение. Если количество активных сессий превышает внутренний порог, Performance Insights выполняет выборку активных сессий, при этом db.load.avg отображает масштабированные значения, db.sampledload.avg отображает значения в сыром виде, а db.sampledload.avg меньше db.load.avg. Для большинства случаев вы можете запросить только db.load.avg.

Analysis -> (строка)

Анализ проблемы производительности. Информация может содержать разметку Markdown.

Marker -> (строка)

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

END_OF_DOCUMENT_MARKER