Компонент модуля мониторинга/хранения логов (VLogs) (shturval-metrics-collector)
О сервисе
| Параметр | Значение |
|---|---|
| Название в интерфейсе | Модуль мониторинга. Компонент управления модуля мониторинга |
| Системное название (идентификатор) | shturval-metrics-collector |
| Назначение в кластере | Сбор системных метрик, отправка в VictoriaMetrics; маршрутизация событий и отправка оповещений (компоненты VM Аlert и VM Аlert Manager); развёртывание экземпляра хранения логов VictoriaLogs (компонент VM Agent). |
| Критический | Нет |
| Публичный репозиторий | Victoria Metrics Agent (vmagent) |
| Зависимости | shturval-local-csi, shturval-cert-manager, shturval-metrics-collector-crds, shturval-monitoring-crds |
| Неймспейс | victoria-metrics |
Назначение
shturval-metrics-collector — компонент обеспечивает локальный сбор метрик и отправку их в VictoriaMetrics кластера управления. В составе чарта также развёртываются VM Alert (формирование оповещений) и VM Alert Manager (маршрутизация и доставка уведомлений). Компонент управляет развёртыванием экземпляров VictoriaLogs для хранения логов (подробнее — ниже).
Подробнее — Архитектура мониторинга.
Особенности
- Устанавливается в кластер управления и в каждый клиентский кластер;
- Метрики отображаются в Grafana (кнопка «Статистика» на дашборде кластера); см. Предустановленные дашборды.
- Поддержка перенаправления метрик во внешний кластер VictoriaMetrics — см. Как перенаправить метрики.
- Управляет развёртыванием экземпляров VictoriaLogs для логов — см. раздел VictoriaLogs ниже.
Установка и зависимости
Уже установленный сервис: Сервисы и репозитории → Установленные сервисы → Модуль мониторинга. Компонент управления модуля мониторинга → Управлять.
Если сервис отсутствует: Сервисы и репозитории → Доступные чарты → вкладка shturval → чарт shturval-metrics-collector → Установить. Выберите версию чарта и неймспейс victoria-metrics. Параметры укажите в блоке Спецификация сервиса (customvalues) или через ShturvalServicePatch после установки. Общий сценарий — Как развернуть новый сервис.
Обратите внимание! Важно Для корректной работы мониторинга в клиентском кластере:
- в клиентском кластере должен работать
shturval-metrics-collector-crds(Модуль мониторинга. CRD компонента управления CR модуля мониторинга); - в кластере управления —
shturval-metrics-collectorиshturval-metrics-collector-crds,shturval-monitoring.
Конфигурация VM Agent
Базовая настройка VM Agent:
- определяет задания сбора (
scrape jobs) с периодичностьюscrapeIntervalи таймаутомscrapeTimeout; - определяет лимиты и requests CPU/RAM для VM Agent, VictoriaMetrics Operator и вспомогательных сервисов (node-exporter, kube-state-metrics).
Пример: периодичность и таймаут сбора
vmagent:
enabled: true
spec:
scrapeInterval: <ваше значение параметра>
vmScrape:
kind: VMNodeScrape
spec:
scrapeTimeout: <ваше значение параметра>
| Параметр | Описание | Тип данных | По умолчанию |
|---|---|---|---|
scrapeInterval |
Периодичность сбора метрик | string | 20s |
scrapeTimeout |
Таймаут, по истечении которого завершится сбор метрик | string | 5s |
Пример customvalues: Вычислительные ресурсы для VM Agent
vmagent:
enabled: true
resources:
limits:
cpu: <ваше значение параметра>
memory: <ваше значение параметра>
requests:
cpu: <ваше значение параметра>
memory: <ваше значение параметра>
| Параметр | Описание | Тип данных | Пример |
|---|---|---|---|
limits.cpu |
Ограничение CPU для VM Agent | string | 1 |
limits.memory |
Ограничение памяти для VM Agent | string | 1Gi |
requests.cpu |
Запрос CPU для VM Agent | string | 50m |
requests.memory |
Запрос памяти для VM Agent | string | 50Mi |
Селекторы и лейблы
Базовый мониторинг настроен с помощью лейблов. При необходимости присвойте сервису лейбл, чтобы он попал в список объектов для мониторинга, или настройте селекторы неймспейсов и целей.
Приме: селекторы неймспейсов и целей
vmagent:
spec:
selectAllByDefault: false
nodeScrapeNamespaceSelector: # Селектор для неймспейсов, из которых будут собираться метрики
matchLabels:
shturval.tech/system-namespace: ''
nodeScrapeSelector: {} # Селектор выбора узлов кластера, с которых будут собираться метрики
podScrapeNamespaceSelector: # Селектор выбора подов, из которых будут собираться метрики
matchLabels:
shturval.tech/system-namespace: ''
podScrapeSelector: {} # Селектор выбора подов, из которых будут собираться метрики
probeNamespaceSelector:
matchLabels:
shturval.tech/system-namespace: ''
probeSelector: {}
serviceScrapeNamespaceSelector: # Селектор для сервисов, из которых будут собираться метрики
matchLabels:
shturval.tech/system-namespace: ''
serviceScrapeSelector: {} # Селектор для сервисов, из которых будут собираться метрики
staticScrapeNamespaceSelector: # Селектор для статических объектов, из которых будут собираться метрики
matchLabels:
shturval.tech/system-namespace: ''
staticScrapeSelector: {} ## Селектор для статических объектов, из которых будут собираться метрики
VictoriaLogs
Централизованное хранение логов выполняется в VictoriaLogs. Архитектурно данные размещаются в кластере управления: для каждого кластера (клиентского и управления) создаётся отдельный экземпляр VictoriaLogs - VLSingle в неймспейсе с именем соответствующего кластера. Развёртыванием экземпляров управляет shturval-metrics-collector. Сбор логов выполняет shturval-log-collector (Vector).
Подробнее — Архитектура сервисов логирования, Как смотреть логи в платформе, Как настроить ротацию логов, Устранение неполадок со сбором логов
Дополнительно
Чарт shturval-metrics-collector используется в кластере управления и в каждом клиентском кластере. Ниже — инструкции, в которых он фигурирует.
Настройка через ShturvalServicePatch
- Как управлять CustomValues сервисов — общий порядок работы с SSP;
- Как перенаправить метрики —
shturvalServiceConfigName: shturval-metrics-collector, внешний VictoriaMetrics; - Как настроить локальный алертинг в кластере — локальные VM Single, VMAlert и Alertmanager через SSP.
Алертинг
- Настройка алертинга — условия работы оповещений по метрикам;
- Оповещения — обзор раздела;
- Как настроить алертинг по логам — VMRule и VMAlert для VictoriaLogs.
Прикладной мониторинг
- Прикладной мониторинг — обзор раздела;
- Требования к приложениям — что должно быть в кластере и у приложения;
- Как настроить прикладной мониторинг — VMSingle и VMAgent в
user-monitoring; - Как проверить прикладной мониторинг — проверка на demo-app;
- Как перенаправить прикладные метрики — remoteWrite во внешнее хранилище.
Визуализация
- Как добавить свой дашборд в Grafana — кастомные дашборды (метрики из цепочки VM Agent → VictoriaMetrics).