Подключиться
Yandex Cloud Logging

Чтение записей

Статья создана
,
улучшена

    Максимальный срок хранения записей — 3 дня. Время в журнале указано по UTC.

    Вы можете отфильтровать записи с помощью языка фильтрующих выражений.

    1. В консоли управления перейдите в каталог, в котором находится лог-группа.
    2. Выберите сервис Cloud Logging.
    3. Нажмите на строку с лог-группой, записи в которой хотите посмотреть.
    4. На открывшейся странице отобразятся записи.

    Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

    По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

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

    Использование флагов:

    • --since — момент времени N и позже.
    • --until — момент времени N и раньше.

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

    Допустимые форматы указания времени:

    • ЧЧ:ММ:СС. Например, 15:04:05.
    • RFC-3339. Например: 2006-01-02T15:04:05Z, 2h, 3h30m ago.

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

    Ограничить количество выводимых записей можно с помощью флага --limit. Допустимые значения — от 1 до 1000.

    Чтобы посмотреть записи в формате JSON, выполните команду:

    yc logging read --group-name=default --format=json

    Результат:

    [
  {
    "uid": "488ece3c-75b8-4d35-95ac-2b491b123472",
    "resource": {},
    "timestamp": "2021-06-22T02:10:40Z",
    "ingested_at": "2021-06-22T08:49:15.716Z",
    "saved_at": "2021-06-22T08:49:16.176097Z",
    "level": "INFO",
    "message": "My message",
    "json_payload": {
      "request_id": "1234"
    }
  }
]

    Чтобы читать записи по мере их поступления, используйте флаг --follow:

    yc logging read --group-name=default --follow

    Такая команда выведет записи за последний час и продолжит выводить новые до тех пор, пока вы не прервете ее, нажав Ctrl + C. Флаг --follow не совместим с флагами --since и --until.

    Посмотреть записи в лог-группе можно с помощью метода API read.