Дополнительные метрики утилизации

Сбор метрик утилизации осуществляется двумя способами:

Плагины utlz_exporter_v0 и utlz_exporter собирают метрики утилизации самостоятельно.
vision_utilizer получает значения метрик от плагина node_exporter и пересчитывает их. Сервер VictoriaMetrics, в свою очередь, обращается к vision_utilizer для получения действующих значений метрик.

Эта инструкция неприменима к окружениям, в которых сервер VictoriaMetrics развёрнут в отказоустойчивой конфигурации, так как в этом случае он не обращается к vision_utilizer.

Настройка сбора метрик через vision_utilizer

vision_utilizer использует для пересчёта полученных от node_exporter метрик настройки, заданные в конфигурационном файле /opt/skala-r/etc/vision/server/vision_utilizer/config.yml.

Этот файл заполняется по шаблону:

queries:
  cpu_usage: <cpu_usage_query> # utlz_cpu_usage
  cpu_cores: <cpu_cores_query> # utlz_cpu_cores
  ram_total: <ram_total_query> # utlz_ram_total
  ram_used:  <ram_used_query>  # utlz_ram_used
  rom_total: <rom_total_query> # utlz_disk_total
  rom_used:  <rom_used_query>  # utlz_disk_used
objects:
  - node_id: "<node_id_or_name>"
    cpu:
      cores: # utlz_cpu_cores
        # ...
      used:  # utlz_cpu_usage
        # ...
    ram:
      total: # utlz_ram_total
        # ...
      used:  # utlz_ram_used
        # ...
    rom:
      - type: # Тип диска
        mountpoints:
          # - Список
          # - точек
          # - монтирования
        total: # utlz_disk_total
        used:  # utlz_disk_used
    # ...

<metric>:
  enable: <enable>
  factor: <factor>
  add: <add>
  set: <set>

Здесь:

<cpu_usage_query> — запрос PromQL для получения данных об утилизации ресурсов CPU.
<cpu_cores_query> — запрос PromQL для получения данных о количестве ядер CPU.
<ram_total_query> и <ram_used_query> — запросы PromQL для получения данных о количестве установленной и использумой RAM соответственно.
<rom_total> и <rom_used> — запросы PromQL для получения данных о размере дискового хранилища и количестве занятого в нём пространства.
<node_id> — идентификатор узла.
<metric> — название метрики.
<enable> — обязательный параметр, управляющий сбором метрики:
- true — включен;
- false — выключен.
<factor> — необязательный множитель значения метрики для объекта. Значение должно быть целым или дробным числом.
<add> — необязательное слагаемое, прибавляемое к значению метрики.
<set> — необязательный параметр, устанавливающий значение метрики для объекта. Значение должно быть целым или дробным числом.

Пример заполнения

queries:
  cpu_usage: "avg without (mode,cpu) (1 - rate(node_cpu_seconds_total{mode=\"idle\"}[15s])) * 100"
  cpu_cores: "count without(cpu, mode) (node_cpu_seconds_total{mode=\"idle\"})"
  ram_total: "round(node_memory_MemTotal_bytes)"
  ram_used: "node_memory_MemTotal_bytes - node_memory_MemAvailable_bytes"
  rom_total: "node_filesystem_size_bytes"
  rom_used: "node_filesystem_size_bytes - node_filesystem_free_bytes"
objects:
  - node_id: PG-PRD-3-MDL-BS-01-N-199
    cpu:
      cores:
        enable: true
      used:
        enable: true
    ram:
      total:
        enable: true
      used:
        enable: true
    rom:
      - type: "NVME"
        mountpoints:
          - /var/lib/libvirt/images
          - /run
        total:
          enable: true
          factor: 2
        used:
          enable: true

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

Установите плагин node_exporter на узлы, метрики которых будут обрабатываться с помощью vision_utilizer.
Для нужного ПАК сформируйте инвентори-файл.
Внесите изменения в сформированный инвентори-файл:
- Оставьте только те узлы, метрики которых будете обрабатывать с помощью vision_utilizer.
- Укажите учётные данные для подключения к узлам по SSH.
Перейдите в корневую директорию дистрибутива, а из неё — в директорию utilizer/.
Выполните команду:
bash config_utilizer.sh /path/to/inventory
Здесь /path/to/inventory — полный путь к инвентори-файлу, сформированному на шаге 2.

Команда создаёт файл utilizer_<inventory>.yml в текущей директории.
В конфигурационном файле /opt/skala-r/etc/vision/server/vision_utilizer/config.yml замените значение параметра objects содержимым файла, созданного на предыдущем шаге.
Перезапустите сервис vision_utilizer:
```
systemctl restart vision_utilizer
```

Проверка корректности настроек

Если сервис vision_utilizer после перезапуска неактивен, изучите лог-файл /opt/skala-r/var/log/vision/server/vision_utilizer/vision_utilizer.log и устраните найденные ошибки конфигурации.

Для проверки успешности сбора метрик в интерфейсе Визион выполните запрос:

up{job="utilizer"}