Для перемещения по дереву справки используйте строки заголовка.

Справка по NSG Linux 2.1.6
Дерево команд: services.event-handler.NUM.virt-sensor

Что это такое?

Это имя датчика.

Зачем это нужно?

Чтобы следить за показаниями этого датчика.

Как это настроить?

Введите имя объекта, который служит виртуальным датчиком. Виртуальный датчик в NSG Linux 2.1 — обобщённое понятие для любых объектов, за которыми возможно наблюдение. Это могут быть как физические датчики (подключённые по шине USB или 1–Wire), так и логические объекты в системе. В данной версии NSG Linux 2.1 предусмотрены следующие типы датчиков:

net.if.state[ИМЯ] или net.if.state[ХОСТ,ИМЯ]
Сетевой интерфейс с указанным именем. Возможные состояния для данных источников: up, down и no (интерфейс не существует в системе, например, интерфейс PPP или туннель в момент рестарта). В качестве имени может указываться любой из сетевых интерфейсов устройства, например, gre1 или br1.103.11. Если имя IP-интерфейса не совпадает с именем физического порта, например, интерфейс pppN (номер назначается динамически) и порт m1 (в который установлена опция 3G), то генерируются состояния с обоими именами, так что в обработчике событий можно использовать любое из них.
ПРИМЕЧАНИЕ. Интерфейсы Ethernet в Linux всегда считаются находящимися в состоянии UP, независимо от состояния их физического и канального уровней. Таким образом, для них датчик net.if.state не имеет смысла. Для контроля физического уровня следует использовать датчик net.if.lowerstate. Но, с другой стороны, физический уровень для них по существу редко бывает информативным, поскольку проблемы возникают с бóльшей вероятностью в последующих сегментах сети Ethernet. По этим причинам для портов Ethernet рекомендуется вместо net.if.state пользоваться процедурой netping и встроенным в неё генератором событий.
net.if.lowerstate[ИМЯ] или net.if.lowerstate[ХОСТ,ИМЯ]
Состояние физического уровня для портов Ethernet (флаг LOWER_UP). Возможные состояния: up, down.
net.if.in[ИМЯ] или net.if.in[ХОСТ,ИМЯ]
net.if.out[ИМЯ] или net.if.out[ХОСТ,ИМЯ]
Число принятых и переданных байт, соответственно, на указанном сетевом интерфейсе.
net.if.mostate[ИМЯ] или net.if.mostate[ХОСТ,ИМЯ]
Состояние подключения к указанному мобильному оператору: 1 — подключено хотя бы одним сотовым интерфейсом, 0 — не подключено.
ПРИМЕЧАНИЕ. Имя и формат имени вышеуказанных датчиков могут быть изменены в узле .services.event-handler.event-generators.iface.
system.hw.button
Аппаратная кнопка Service — выдаёт 1 при нажатии в течение заданного времени и 0 при отпускании. Подробнее см. описание.
ПРИМЕЧАНИЕ. В данной версии NSG Linux аппаратная кнопка как датчик поддерждивается только для изделия NSG–1700.
system.hw.power или system.hw.power[ХОСТ]
system.hw.voltage или system.hw.voltage[ХОСТ]
system.hw.battery или system.hw.battery[ХОСТ]
Состояние источника питания и встроенного аккумулятора устройства.
system.hw.ИМЯ
system.sw.ИМЯ
Разнообразные данные о состоянии системы в целом. По большей части, это инвентаризационные данные, такие как тип устройства, серийный номер, версия ПО и др.
УСТРОЙСТВО.ЦЕПЬ
Входы физических датчиков, подключённых к порту 1–Wire (либо внешнему адаптеру). Имя виртуального датчика составляется из идентификатора самого датчика и имени входа на нём. То и другое могут быть заданы в полях description таким образом, чтобы описать реальный смысл измеряемых величин:
  • Если для входной цепи датчика задано непустое имя, например, "Температура в подвале" или "Питание сервера", то оно и служит именем виртуального датчика.
  • Если для конкретной входной цепи имя не задано, но задано имя для всего датчика, то виртуальные датчики получают имена вида имяДатчика.А, имяДатчика.B, ... или имяДатчика.1, имяДатчика2, ... в зависимости от того, как технически именуются входы для данного типа датчиков. Технические имена указаны на корпусе и в описании датчика.
  • Если не задано ни имя датчика, ни имя входа, то имена датчиков составляются из идентификатора устройства, под которым оно фигурирует в списке device, и технического имени входа, например, swt2-3A6E0E0100000062.A.
На одном и том же датчике часть входов может иметь осмысленные названия, а часть — обходиться техническими.
ПОРТ.ПАРАМЕТР
Генераторы событий, встроенные в некоторые типы портов. Позволяют контролировать отдельные параметры физического уровня, такие как уровень сигнала в беспроводном интерфейсе. Для порта и для датчика могут быть заданы содержательные имена (префикс и суффикс, соответственно), например, matugalnik.gromkost (для порта 3G с SIM-картой Мегафон). Если они не заданы, то используются техническое имя порта и название параметра, соответственно — вида m1.CSQ.
netping.ИМЯ
Состояние заданной процедуры netping. Если ping (или заданный тестовый скрипт) выполнен успешно, то в обработчик событий посылается состояние restore (по умолчанию); если неуспешно — состояние failure. Названия обоих состояний могут быть изменены на более удобные. Для самого датчика также может быть назначено содержательное имя; если оно не задано, то имя составляется из префикса netping и имени конкретной пинговалки.
ПРИМЕЧАНИЕ. Начиная с версии 2.0.8, netping передаёт в обработчик событий именно своё состояние в результате каждой очередной попытки. При этом внутри самого netping, независимо от обработчика событий, отдельно детектируется событие как переход из одного состояния в другое, и выполняется заданный failure-script либо restore-script.
mercury230.ПАРАМЕТР
Параметры, измеряемые трёхфазным электрическим счётчиком Меркурий–230:
    COS-n    Косинус угла между током и напряжением для n-ой фазы
    COS-t    Суммарный косинус угла между током и напряжением
    E    Суммарная потреблённая энергия, нарастающим итогом
    F    Частота в электрической сети
    FU-mn    Угол между m-ой и n-ой фазами, при нормальной работе должен составлять по 120°
    I-n    Ток n-ой фазы
    P-n    Активная мощность n-ой фазы
    P-t    Суммарная активная мощность
    Q-n    Реактивная мощность n-ой фазы
    Q-t    Суммарная реактивная мощность
    S-n    Полная мощность n-ой фазы
    S-t    Суммарная полная мощность
    U-n    Напряжение n-ой фазы
По существу, электросчётчик представляет собой совокупность виртуальных датчиков — по каждому из параметров. Полное имя каждого виртуального датчика образуется из префикса mercury230 (при необходимости может быть изменён) и специфичного имени (одно из вышеперечисленных, или sensor-name вместо него), удобного для восприятия. Именно это имя фигурирует в настройке обработчика событий, а также в выводимых сообщениях и Web-мониторинге.
ms6.ДАТЧИК
Физические датчики, входящие в состав интегрированного датчика NSG MS–6. Имена датчиков:
    HUMI    Датчик относительной влажности воздуха, в процентах
    TEMP    Датчик температуры, в градусах Цельсия
    LUMI    Датчик освещённости
    PYRO    Датчик освещённости
    MAGN    Датчик магнитного поля
    ACCL    Датчик ускорения по 3 осям, в условных попугаях (g/64)
Имена состояний для данных датчиков — произвольные, все состояния настраиваются пользователем в меню порта, к которому подключён датчик MS–6. Мультидатчик сообщает, строго говоря, не о состояниях, а о событиях — наступлении состояния, отличного от предыдущего. Например, пока температура постоянна, он молчит и генерирует событие только в том случае, если она изменилась на 0,1°С или более.
По существу, данное устройство представляет собой совокупность виртуальных датчиков — по каждой из измеряемых физических величин. (В данной версии NSG Linux 2.1 они реализованы не полностью.) Полное имя каждого виртуального датчика образуется из префикса ms6 (при необходимости может быть изменён) и специфичного имени (одно из вышеперечисленных, или sensor-name вместо него), удобного для восприятия.
timer
Програмный таймер — процесс, выдающий события с некоторыми именами через заданные интервалы времени.
sheduler.ИМЯ
Планировщик задач — процесс, выдающий события с некоторым именем в заданное время суток, день недели, месяца и года.
ВиртДатчик.ИМЯ
Виртуальные датчики — произвольные скрипты и приложения, которые могут делать что угодно и на выходе генерировать сообщения в том же формате, что и сообщения реальных датчиков.

Другие типы виртуальных датчиков могут быть реализованы в последующих версиях NSG Linux.

Допускается указание шаблона, под который могут подпадать несколько датчиков, например:

* Все датчики, имеющиеся в системе.
net.if.state.* Состояние всех сетевых интерфейсов.
net.if.lowerstate.eth* Состояние физического уровня всех портов Ethernet.
uitcp.ATM*0.state Состояние всех клиентов uiTCP, имена которых начинаются на ATM и заканчиваются на 0.

Что делать, если это не работает?

  1. Смотреть журнал работы данного датчика, если он там предусмотрен.
  2. Смотреть журнал данного события.

© Network Systems Group 2015–2024 Отдел документации