Модуль локального сбора логов (shturval-log-collector)
О сервисе
| Параметр | Значение |
|---|---|
| Название в интерфейсе | Модуль локального сбора логов |
| Системное название (идентификатор) | shturval-log-collector |
| Назначение в кластере | Локальный сбор логов из stdout подов, journald, файла Kubernetes auditing и доставка в VictoriaLogs для хранения и поиска. Возможность перенаправления в Elasticsearch, syslog, SIEM. |
| Критический | Нет |
| Публичный репозиторий | Vector |
| Зависимости | shturval-log-collector-crds, shturval-local-csi |
| Неймспейс | logging |
Назначение
shturval-log-collector — модуль локального сбора логов на базе Vector: собирает логи в кластере, агрегирует и передаёт логи в экземпляр VictoriaLogs в кластере управления.
Vector — инструмент с открытым исходным кодом на Rust. В архитектуре Vector три типа компонентов: sources (источники), transforms (преобразования) и sinks (получатели). Документация — vector.dev/docs.
Подробнее - Архитектура логирования — компоненты и потоки данных. Как смотреть логи в платформе.
Обратите внимание! для корректной работы shturval-log-collector должен быть включён CRD shturval-log-collector-crds.
Установка и базовая настройка
Если установлен в кластере: Сервисы и репозитории → Установленные сервисы → найдите Модуль локального сбора логов → Управлять.
Если модуль отсутствует в установленных:
- Сервисы и репозитории → Доступные чарты → вкладка shturval → найдите чарт
shturval-log-collector-crds. - Если CRD-чарт ещё не установлен, установите
shturval-log-collector-crdsи дождитесь успешного статуса на странице Установленные сервисы. - На странице Доступные чарты выберите чарт
shturval-log-collectorи нажмите Установить. - Выберите версию чарта, неймспейс
loggingи режим управления Авто. - После выбора версии чарта справа отобразятся Доступные параметры конфигурации для сервиса (values). При необходимости задайте параметры в блоке Спецификация сервиса.
Режим Авто подходит для штатной установки и настройки через ShturvalServicePatch: платформа применяет базовую конфигурацию чарта и накладывает ваши патчи на customvalues.
Режим Ручной используйте только для сценариев, где вы управляете ресурсами логирования вручную, например, изменяете системные ClusterVectorPipeline. В этом режиме автоматическое применение поставляемой конфигурации ограничено, поэтому для обычного добавления получателей логов во внешние системы он не требуется.
Общий порядок — Как развернуть новый сервис.
После установки проверьте базовую работу:
- Откройте кластер → Сервисы и репозитории → Установленные сервисы → Модуль локального сбора логов. На странице сервиса статусы должны быть успешными. Подробнее о статусах см. в разделе Условия: ShturvalServiceConfig.
- В разделе Администрирование → Кастомные ресурсы → API-группа
observability.kaasops.ioдолжны отображаться преднастроенныеClusterVectorPipeline. - На дашборде кластера должна быть доступна вкладка Логи.
Vector Operator и кастомные ресурсы
Для настройки модуля локального сбора логов используется Vector Operator. Поддерживаемые кастомные ресурсы:
| Kind | Group | Version |
|---|---|---|
| ClusterVectorAggregator | observability.kaasops.io | v1alpha1 |
| ClusterVectorPipeline | observability.kaasops.io | v1alpha1 |
| Vector | observability.kaasops.io | v1alpha1 |
| VectorAggregator | observability.kaasops.io | v1alpha1 |
| VectorPipeline | observability.kaasops.io | v1alpha1 |
Базовая настройка включает преднастроенные ClusterVectorPipeline и Vector.
Просмотр в GUI: Администрирование → Кастомные ресурсы → API-группа observability.kaasops.io → ClusterVectorPipeline или Vector.
Обратите внимание! изменение базовой настройки может привести к ошибкам сбора, агрегации и анализа логов. Не изменяйте вручную преднастроенные системные ClusterVectorPipeline.
Таблица преднастроенных пайплайнов, пояснения к полям spec и пример YAML — на странице Сбор и обработка логов (ClusterVectorPipeline).