start-live-tail

Описание

Запускает сеанс потоковой передачи Live Tail для одной или нескольких групп журналов. Сеанс Live Tail обеспечивает практически реальное время потоковой передачи событий журналов по мере их поступления в выбранные группы журналов. Сеанс может продолжаться максимум 3 часа.

По умолчанию эта команда запускает сеанс обычного слежения, где недавние события журналов отображаются снизу вверх, а события журналов выводятся в обычном текстовом формате. Вы можете запустить эту команду с параметром –mode interactive, чтобы запустить интерактивный сеанс слежения. Интерактивное слежение позволяет выделить до 5 терминов в ваших журналах. Коды уровня важности выделяются по умолчанию. Журналы выводятся в формате JSON, если это возможно, но могут быть переключены на обычный текст по желанию. Интерактивный режим отключен, если –color задан как off или если вывод не поддерживает цвет.

Вы должны иметь разрешение logs:StartLiveTail, чтобы выполнить эту операцию. Если событий журналов, соответствующих фильтрам, больше 500 событий в секунду, мы осуществляем выборку событий, чтобы обеспечить опыт реального времени.

Если вы используете облачную наблюдаемость CloudWatch между учетными записями, вы можете использовать эту операцию в учетной записи мониторинга и начать слежение за группой(группами) журналов, присутствующей в связанных источниковых учетных записях. Для получения дополнительной информации см. https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html.

Сеансы Live Tail взимают плату за время использования сеанса за минуту. Подробные сведения о ценообразовании см. на сайте https://aws.amazon.com/cloudwatch/pricing/.

Синтаксис

  start-live-tail
--log-group-identifiers <value> [<value>...]
[--log-stream-names <value> [<value>...]]
[--log-stream-name-prefixes <value> [<value>...]]
[--log-event-filter-pattern <value>]
[--mode <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-identifiers (список) Идентификаторы группы журналов — это ARN для групп журналов CloudWatch, за которыми необходимо следить. Вы можете указать до 10 идентификаторов группы журналов. Журналы можно отфильтровать по потоку(потокам) журналов, указав –log-stream-names или –log-stream-name-prefixes. Если указано более одной группы журналов, –log-stream-names и –log-stream-name-prefixes отключаются. –log-stream-names и –log-stream-name-prefixes не могут быть указаны одновременно. Примечание: ARN группы журналов должен иметь следующий формат. Замените REGION и ACCOUNT_ID на свой регион и идентификатор учетной записи. arn:aws:logs:REGION :ACCOUNT_ID :log-group:LOG_GROUP_NAME. :* после ARN запрещено.Для получения дополнительной информации о формате ARN см. ресурсы и операции CloudWatch Logs .(строка)

Синтаксис:

"string" "string" ...

--log-stream-names (список) Список имен потоков для фильтрации журналов. Этот параметр нельзя указывать, когда также указаны –log-stream-name-prefixes. Этот параметр нельзя указывать, когда указано несколько идентификаторов групп журналов(строка)

Синтаксис:

"string" "string" ...

--log-stream-name-prefixes (список) Префикс для фильтрации журналов. Будут возвращены только события из потоков журналов, имена которых начинаются с этого префикса. Этот параметр нельзя указывать, когда также указаны –log-stream-names. Этот параметр нельзя указывать, когда указано несколько идентификаторов групп журналов(строка)

Синтаксис:

"string" "string" ...

--log-event-filter-pattern (строка) Шаблон фильтра, который нужно использовать. Подробности см. в разделе Синтаксис фильтра и шаблона. Если не указано, все события соответствуют. Этот параметр можно использовать для включения или исключения событий журналов по шаблонам. Кроме того, при указании нескольких шаблонов фильтров они должны быть заключены в кавычки.

--mode (строка) Команда поддерживает следующие режимы:

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

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

Примеры

Следующая команда запускает сеанс Live Tail для группы журналов под названием my-logs:

aws logs start-live-tail --log-group-identifiers arn:aws:logs:us-east-1:111111222222:log-group:my-logs

Следующая команда запускает сеанс Live Tail для группы журналов под названием my-logs в интерактивном режиме:

aws logs start-live-tail --log-group-identifiers arn:aws:logs:us-east-1:111111222222:log-group:my-logs --mode interactive

В интерактивном режиме вы можете выделить до пяти терминов в журналах, за которыми ведется слежение. Коды уровня важности выделяются по умолчанию. Нажмите h, чтобы войти в режим выделения, затем введите термины, которые нужно выделить, по одному за раз, и нажмите Enter. Нажмите c, чтобы очистить выделенный(ые) термин(ы). Нажмите t, чтобы переключить форматирование между JSON/обычным текстом. Нажмите Esc, чтобы выйти из сеанса Live Tail. Нажмите up / down, чтобы прокрутить вверх или вниз по событиям журналов, используйте Ctrl + u / Ctrl + d для более быстрого прокручивания. Нажмите q, чтобы прокрутить до последних событий журналов.