Spec-Zone.ru › AWS CLI v2

[ aws . xray ]

get-trace-graph

Описание

Возвращает график сервисов для одного или нескольких идентификаторов трассировки.

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

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

Синтаксис

  get-trace-graph
--trace-ids <value>
[--cli-input-json | --cli-input-yaml]
[--starting-token <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]

Параметры

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

Идентификаторы трассировки запросов, для которых требуется сгенерировать график сервисов.

(строка)

Синтаксис:

"string" "string" ...

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

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

Маркер для указания начальной точки страничной обработки. Это NextToken из ранее обрезанного ответа.

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

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

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

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

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

Глобальные параметры

--debug (логическое значение)

Включить отладку логирования.

--endpoint-url (строка)

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

--no-verify-ssl (логическое значение)

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

--no-paginate (логическое значение)

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

--output (строка)

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

  • json
  • текст
  • таблица
  • yaml
  • yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • включено
  • выключено
  • автоматически

--no-sign-request (логическое значение)

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

--ca-bundle (строка)

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

--cli-read-timeout (целое число)

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

--cli-connect-timeout (целое число)

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

--cli-binary-format (строка)

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

  • base64
  • raw-in-base64-out

--no-cli-pager (логическое значение)

Отключить кли-страничный вывод.

--cli-auto-prompt (логическое значение)

Автоматически запросить параметры входных данных CLI.

--no-cli-auto-prompt (логическое значение)

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

Вывод

Услуги -> (список)

Услуги, которые обработали один из указанных запросов.

(структура)

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

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

Идентификатор службы. Уникальный в рамках карты служб.

Name -> (строка)

Каноническое имя службы.

Names -> (список)

Список имен службы, включая каноническое имя.

(строка)

Root -> (логическое значение)

Указывает, что служба была первой, обработавшей запрос.

AccountId -> (строка)

Идентификатор учетной записи Amazon Web Services, в которой работает служба.

Type -> (строка)

Тип службы.

  • Ресурс Amazon Web Services - Тип ресурса Amazon Web Services. Например, AWS::EC2::Instance для приложения, работающего в Amazon EC2, или AWS::DynamoDB::Table для таблицы Amazon DynamoDB, используемой приложением.
  • Служба Amazon Web Services - Тип службы Amazon Web Services. Например, AWS::DynamoDB для вызовов дочерних служб Amazon DynamoDB, которые не были направлены на конкретную таблицу.
  • client - Представляет клиентов, которые отправляли запросы корневой службе.
  • remote - Дочерняя служба неопределённого типа.

State -> (строка)

Состояние службы.

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

Время начала первого сегмента, сгенерированного службой.

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

Время окончания последнего сегмента, сгенерированного службой.

Edges -> (список)

Соединения с дочерними службами.

(структура)

Информация о соединении между двумя службами. Ребро может быть синхронным соединением, например, обычным вызовом между клиентом и службой, или асинхронной связью, например, функцией Lambda, которая получает событие из очереди SNS.

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

Идентификатор ребра. Уникальный в пределах карты служб.

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

Время начала первого сегмента на ребре.

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

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

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

Статистики ответов для сегментов на ребре.

OkCount -> (длинное целое число)

Количество запросов, завершённых со статусом «Успех 2xx».

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

Информация о запросах, завершённых со статусом «Ошибка клиента 4xx».

ThrottleCount -> (длинное целое число)

Количество запросов, завершённых со статусом ограничения 429.

OtherCount -> (длинное целое число)

Количество запросов, завершённых с неотслеживаемыми статусами ошибок клиента 4xx.

TotalCount -> (длинное целое число)

Общее количество запросов, завершённых со статусом «Ошибка клиента 4xx».

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

Информация о запросах, завершённых со статусом «Ошибка сервера 5xx».

OtherCount -> (длинное целое число)

Количество запросов, завершённых с неотслеживаемыми статусами ошибок сервера 5xx.

TotalCount -> (длинное целое число)

Общее количество запросов, завершённых со статусом «Ошибка сервера 5xx».

TotalCount -> (длинное целое число)

Общее количество завершённых запросов.

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

Суммарное время ответа завершённых запросов.

ResponseTimeHistogram -> (список)

Гистограмма, отображающая распределение времени ответа клиента на ребре. Заполнено только для синхронных рёбер.

(структура)

Элемент гистограммы для статистики. Гистограмма отображает диапазон наблюдаемых значений на оси X и частоту каждого значения на оси Y.

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

Значение элемента.

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

Частота элемента.

Aliases -> (список)

Псевдонимы для ребра.

(структура)

Псевдоним для ребра.

Name -> (строка)

Каноническое имя псевдонима.

Names -> (список)

Список имен псевдонима, включая каноническое имя.

(строка)

Type -> (строка)

Тип псевдонима.

EdgeType -> (строка)

Описывает асинхронное соединение со значением link.

ReceivedEventAgeHistogram -> (список)

Гистограмма, отображающая распределение возраста события при получении потребителями. Возраст вычисляется каждый раз при получении события. Заполнено только при EdgeType равном link.

(структура)

Элемент гистограммы для статистики. Гистограмма отображает диапазон наблюдаемых значений на оси X и частоту каждого значения на оси Y.

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

Значение элемента.

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

Частота элемента.

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

Сводные статистические данные для службы.

OkCount -> (длинное целое число)

Количество запросов, завершённых со статусом «Успех 2xx».

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

Информация о запросах, завершённых со статусом «Ошибка клиента 4xx».

ThrottleCount -> (длинное целое число)

Количество запросов, завершённых со статусом ограничения 429.

OtherCount -> (длинное целое число)

Количество запросов, завершённых с неотслеживаемыми статусами ошибок клиента 4xx.

TotalCount -> (длинное целое число)

Общее количество запросов, завершённых со статусом «Ошибка клиента 4xx».

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

Информация о запросах, завершённых со статусом «Ошибка сервера 5xx».

OtherCount -> (длинное целое число)

Количество запросов, завершённых с неотслеживаемыми статусами ошибок сервера 5xx.

TotalCount -> (длинное целое число)

Общее количество запросов, завершённых со статусом «Ошибка сервера 5xx».

TotalCount -> (длинное целое число)

Общее количество завершённых запросов.

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

Суммарное время ответа завершённых запросов.

DurationHistogram -> (список)

Гистограмма, отображающая распределение продолжительности работы службы.

(структура)

Элемент гистограммы для статистики. Гистограмма отображает диапазон наблюдаемых значений на оси X и частоту каждого значения на оси Y.

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

Значение элемента.

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

Частота элемента.

ResponseTimeHistogram -> (список)

Гистограмма, отображающая распределение времени ответа службы.

(структура)

Элемент гистограммы для статистики. Гистограмма отображает диапазон наблюдаемых значений на оси X и частоту каждого значения на оси Y.

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

Значение элемента.

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

Частота элемента.

NextToken -> (строка)

Токен пагинации.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API