Skip to main content

Интеграция с Host

info

Перевод в процессе / Translation in progress. See русская версия.

Интеграция собирает системные метрики Linux-хоста (CPU, память, диск, сеть, файловые системы) и статусы systemd-юнитов. Данные читаются из /proc, /sys и D-Bus systemd через локальный агент без внешних экспортёров.

Предварительные требования​

  • Linux-хост с ядром ≥ 5.4 и systemd ≥ 245.
  • Агент Flaree установлен и запущен через systemctl (см. Установка systemd-сервиса).
  • Файловые системы /proc и /sys примонтированы и доступны пользователю flaree-agent (обычно default).
  • Пользователь агента входит в группу systemd-journal — для чтения статусов unit-ов и событий.
  • Токен агента передан через env-переменную ${FLAREE_TOKEN}.

Минимальная конфигурация​

Минимально — включить интеграцию и список базовых категорий метрик:

# agent.yaml
integrations:
  host:
    enabled: true
    metrics:
      - cpu
      - memory
      - disk

Полная конфигурация​

Полный набор опций — сеть, исключения файловых систем, список отслеживаемых юнитов и интервал сбора:

# agent.yaml
integrations:
  host:
    enabled: true
    interval: 15s

    metrics:
      - cpu
      - memory
      - disk
      - network
      - load
      - uptime

    # Сетевые интерфейсы
    network:
      include_interfaces:
        - eth0
        - ens*
      exclude_interfaces:
        - lo
        - docker0
        - br-*

    # Файловые системы
    filesystem_excludes:
      - tmpfs
      - devtmpfs
      - overlay
      - squashfs

    # systemd-юниты
    systemd_units:
      - flaree-agent.service
      - nginx.service
      - postgresql.service
      - docker.service

    # Опциональный Prometheus-compatible endpoint
    prometheus:
      enabled: true
      listen: 127.0.0.1:9100

    # Credentials
    token: ${FLAREE_TOKEN}
    endpoint: ${FLAREE_ENDPOINT}

Проверка работы​

  1. Проверьте, что сервис агента активен и в статусе active (running).
  2. Убедитесь, что локальный Prometheus-endpoint (если включён) отвечает и отдаёт метрики node_cpu_*, node_memory_*.
  3. Откройте дашборд Flaree и убедитесь, что хост виден с ненулевыми значениями CPU/Memory за последние 5 минут.
# Статус агента
systemctl status flaree-agent --no-pager

# Последние 50 строк журнала сервиса
journalctl -u flaree-agent -n 50 --no-pager

# Метрики хоста из локального endpoint
curl -sS http://127.0.0.1:9100/metrics | head -n 20

Troubleshooting​

tip

Не запускайте агент от root. Пользователь flaree-agent с членством в systemd-journal имеет ровно столько прав, сколько нужно для чтения метрик и журнала.