Модуль fetchResource

    О модуле

    Модуль fetchResource позволяет собирать разнородные целочисленные данные с хостов, которые поставляются датчиком. Датчик - это скрипт который получает конфиг от сервера и обрабатывает его. Если скрипт "знает" как обработать тип датчика из конфига, то он его обрабатывает, иначе пропускает.

    Возможности

    • Сбор и отправка дополнительной информации с хоста

    Использование

    Важно! Используется Python 3.

    Открыв хост на редактирование, ему можно добавить датчик.

    п/п Параметр Описание
    1 Тип датчика Наименование типа датчика
    2 Доп. параметры команды

    Эти параметры будут переданы датчику. Например, если датчик проверяет существование каталога - то доп. параметром будет путь до этого каталога.

    Если датчик не предполагает доп.параметров, это поле следует оставить пустым.
    3 Период опроса Периодичность опроса. Если поле заполнено, то будет использовать периодический опрос. То есть если установить цифру 5, то каждые пять минут будут отправлятся данные с датчика. То есть будет произведен замер показаний датчика и будет отправка.
    4 Единоразовый опрос (время)

    Если опрос надо проводить в конкретное время, то его нужно задать здесь. Например, если задать "21 10", то опрос будет проходить в 21 час, 10 минут.

    Маска - ЧЧ (пробел) ММ. При этом если число не двузначное, то оно пишется без лидирующего нуля.

    Например, 9 15 - это 9 часов, 15 минут.

    21 9 - это 21 час, девять минут. Если указать 21 09, датчик не поймет.
    5 Комментарий

    Комментарий к датчику. Его можно будет использовать в фильтрации например.

    Типы датчиков.

    п/п ОС Тип датчика Описание
    1 linux linux_dirExist

    Возвращает 0 если каталог не существует и 1 если каталог существует.

    Принимает в качестве доп.параметра путь до каталога, например /backup/database
    2 linux linux_dirSize

    Возвращает размер каталога в мегабайтах, целое число. Если каталог не существует - возвращает 0.

    Принимает в качестве доп.параметра путь до каталога, например /backup/database
    После добавления датчика необходимо разместить датчик (hle_sensor.py) на целевом хосте и сконфигурировать его.
    #config sensor
    #путь до сервера AlertsOnWings например http://192.168.1.9/hle2
    http_server_aw="http://localhost/hle2"

    #IP host where sensor is installed
    host_sensor="192.168.1.15"

    #api key to access API
    apikey = "dme-q1we-lele"

    #config sensor end
    п/п Параметр Описание
    1 http_server_aw путь до сервера с AlertsOnWings.
    2 apikey

    это ключ доступа к данным. Значение по умолчанию надо изменить. Сделано это в целях надежды, что злоумышленники не проникли. Конечно, защита эта от честного человека, но хотя бы так.

    Важно! Ключ должен совпадать с ключом в файле api/apikey.php
    3 host_sensor

    IP адрес хоста, где размещен датчик.
    После конфигурирования запусти скрипт. Он должен получить конфиг с сервера.

    Чтобы запустить скрипт автономно - можно создать юнит в systemd.
    Хотя каждый сам решает как  сделать лучше.

    Идеи, баги, вопросы?

    Сообщи нам t.me/screensquid