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

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

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

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

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

Введите имя объекта, который служит виртуальным датчиком. Виртуальный датчик в 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.

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

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

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