Spec-Zone.ru › AWS CLI v2

[ aws . logs ]

get-log-group-fields

Описание

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

Вы можете указать группу логов для поиска, используя либо logGroupIdentifier, либо logGroupName. Вы должны указать один из этих параметров, но не оба.

В результатах поля, начинающиеся с @, являются полями, сгенерированными CloudWatch Logs. Например, @timestamp — это метка времени каждого события лога. Дополнительную информацию о полях, сгенерированных CloudWatch Logs, см. в разделе Поддерживаемые логи и обнаруженные поля.

Результаты ответа отсортированы по проценту частоты, начиная с наибольшего процента.

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

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

Синтаксис

  get-log-group-fields
[--log-group-name <value>]
[--time <value>]
[--log-group-identifier <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]

Параметры

--log-group-name (строка)

Имя группы логов для поиска.

Примечание

Вы должны указать либо logGroupIdentifier, либо logGroupName, но не оба.

--time (целое)

Время, задаваемое в центре запроса. Если вы указываете time, будут просматриваться 8 минут до и 8 минут после этого времени. Если вы опускаете time, будут просматриваться последние 15 минут до текущего времени.

Значение time указывается как время эпохи, что является количеством секунд с момента January 1, 1970, 00:00:00 UTC.

--log-group-identifier (строка)

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

Примечание

Вы должны указать либо logGroupIdentifier, либо logGroupName, но не оба.

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

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

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

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

Включает отладочную запись.

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

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

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

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

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

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

--output (строка)

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

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

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • вкл
  • выкл
  • авто

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

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

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

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

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

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

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

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

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

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

  • base64
  • raw-in-base64-out

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

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

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

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

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

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

Вывод

logGroupFields -> (список)

Массив полей, найденных в запросе. Каждый объект в массиве содержит имя поля и процент времени, в течение которого оно встречалось в событиях логов, которые были запрошены.

(структура)

Поля, содержащиеся в событиях логов, найденных операцией GetLogGroupFields, а также процент запрошенных событий логов, в которых появляется каждое поле.

name -> (строка)

Имя поля лога.

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

Процент запрошенных событий логов, содержащих поле.

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

Spec-Zone.ru

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