Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • Машинное обучение
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Истории успеха
    • Тарифы Yandex Cloud
    • Промоакции и free tier
    • Правила тарификации
  • Документация
  • Блог
Проект Яндекса
© 2025 ООО «Яндекс.Облако»
Yandex Cloud Logging
  • Начало работы
    • Лог-группа
    • Язык фильтрующих выражений
    • Квоты и лимиты
  • Управление доступом
  • Правила тарификации
  • Справочник Terraform
  • Метрики Monitoring
  • Аудитные логи Audit Trails
  • Вопросы и ответы
  • Обучающие курсы

В этой статье:

  • Как задать фильтр
  • Параметры фильтров
  • Требования к значению параметра
  • Поиск вхождений
  • Операции сравнения
  • Фильтры с несколькими условиями
  • Порядок вычислений
  1. Концепции
  2. Язык фильтрующих выражений

Язык фильтрующих выражений

Статья создана
Yandex Cloud
Улучшена
mmerihsesh
Обновлена 20 мая 2025 г.
  • Как задать фильтр
  • Параметры фильтров
    • Требования к значению параметра
    • Поиск вхождений
  • Операции сравнения
  • Фильтры с несколькими условиями
  • Порядок вычислений

Записи в лог-группе можно фильтровать, используя язык фильтрующих выражений. Язык фильтрующих выражений позволяет:

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

Как задать фильтрКак задать фильтр

Консоль управления
CLI
API
  1. В консоли управления перейдите в каталог, в котором находится лог-группа.
  2. Выберите сервис Cloud Logging.
  3. Перейдите на вкладку Группы.
  4. Нажмите на строку с лог-группой, записи в которой хотите отфильтровать.
  5. Перейдите на вкладку Логи.
  6. Введите фильтр и нажмите Enter.

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

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Чтобы задать фильтр с помощью языка фильтрующих выражений, выполните команду:

yc logging read --group-name=default --filter="<фильтр>"

Примечание

Можно одновременно фильтровать записи с помощью параметра --filter и других параметров команды yc logging read. Тогда условия объединятся с помощью оператора AND. Например, можно задать фильтр, используя параметр --resource-types и свойство level параметра --filter:

yc logging read --group-name=default --resource-types=serverless.function --filter="level=INFO"

Такой фильтр выведет записи с уровнем логирования INFO, которые отправлены за последний час функциями Cloud Functions.

Задать фильтр можно с помощью вызова gRPC API LogReadingService/Read.

Примеры фильтровПримеры фильтров

  • Записи, в сообщениях которых есть warning или error dialing endpoint:
    message: warning "error dialing endpoint"
    
  • Записи, созданные после 8 июня 2023 года:
    timestamp > "2023-06-08T00:00:00Z"
    
  • Записи, уровень логирования которых выше или равен INFO:
    level >= INFO
    

Параметры фильтровПараметры фильтров

Параметр Формат фильтра Описание Пример фильтра
message параметр: "значение" Поиск записей, в сообщениях которых есть заданные значения. message является параметром по умолчанию, поэтому в запросе его можно не указывать. "Hello world!" Error Exception
resource_type параметр: "значение"
параметр <операция сравнения> "значение"
Поиск записей, отправленных ресурсами заданного типа, например функциями. resource_type = "serverless.function"
resource_id параметр: "значение"
параметр <операция сравнения> "значение"
Поиск записей, отправленных ресурсом с заданным идентификатором. resource_id: "d4e155orh3nu********"
json_payload параметр: "значение" Поиск записей, в json_payload которых есть заданные значения. Осуществляется по тексту. json_payload: "error"
json_payload.<элемент> параметр: "значение"
параметр <операция сравнения> "значение"
Поиск записей по элементам json_payload. Если в фильтре используется операция сравнения, элемент может быть строкой, числом или логическим значением, в противном случае — только строкой. Префикс json_payload можно не указывать, если корневой элемент дерева не совпадает ни с одним из параметров. Проверить существование элемента в json_payload можно с помощью оператора EXISTS. Например: json_payload.result EXISTS. Такой фильтр выведет записи, в json_payload которых есть элемент result. json_payload.flag = FALSE
timestamp параметр <операция сравнения> "значение" Поиск записей, созданных в заданный промежуток времени. timestamp >= "2023-06-08T00:00:00Z"
ingested_at параметр <операция сравнения> "значение" Поиск записей, доставленных в заданный промежуток времени в систему логирования Cloud Logging. ingested_at = "2023-06-22T05:15:03Z"
saved_at параметр <операция сравнения> "значение" Поиск записей, сохраненных в заданный промежуток времени в базу данных Cloud Logging. saved_at >= 1622198048
level параметр <операция сравнения> "значение" Поиск записей с заданными уровнями логирования. Доступные уровни логирования — TRACE, DEBUG, INFO, WARN, ERROR, FATAL. level >= WARN
stream_name параметр <операция сравнения> "значение" Поиск записей по потокам логирования, которые были определены пользователем. stream_name = input
request_id параметр <операция сравнения> "значение" Поиск записей по идентификатору запроса в json_playload. request_id <= "145"

Требования к значению параметраТребования к значению параметра

Можно не брать значение в кавычки, если оно:

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

TRUE, FALSE, true и false используются для логических значений. Нужно заключить их в кавычки, чтобы найти в тексте.

Доступные типы значений для параметров timestamp, ingested_at и saved_at:

  • строка в формате RFC3339:
    saved_at > "2023-05-28T15:20:31Z"
    
  • число секунд после 00:00 1970-01-01:
    saved_at >= 1622198048
    

Поиск вхожденийПоиск вхождений

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

параметр: "значение1" "значение2" "значение3"

Чтобы искать значения с учетом регистра, используйте оператор :!

параметр:! "знаЧеНие1" "значЕнИе2"

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

Операции сравненияОперации сравнения

Кроме проверки на точное совпадение, язык фильтрующих выражений поддерживает операции сравнения:

  • Равно

    параметр = "значение"
    
  • Не равно

    параметр <> "значение"
    
  • Больше, Меньше, Меньше или равно, Больше или равно

    параметр > "значение"
    параметр < "значение"
    параметр >= "значение"
    параметр <= "значение"
    

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

Фильтры с несколькими условиямиФильтры с несколькими условиями

Объединить несколько условий в одном фильтре можно с помощью логических операторов:

  • AND — логический оператор И. Условия, объединенные таким оператором, должны выполняться одновременно.

    Пример:

    параметр1: "значение1" AND параметр2: "значение2"
    

    Такой запрос выведет записи, у которых параметр1 имеет значение1 и параметр2 имеет значение2.

  • OR — логический оператор ИЛИ. Должно выполняться хотя бы одно из условий, объединенных таким оператором.

    Пример:

    параметр1: "значение1" OR параметр2 > "значение2"
    

    Такой запрос выведет записи, у которых выполнено хотя бы одно из условий: параметр1 имеет значение1 или параметр2 больше значение2.

  • NOT — логический оператор НЕ. Должно выполняться условие, обратное заданному.

    Пример:

    NOT параметр1: "значение1"
    

    Такой запрос выведет записи, у которых параметр1 имеет значение, отличное отзначение1.

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

параметр1: "значение1" AND параметр2: "значение2" OR параметр3: "значение3"

Порядок вычисленийПорядок вычислений

  • Поиск вхождений, операции сравнения, оператор EXISTS
  • Логический оператор NOT
  • Логический оператор AND
  • Логический оператор OR

Изменить порядок вычислений можно с помощью скобок:

параметр1: "значение1" AND (параметр2 = "значение2" OR параметр3 < "значение3")

Была ли статья полезна?

Предыдущая
Лог-группа
Следующая
Квоты и лимиты
Проект Яндекса
© 2025 ООО «Яндекс.Облако»