describe-dimension-keys

Описание

Для определенного периода времени извлеките самые важные N ключи измерений для метрики.

Примечание

Каждый элемент ответа возвращает не более 500 байт. Для больших элементов, таких как SQL-запросы, возвращается только первые 500 байт.

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

Синтаксис

  describe-dimension-keys
--service-type <value>
--identifier <value>
--start-time <value>
--end-time <value>
--metric <value>
[--period-in-seconds <value>]
--group-by <value>
[--additional-metrics <value>]
[--partition-by <value>]
[--filter <value>]
[--max-results <value>]
[--next-token <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]

Параметры

--service-type (строка)

Сервис Amazon Web Services, для которого Performance Insights вернёт метрики. Допустимые значения:

RDS
DOCDB

Возможные значения:

RDS
DOCDB

--identifier (строка)

Неизменяемый, уникальный для региона Amazon Web Services идентификатор источника данных. Performance Insights собирает метрики из этого источника.

Для использования экземпляра Amazon RDS в качестве источника данных, укажите его значение DbiResourceId. Например, укажите db-FAIHNTYBKTGAUSUZQYPDS2GW4A.

--start-time (отметка времени)

Дата и время, определяющие начало запрашиваемых данных временного ряда. Вы должны указать StartTime в течение последних 7 дней. Указанное значение является включительно, что означает, что возвращаются точки данных, равные или большие, чем StartTime.

Значение для StartTime должно быть раньше, чем значение для EndTime.

--end-time (отметка времени)

Дата и время, определяющие конец запрашиваемых данных временного ряда. Указанное значение является исключительно, что означает, что возвращаются точки данных меньше (но не равные) EndTime.

Значение для EndTime должно быть позже, чем значение для StartTime.

--metric (строка)

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

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

db.load.avg — масштабируемое представление количества активных сеансов для движка базы данных.
db.sampledload.avg — фактическое количество активных сеансов для движка базы данных.

Если количество активных сеансов меньше внутреннего порога 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.

--period-in-seconds (целое число)

Гранность, в секундах, точек данных, возвращаемых Performance Insights. Период может быть от одной секунды до одного дня (86400 секунд). Допустимые значения:

1 (одна секунда)
60 (одна минута)
300 (пять минут)
3600 (один час)
86400 (сутки)

Если вы не укажете PeriodInSeconds, Performance Insights выберет значение для вас, стремясь вернуть примерно от 100 до 200 точек данных в ответе.

--group-by (структура)

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

Группа -> (строка)

Имя группы измерений. Допустимые значения:

db — имя базы данных, к которой подключён клиент. Разрешены следующие значения:
- Aurora PostgreSQL
- Amazon RDS PostgreSQL
- Aurora MySQL
- Amazon RDS MySQL
- Amazon RDS MariaDB
- Amazon DocumentDB
db.application — имя приложения, подключённого к базе данных. Разрешены следующие значения:
- Aurora PostgreSQL
- Amazon RDS PostgreSQL
- Amazon DocumentDB
db.blocking_sql — SQL-запросы, блокирующие наибольшую нагрузку на БД.
db.blocking_session — сеансы, блокирующие наибольшую нагрузку на БД.
db.blocking_object — ресурсы объектов, полученные другими сеансами, блокирующие наибольшую нагрузку на БД.
db.host — имя хоста подключённого клиента (все движки).
db.plans — планы выполнения запросов (только Aurora PostgreSQL).
db.query — запрос, который в настоящее время выполняется (только Amazon DocumentDB).
db.query_tokenized — запрос в виде дайджеста (только Amazon DocumentDB).
db.session_type — тип текущего сеанса (только Aurora PostgreSQL и RDS PostgreSQL).
db.sql — текст SQL-запроса, который в настоящее время выполняется (все движки, кроме Amazon DocumentDB).
db.sql_tokenized — дайджест SQL (все движки, кроме Amazon DocumentDB).
db.user — пользователь, вошедший в базу данных (все движки, кроме Amazon DocumentDB).
db.wait_event — событие, в ожидании которого находится сервер базы данных (все движки, кроме Amazon DocumentDB).
db.wait_event_type — тип события, в ожидании которого находится сервер базы данных (все движки, кроме Amazon DocumentDB).
db.wait_state — событие, в ожидании которого находится сервер базы данных (только Amazon DocumentDB).

Измерения -> (список)

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

Допустимые значения для элементов массива Dimensions:

db.application.name — имя приложения, подключённого к базе данных. Допустимые значения:
- Aurora PostgreSQL
- Amazon RDS PostgreSQL
- Amazon DocumentDB
db.blocking_sql.id — идентификатор каждого из SQL-запросов, блокирующих наибольшую нагрузку на БД.
db.blocking_sql.sql — текст SQL для каждого из SQL-запросов, блокирующих наибольшую нагрузку на БД.
db.blocking_session.id — идентификатор каждого из сеансов, блокирующих наибольшую нагрузку на БД.
db.blocking_object.id — идентификатор каждого из ресурсов объектов, полученных другими сеансами, блокирующих наибольшую нагрузку на БД.
db.blocking_object.type — тип объекта для каждого из ресурсов объектов, полученных другими сеансами, блокирующих наибольшую нагрузку на БД.
db.blocking_object.value — значение для каждого из ресурсов объектов, полученных другими сеансами, блокирующих наибольшую нагрузку на БД.
db.host.id — идентификатор хоста подключённого клиента (все движки).
db.host.name — имя хоста подключённого клиента (все движки).
db.name — имя базы данных, к которой подключён клиент. Допустимые значения:
- Aurora PostgreSQL
- Amazon RDS PostgreSQL
- Aurora MySQL
- Amazon RDS MySQL
- Amazon RDS MariaDB
- Amazon DocumentDB
db.query.id — идентификатор запроса, сгенерированный Performance Insights (только Amazon DocumentDB).
db.query.db_id — идентификатор запроса, сгенерированный базой данных (только Amazon DocumentDB).
db.query.statement — текст запроса, выполняемого в данный момент (только Amazon DocumentDB).
db.query.tokenized_id
db.query.tokenized.id — идентификатор дайджеста запроса, сгенерированный Performance Insights (только Amazon DocumentDB).
db.query.tokenized.db_id — идентификатор дайджеста запроса, сгенерированный Performance Insights (только Amazon DocumentDB).
db.query.tokenized.statement — текст дайджеста запроса (только Amazon DocumentDB).
db.session_type.name — тип текущего сеанса (только Amazon DocumentDB).
db.sql.id — хэш полного, не токенизированного SQL-запроса, сгенерированного Performance Insights (все движки, кроме Amazon DocumentDB).
db.sql.db_id — либо идентификатор SQL, сгенерированный движком базы данных, либо значение, сгенерированное Performance Insights, начинающееся с pi- (все движки, кроме Amazon DocumentDB).
db.sql.statement — полный текст выполняемого SQL-запроса, как в SELECT * FROM employees (все движки, кроме Amazon DocumentDB)
db.sql.tokenized_id — хэш дайджеста SQL, сгенерированного Performance Insights (все движки, кроме Amazon DocumentDB). Измерение db.sql.tokenized_id получает значение измерения db.sql_tokenized.id. Amazon RDS возвращает db.sql.tokenized_id из группы измерений db.sql.
db.sql_tokenized.id — хэш дайджеста SQL, сгенерированного Performance Insights (все движки, кроме Amazon DocumentDB). В консоли db.sql_tokenized.id называется ID поддержки, так как служба поддержки Amazon Web Services может просматривать эти данные, чтобы помочь вам устранить проблемы с базой данных.
db.sql_tokenized.db_id — либо собственный идентификатор базы данных, используемый для ссылки на SQL-запрос, либо синтетический идентификатор, например, pi-2372568224, который Performance Insights генерирует, если собственный идентификатор базы данных недоступен (все движки, кроме Amazon DocumentDB).
db.sql_tokenized.statement — текст дайджеста SQL, как в SELECT * FROM employees WHERE employee_id = ? (все движки, кроме Amazon DocumentDB)
db.user.id — идентификатор пользователя, вошедшего в базу данных (все движки, кроме Amazon DocumentDB).
db.user.name — имя пользователя, вошедшего в базу данных (все движки, кроме Amazon DocumentDB).
db.wait_event.name — событие, в ожидании которого находится бэкэнд (все движки, кроме Amazon DocumentDB).
db.wait_event.type — тип события, в ожидании которого находится бэкэнд (все движки, кроме Amazon DocumentDB).
db.wait_event_type.name — имя типа события, в ожидании которого находится бэкэнд (все движки, кроме Amazon DocumentDB).
db.wait_state.name — событие, в ожидании которого находится бэкэнд (только Amazon DocumentDB).

(строка)

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

Предел -> (целое число)

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

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

Group=string,Dimensions=string,string,Limit=integer

Синтаксис JSON:

{
  "Group": "string",
  "Dimensions": ["string", ...],
  "Limit": integer
}

--additional-metrics (список)

Дополнительные метрики для основных N ключей измерений. Если указанная группа измерений в параметре GroupBy равна db.sql_tokenized, вы можете указать метрики для каждого SQL-запроса, чтобы получить значения для основных N дайджестов SQL-запросов. Синтаксис ответа: "AdditionalMetrics" : { "*string* " : "*string* " }.

Поддерживаемая функция статистики — .avg.

(строка)

Синтаксис:

"string" "string" ...

--partition-by (структура)

Для каждого указанного в GroupBy измерения укажите второстепенное измерение для дальнейшего подразделения ключей разделов в ответе.

Group -> (строка)

Имя группы измерений. Допустимые значения следующие:

db — Имя базы данных, к которой подключен клиент. Разрешены следующие значения:
- Aurora PostgreSQL
- Amazon RDS PostgreSQL
- Aurora MySQL
- Amazon RDS MySQL
- Amazon RDS MariaDB
- Amazon DocumentDB
db.application — Имя приложения, подключенного к базе данных. Допустимые значения следующие:
- Aurora PostgreSQL
- Amazon RDS PostgreSQL
- Amazon DocumentDB
db.blocking_sql — SQL-запросы, блокирующие большую часть нагрузки на БД.
db.blocking_session — Сессии, блокирующие большую часть нагрузки на БД.
db.blocking_object — Ресурсы объектов, полученные другими сессиями, которые блокируют большую часть нагрузки на БД.
db.host — Имя хоста подключенного клиента (все движки).
db.plans — Планы выполнения запроса (только Aurora PostgreSQL).
db.query — Запрос, который в настоящее время выполняется (только Amazon DocumentDB).
db.query_tokenized — Запрос дайджеста (только Amazon DocumentDB).
db.session_type — Тип текущей сессии (только Aurora PostgreSQL и RDS PostgreSQL).
db.sql — Текст SQL-утверждения, который в настоящее время выполняется (все движки, кроме Amazon DocumentDB).
db.sql_tokenized — SQL-дайджест (все движки, кроме Amazon DocumentDB).
db.user — Пользователь, вошедший в базу данных (все движки, кроме Amazon DocumentDB).
db.wait_event — Событие, в ожидании которого находится бэкенд базы данных (все движки, кроме Amazon DocumentDB).
db.wait_event_type — Тип события, в ожидании которого находится бэкенд базы данных (все движки, кроме Amazon DocumentDB).
db.wait_state — Событие, в ожидании которого находится бэкенд базы данных (только Amazon DocumentDB).

Dimensions -> (список)

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

Допустимые значения для элементов в массиве Dimensions:

db.application.name — Имя приложения, подключенного к базе данных. Допустимые значения следующие:
- Aurora PostgreSQL
- Amazon RDS PostgreSQL
- Amazon DocumentDB
db.blocking_sql.id — Идентификатор каждого из SQL-запросов, блокирующих большую часть нагрузки на БД.
db.blocking_sql.sql — Текст SQL для каждого из SQL-запросов, блокирующих большую часть нагрузки на БД.
db.blocking_session.id — Идентификатор каждой из сессий, блокирующих большую часть нагрузки на БД.
db.blocking_object.id — Идентификатор каждого из ресурсов объектов, полученных другими сессиями, которые блокируют большую часть нагрузки на БД.
db.blocking_object.type — Тип объекта для каждого из ресурсов объектов, полученных другими сессиями, которые блокируют большую часть нагрузки на БД.
db.blocking_object.value — Значение для каждого из ресурсов объектов, полученных другими сессиями, которые блокируют большую часть нагрузки на БД.
db.host.id — Идентификатор хоста подключенного клиента (все движки).
db.host.name — Имя хоста подключенного клиента (все движки).
db.name — Имя базы данных, к которой подключен клиент. Допустимые значения следующие:
- Aurora PostgreSQL
- Amazon RDS PostgreSQL
- Aurora MySQL
- Amazon RDS MySQL
- Amazon RDS MariaDB
- Amazon DocumentDB
db.query.id — Идентификатор запроса, сгенерированный Performance Insights (только Amazon DocumentDB).
db.query.db_id — Идентификатор запроса, сгенерированный базой данных (только Amazon DocumentDB).
db.query.statement — Текст запроса, который выполняется (только Amazon DocumentDB).
db.query.tokenized_id
db.query.tokenized.id — Идентификатор дайджеста запроса, сгенерированный Performance Insights (только Amazon DocumentDB).
db.query.tokenized.db_id — Идентификатор дайджеста запроса, сгенерированный Performance Insights (только Amazon DocumentDB).
db.query.tokenized.statement — Текст дайджеста запроса (только Amazon DocumentDB).
db.session_type.name — Тип текущей сессии (только Amazon DocumentDB).
db.sql.id — Хэш полного, не токенизированного SQL-утверждения, сгенерированного Performance Insights (все движки, кроме Amazon DocumentDB).
db.sql.db_id — Либо идентификатор SQL, сгенерированный движком базы данных, либо значение, сгенерированное Performance Insights, начинающееся с pi- (все движки, кроме Amazon DocumentDB).
db.sql.statement — Полный текст SQL-утверждения, которое выполняется, как в SELECT * FROM employees (все движки, кроме Amazon DocumentDB)
db.sql.tokenized_id — Хэш дайджеста SQL, сгенерированный Performance Insights (все движки, кроме Amazon DocumentDB). Измерение db.sql.tokenized_id извлекает значение измерения db.sql_tokenized.id. Amazon RDS возвращает db.sql.tokenized_id из группы измерений db.sql.
db.sql_tokenized.id — Хэш дайджеста SQL, сгенерированный Performance Insights (все движки, кроме Amazon DocumentDB). В консоли db.sql_tokenized.id называется Идентификатором поддержки, так как Служба поддержки Amazon Web Services может просмотреть эти данные, чтобы помочь вам устранить проблемы с базой данных.
db.sql_tokenized.db_id — Либо собственный идентификатор базы данных, используемый для ссылки на SQL-утверждение, либо синтетический идентификатор, например, pi-2372568224, который генерирует Performance Insights, если собственный идентификатор базы данных недоступен (все движки, кроме Amazon DocumentDB).
db.sql_tokenized.statement — Текст дайджеста SQL, как в SELECT * FROM employees WHERE employee_id = ? (все движки, кроме Amazon DocumentDB)
db.user.id — Идентификатор пользователя, вошедшего в базу данных (все движки, кроме Amazon DocumentDB).
db.user.name — Имя пользователя, вошедшего в базу данных (все движки, кроме Amazon DocumentDB).
db.wait_event.name — Событие, в ожидании которого находится бэкенд (все движки, кроме Amazon DocumentDB).
db.wait_event.type — Тип события, в ожидании которого находится бэкенд (все движки, кроме Amazon DocumentDB).
db.wait_event_type.name — Имя типа события, в ожидании которого находится бэкенд (все движки, кроме Amazon DocumentDB).
db.wait_state.name — Событие, в ожидании которого находится бэкенд (только Amazon DocumentDB).

(строка)

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

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

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

Сокращенная синтаксическая запись:

Group=string,Dimensions=string,string,Limit=integer

Синтаксис JSON:

{
  "Group": "string",
  "Dimensions": ["string", ...],
  "Limit": integer
}

--filter (отображение)

Один или несколько фильтров для применения в запросе. Ограничения:

Любое количество фильтров по одному и тому же измерению, как указано в параметрах GroupBy или Partition.
Один фильтр для любого другого измерения в этой группе измерений.

Примечание

Фильтр db.sql.db_id недоступен для баз данных RDS для SQL Server.

key -> (строка)

value -> (строка)

Сокращенная синтаксическая запись:

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

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

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

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

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

--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.

Примеры

Примечание

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

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

Пример 1: Описание ключей размеров

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

Команда:

aws pi describe-dimension-keys --service-type RDS --identifier db-LKCGOBK26374TPTDFXOIWVCPPM --start-time 1527026400 --end-time 1527080400 --metric db.load.avg --group-by '{"Group":"db.wait_event"}'

Вывод:

{
    "AlignedEndTime": 1.5270804E9,
    "AlignedStartTime": 1.5270264E9,
    "Keys": [
        {
            "Dimensions": {"db.wait_event.name": "wait/synch/mutex/innodb/aurora_lock_thread_slot_futex"},
            "Total": 0.05906906851195666
        },
        {
            "Dimensions": {"db.wait_event.name": "wait/io/aurora_redo_log_flush"},
            "Total": 0.015824722186149193
        },
        {
            "Dimensions": {"db.wait_event.name": "CPU"},
            "Total": 0.008014396230265477
        },
        {
            "Dimensions": {"db.wait_event.name": "wait/io/aurora_respond_to_client"},
            "Total": 0.0036361612526204477
        },
        {
            "Dimensions": {"db.wait_event.name": "wait/io/table/sql/handler"},
            "Total": 0.0019108398419382965
        },
        {
            "Dimensions": {"db.wait_event.name": "wait/synch/cond/mysys/my_thread_var::suspend"},
            "Total": 8.533847837782684E-4
        },
        {
            "Dimensions": {"db.wait_event.name": "wait/io/file/csv/data"},
            "Total": 6.864181956477376E-4
        },
        {
            "Dimensions": {"db.wait_event.name": "Unknown"},
            "Total": 3.895887056379051E-4
        },
        {
            "Dimensions": {"db.wait_event.name": "wait/synch/mutex/sql/FILE_AS_TABLE::LOCK_shim_lists"},
            "Total": 3.710368625122906E-5
        },
        {
            "Dimensions": {"db.wait_event.name": "wait/lock/table/sql/handler"},
            "Total": 0
        }
    ]
}

Пример 2: Поиск идентификатора SQL для операторов, которые вносят наибольший вклад в нагрузку на базу данных

Следующий describe-dimension-keys запрос SQL-оператор и идентификатор SQL для 10 операторов, которые вносят наибольший вклад в нагрузку на базу данных.

aws pi describe-dimension-keys \
    --service-type RDS \
    --identifier db-abcdefg123456789 \
    --start-time 2023-05-01T00:00:00Z \
    --end-time 2023-05-01T01:00:00Z \
    --metric db.load.avg \
    --group-by '{"Group": "db.sql", "Dimensions": ["db.sql.id", "db.sql.statement"],"Limit": 10}'

Вывод:

{
    "AlignedEndTime": 1.5270804E9,
    "AlignedStartTime": 1.5270264E9,
    "Identifier": "db-abcdefg123456789",
    "MetricList": [
        {
            "Keys": [
                {
                    "Dimensions": {"db.sql.id": "AKIAIOSFODNN7EXAMPLE", "db.sql.statement": "SELECT * FROM customers WHERE customer_id = 123"},
                    "Total": 25.5,"Partitions": [12.3, 13.2]
                }
            ]
        }
    ]
}

Дополнительную информацию о размерах в Performance Insights см. в разделе Нагрузка на базу данных в Руководстве пользователя Amazon RDS и Нагрузка на базу данных в Руководстве пользователя Amazon Aurora.

Вывод

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

Начальное время возвращённых ключей размеров после выравнивания до гранулированного предела (как указано в PeriodInSeconds ). AlignedStartTime будет меньше или равно значению заданного пользователем StartTime.

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

Конечное время возвращённых ключей размеров после выравнивания до гранулированного предела (как указано в PeriodInSeconds ). AlignedEndTime будет больше или равно значению заданного пользователем Endtime.

PartitionKeys -> (список)

Если PartitionBy присутствовал в запросе, PartitionKeys содержит разбивку ключей размеров по указанным разделам.

(структура)

Если PartitionBy был указан в запросе DescribeDimensionKeys, размеры возвращаются в массиве. Каждый элемент массива указывает один размер.

Dimensions -> (отображение)

Таблица размеров, содержащая размеры для этого раздела.

ключ -> (строка)

значение -> (строка)

Keys -> (список)

Запрошенные ключи размеров.

(структура)

Объект, включающий значения запрошенных ключей размеров и агрегированные значения метрик в группе размеров.

Dimensions -> (отображение)

Таблица пар имя-значение для размеров в группе.

ключ -> (строка)

значение -> (строка)

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

Агрегированное значение метрики для размеров за заданный период.

AdditionalMetrics -> (отображение)

Таблица, содержащая значения каждой дополнительной метрики.

ключ -> (строка)

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

Partitions -> (список)

Если PartitionBy было указано, PartitionKeys содержит размеры, которые были.

(двойное)

NextToken -> (строка)

Токен постраничной навигации, указывающий, что ответ не вернул все доступные записи, так как MaxRecords был указан в предыдущем запросе. Для получения оставшихся записей укажите NextToken в отдельном запросе со значением этого параметра.