Логи в платформе

Вкладка «Логи» в дашборде кластера.

Логи кластера доступны в GUI на вкладке Логи дашборда кластера, если:

  1. В кластере включён модуль локального сбора логов (shturval-log-collector, Vector);
  2. В кластере управления работает shturval-metrics-collector.

Где смотреть

В боковом меню кластера: Дашборд → вкладка Логи.

Вкладка «Логи» — одна из вкладок дашборда развёрнутого кластера (наряду с Кластер, Аннотации, События, Сертификаты, Метеринг). Данные обновляются автоматически.

Вкладка «Логи» в дашборде кластера

Просмотр логов

Фильтрация по ProjectID (типы логов)

В VictoriaLogs логи сгруппированы по проектам. Число в колонке ProjectID совпадает с заголовком ProjectID в request.headers у platform_logs_sink модуля shturval-log-collector. При переопределении values (/ru2/cluster-admin/services/custom-values/) номера могут измениться.

Проект в UI ProjectID Описание
kube system namespaces 1 Системные логи /var/log/containers/*.log
cluster namespace 2 Пользовательские неймспейсы; отдельный поток в values, по умолчанию отключён
kube events 3 События объектов кластера
kube audit 4 Аудит API Kubernetes
journald 5 shturvald, containerd, kubelet
auditd 6 Системный аудит

Логи в проектах сгруппированы по стримам (stream) — наборам логов с уникальным набором параметров. Наименование стрима соответствует значению поля _stream. В интерфейсе отображаются счётчики по количеству логов и стримов в проекте.

Обратите внимание! Логи аутентификации, авторизации, назначения прав доступа, а также логи, связанные с инфраструктурой, находятся в кластере управления. Подробнее — Обзор логов безопасности в интерфейсе.

При включённых расширенных настройках безопасности в кластере создаётся проект kube audit с событиями согласно настроенной политике аудита (AuditPolicy). Проверить наличие расширенных настроек можно на вкладке «Кластер» дашборда.

Временной диапазон

Доступны предустановленные диапазоны:

  • за последние 15 минут;
  • за последние 30 минут;
  • за последний час (по умолчанию);
  • за весь день;
  • за выбранный диапазон времени.

Поиск логов

Поиск по тексту

Используйте шаблон параметр:значение через двоеточие и без пробелов. Несколько ключей через разделитель |. Поиск выполняется внутри выбранного ProjectID в выборке, соответствующей временному диапазону.

Примеры запросов:

kubernetes.pod_name:shturval-local-csi-node-6g6nh
kubernetes.pod_name:shturval-local-csi-node
message.level:warning | message.id:1
kubernetes.namespace_name:default

Поиск по параметрам

  1. Нажмите + рядом с заголовком Параметры поиска.
  2. Выберите поле, оператор и укажите значение.

Операторы:

Оператор Описание
AND (И) В выборку попадут логи, у которых есть заданное поле, включающее все перечисленные значения.. При одном значении работает как =.
OR (ИЛИ) В выборку попадут логи, у которых есть заданное поле, включающее как минимум одно из перечисленных значений. При одном значении работает как =.
NOT (НЕТ) Исключает логи с заданным полем, содержащим перечисленные значения.
= (Равно) в выборку попадут логи с заданным полем и соответствующим значением. Когда перечислено несколько значений, оператор работает по принципу логического AND (И).

Особенности:

  • Параметры фильтрации объединены по принципу AND. Например, message.level=warning и message.id=1 — отобразятся логи, соответствующие обоим условиям.
  • Перечень полей для параметров формируется по проекту, временному диапазону и поиску по тексту. Если нужного поля нет — измените фильтры.
  • Поиск по параметрам поддерживает частичное совпадение в значениях полей, кроме специальных параметров. Например, kubernetes.pod_name=kub найдёт логи, где поле содержит kub.

Специальные параметры (поиск только по точному, полному совпадению, по одному значению):

Поле Требование Пример
_stream_id Указать полностью, без дополнительных символов 000000e2f41194
_stream Задать в фигурных скобках {}. Один параметр или несколько через запятую {kubernetes.container_name="config-reloader"}
_time Указать полностью. Для выборки по времени используйте настройку временного диапазона 2026-01-13T10:02:09.393429156Z

Поиск по параметрам и по тексту одновременно объединяется оператором AND.

Скачивание логов

Доступно скачивание:

  • полного log-файла;
  • логов с учётом настроенных фильтров.

Файл сохраняется с расширением .log. Имя формируется автоматически: префикс Logs, дата загрузки и количество записей.

Доступно скачать последние 30 тыс. записей логов из текущей выборки.

Дополнительно

Перенаправление логов во внешние хранилища — Как интегрировать и перенаправить логи. Компоненты — Архитектура сервисов логирования. Ротация — Как настроить ротацию логов.

← Траблшутинг обновления
Траблшутинг логирования →