В данном разделе описываются команды управления журналом предупреждений.

Подробное описание структуры предупреждения приведено в разделе Описание структуры предупреждения или во вкладке ниже.

 Нажмите здесь для раскрытия...

Описание структуры предупреждения

Error: Page Not Found

Для администратора виртуальной АТС команды выполняются на уровне виртуальной АТС в разделе domain/<DOMAIN>/alarms/ и применяются только для определенной виртуальной АТС.

<DOMAIN> - имя виртуальной АТС.

Основные команды управления аварийной сигнализацией

clear

Сброс активных предупреждений/группы предупреждений.

Путь команды:

/domain/<DOMAIN>/alarms/clear

Синтаксис:

clear all | [-l <LOCATION> -c <CLASS> i <INSTANCE>] [ -force]

Параметры:

all - cбросить все предупреждения;
-l <LOCATION> - cбросить предупреждения, которые были сгенерированы заданной подсистемой <LOCATION>, задается в формате: node@host;
-c <CLASS> - сбросить предупреждения, принадлежащие указанному классу предупреждений <CLASS>, задается в формате: ClassName::Subclass1::...::SubclassN;
-d <DOMAIN> - сбросить предупреждения, принадлежащие указанному домену <DOMAIN>;
-i <INSTANCE> - сбросить предупреждения указанного инстанса <INSANCE>;

--force - выполнение команды без запроса подтверждения.

Пример:

Сброс всех предупреждений:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/alarms/clear all 
[clear] Alarms will be cleared
Are you sure?: [n]/y ?> y
ok

[exec at: 27.02.2019 20:38:14, exec time: 2s 550ms, nodes: md1@ecss1]

Сброс всех предупреждений, принадлежащих указанному инстансу:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/alarms/clear -i bond1.2:TC              
[clear] Alarms will be cleared
Are you sure?: [n]/y ?> y
ok

[exec at: 27.02.2019 20:45:45, exec time: 2s 718ms, nodes: md1@ecss2]

Сброс всех предупреждений, сгенерированных подсистемой и принадлежащих определенному классу:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/alarms/clear -l multi@192.168.2.9 -c ecss::core::sorm::connection 
[clear] Alarms will be cleared
Are you sure?: [n]/y ?> y
ok

[exec at: 27.02.2019 20:48:51, exec time: 2s 225ms, nodes: md1@ecss1]

delete

Удаление сброшенных предупреждений из системы.

Путь команды:

/domain/<DOMAIN>/alarms/delete

Синтаксис:

delete all | last <N> | before | last <DATA> [--force]

Параметры:

all - при указании команды "all" из системы удаляются все сброшенные предупреждения;

last <N> - при указании команды "last" из системы удаляются последние <N> записей журнала предупреждений;
<N> - количество записей;
Записи в журнале предупреждений отсортированы по дате, причем в последних записях информация о самых старых предупреждениях. То есть данной командой из журнала удалятся <N> самых старых сообщений.

before <DATA> - при указании команды "before" из системы удаляются все сброшенные предупреждения до заданной даты;
<DATA> - дата, по которую из журнала предупреждений будут удалены все сообщения,
задается в виде: YYYY/MM/DD HH:Mi:SS.sss либо "now" - текущая дата;

after <DATA> - при указании команды "after" из системы удаляются все сброшенные предупреждения после заданной даты;
<DATA> - дата, начиная с которой из журнала предупреждений будут удалены все сообщения,
задается в виде: YYYY/MM/DD HH:Mi:SS.sss либо "now" - текущая дата;

--force - выполнение команды без запроса подтверждения.

Пример:

Удалить все сброшенные предупреждения до 01.02.2019:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/alarms/delete before 2019/02/01 00:00:00
[delete] Cleared alarms will be deleted
Are you sure?: [n]/y ?> y
ok

[exec at: 27.02.2019 20:54:31, exec time: 4s 184ms, nodes: md1@ecss2]

export

Команда выгрузки/экспорта журнала предупреждений в файл.

Путь команды:

/domain/<DOMAIN>/alarms/export

Синтаксис:

export <NODE> [all|cleared] [select <COLUMN>, ... <COLUMN> [order <COLUMN> [asc|desc]]] [limit <N>] [--header] [-delim <DELIM>] [<FILENAME>]

Параметры:

<NODE> - вычислительный узел (нода);
[all|cleared] - при указании команды "all" будет экспортирована информация об всех предупреждениях (активных и сброшенных), при указании команды "cleared" будет экспортирована информация только о сброшенных предупреждениях;
[select <COLUMN>] - при указании команды "select" задается набор столбцов таблицы, экспортируемых в файл;

<COLUMN> - название колонок, задаются в виде <COLUMN> [,<COLUMN>]:

  • additionalinformation - дополнительная информация;
  • backedupstatus - в текущем ПО параметр не используется;
  • backupobject - в текущем ПО параметр не используется;
  • cause - тип причины предупреждения;
  • class - класс предупреждения;
  • cleared - дата и время сброса предупреждения;
  • correlatednotifications - в текущем ПО параметр не используется;
  • date - дата и время возникновения предупреждения;
  • domain - название домена;
  • duration - продолжительность предупреждения в активном состоянии;
  • id - уникальный идентификатор предупреждения;
  • instance - инстанс класса предупреждения;
  • location - местоположение подсистемы, которая сгенерировала предупреждение;
  • message - сообщение с предупреждением;
  • monitoredattributes - в текущем ПО параметр не используется;
  • notificationidentifier - в текущем ПО параметр не используется;
  • origseverity - изначальный уровень важности предупреждения;
  • problems - в текущем ПО параметр не используется;
  • proposedrepairactions - предполагаемые действия для исправления предупреждения, в текущем ПО параметр не используется;
  • severity - уровень важности предупреждения;
  • statechangedefinition - в текущем ПО параметр не используется;
  • threshold - в текущем ПО параметр не используется;
  • trend - тенденция изменения важности предупреждения;
  • type - тип предупреждения;
  • user - имя пользователя, выставившего/сбросившего предупреждение.

order <COLUMN> - при указании "order" задается условие сортировки записей в таблице по возрастанию, где <COLUMN> - название колонки, по которой будут упорядочены записи;

limit <N> - ограничить количество экспортируемых записей, где <N> - количество записей;
--header - флаг, при указании которого экспорт предупреждений выполняется с выводом названия столбцов;
-delim <DELIM> - разделитель столбцов, который будет использоваться при формировании таблицы в файле, где по умолчанию используется символ ";".
<FILENAME> - имя файла. Каталог экспорта  - /var/log/ecss/alarms/<DOMAIN>/

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/alarms/export md1@ecss1 all limit 100 alarm100.csv                   
Export is successful

[exec at: 25.03.2019 20:50:25, exec time: 184ms, nodes: md1@ecss1,md1@ecss2]

generate-alarm

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

Путь команды:

/domain/<DOMAIN>/alarms/generate-alarm

Синтаксис:

generate-alarm <LOCATION> <CLASS> <SEVERITY> <TREND> <TYPE> <CAUSE> <TEXT>

Параметры:

<LOCATION> - местоположение подсистемы, которая сгенерировала предупреждение: название ноды, название кластера, название хоста;<CLASS> - класс предупреждения;
<SEVERITY> - уровень важности предупреждения, принимает значения:

  • cleared - предупреждение сброшено;
  • indeterminate - уровень предупреждения не определен;
  • critical - в системе произошла критическая ошибка, система может работать неправильно;
  • major - важный уровень предупреждения, необходимо немедленное вмешательство в систему;
  • minor - незначительный уровень предупреждения, в системе произошла ошибка;
  • warning - предупреждение, неаварийное сообщение;

<TREND> - тенденция изменения важности предупреждения, принимает значения:

  • moreSevere - значительные изменения;
  • noChange - нет изменений;
  • lessSevere - небольшие изменения;

<TYPE> - тип предупреждения, принимает значения:

  • other - другая причина (не была отнесена к ниже перечисленным);
  • communicationsAlarm - предупреждение, связанное с коммуникациями;
  • qualityOfServiceAlarm - конфигурация;
  • processingErrorAlarm - предупреждение, связанное с обработкой;
  • equipmentAlarm - предупреждение, связанное с оборудованием;
  • environmentalAlarm - предупреждение, связанное с окружением;
  • integrityViolation - предупреждение, связанное с неконсистентной информацией;
  • operationalViolation - предупреждение, связанное с некорректной работой;
  • physicalViolation - предупреждение, связанное с физическими нарушениями (например, выход оборудования из строя);
  • securityServiceOrMechanismViolation - предупреждение, связанное с безопасностью (например, несанкционированный доступ);
  • timeDomainViolation - предупреждение, связанное с возникновением несвоевременных или запрещенных событий.|

<CAUSE> - предполагаемые действия для исправления предупреждения;

<TEXT> - текст предупреждения.

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/alarms/generate-alarm host-4 eal::climat major moreSevere equipmentAlarm lowTemperatue Температура АКБ ниже критической!
Alarm was sent.

[exec at: 27.02.2019 21:19:41, exec time: 183ms, nodes: md1@ecss1]

list

Команда просмотра списка активных и удаленных предупреждений виртуальной АТС с именем <DOMAIN>.
Можно определить список параметров для просмотра и их порядок в таблице.
Записи в таблице могут быть упорядочены по возрастанию по любому из столбцов.

Путь команды:

/domain/<DOMAIN>/alarms/list

Синтаксис:

list [all|cleared|domain-only|cluster-only] [select <column>, ... <column> [order <column> [asc|desc]]] [limit N]

Параметры:

[all|cleared] - при указании команды "all" на дисплей будет выведена информация об всех предупреждениях.
При указании команды "cleared" на дисплей будет выведена информация об удаленных предупреждениях.
Если не указывать команды "all" и "cleared" на дисплей будет выведена информация об активных предупреждениях.

select <COLUMN> - при указании команды "select" задается набор столбцов таблицы, выводимых на экран.

<COLUMN> - название колонок, которые будут выведены на экран, задаются в виде <column> [,<column>]:

  • additionalinformation - дополнительная информация;
  • backedupstatus - в текущем ПО параметр не используется;
  • backupobject - в текущем ПО параметр не используется;
  • cause - тип причины предупреждения;
  • class - класс предупреждения;
  • cleared - дата и время сброса предупреждения;
  • correlatednotifications - в текущем ПО параметр не используется;
  • date - дата и время возникновения предупреждения;
  • domain - название домена;
  • duration - продолжительность предупреждения в активном состоянии;
  • id - уникальный идентификатор предупреждения;
  • instance - инстанс класса предупреждения;
  • location - местоположение подсистемы, которая сгенерировала предупреждение;
  • message - сообщение с предупреждением;
  • monitoredattributes - в текущем ПО параметр не используется;
  • notificationidentifier - в текущем ПО параметр не используется;
  • origseverity - изначальный уровень важности предупреждения;
  • problems - в текущем ПО параметр не используется;
  • proposedrepairactions - предполагаемые действия для исправления предупреждения, в текущем ПО параметр не используется;
  • severity - уровень важности предупреждения;
  • statechangedefinition - в текущем ПО параметр не используется;
  • threshold - в текущем ПО параметр не используется;
  • trend - тенденция изменения важности предупреждения;
  • type - тип предупреждения;
  • user - имя пользователя, выставившего/сбросившего предупреждение.

order <COLUMN> - при указании "order" задается условие сортировки записей в таблице по возрастанию, где <COLUMN> - название колонки, по которой будут упорядочены записи.

limit <N> - ограничить количество <N> выводимых записей. По умолчанию - 25. Изменить значение по умолчанию можно командой на уровне кластера, например:

admin@[mycelium1@ecss1]:/$ cluster/mediator/md1/properties/rpss/set * defaultAlarmRowLimit 30           
Property "defaultAlarmRowLimit" successfully changed from: 
25
   to
30.

[exec at: 27.02.2019 20:57:44, exec time: 391ms, nodes: md1@ecss1]

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/alarms/list all select id, class, instance, date, location, message limit 5
┌──────────────┬───────────────────┬───────────┬─────────────┬──────────────┬────────────────────────────────────────────────────────┐
│      ID      │       Class       │ Instance  │    Date     │   Location   │                        Message                         │
├──────────────┼───────────────────┼───────────┼─────────────┼──────────────┼────────────────────────────────────────────────────────┤
│38303332-3832-│ecss::cluster      │md1        │04.02 22:23:2│ds1@ecss2     │Mediator subsystem "md1" is down                        │
│3839-3361-6338│                   │           │8            │              │                                                        │
│31646531      │                   │           │             │              │                                                        │
│38353432-3837-│ecss::core::sorm::c│biysk.local│21.02 10:13:1│multi@192.168.│Connection with SORM mediator multi@192.168.2.9 is lost.│
│3330-6132-6438│onnection          │           │5            │2.9           │                                                        │
│61646466      │                   │           │             │              │                                                        │
│37663330-6661-│ecss::call_notifier│md1@ecss1  │01.02 15:44:1│md1@ecss1     │Connect failed                                          │
│6463-3333-6137│::jabber           │           │0            │              │                                                        │
│36303937      │                   │           │             │              │                                                        │
│38353361-3466-│ecss::core::sorm::c│biysk.local│21.02 07:42:4│multi@192.168.│Connection with SORM mediator multi@192.168.2.9 is lost.│
│3862-3931-3532│onnection          │           │0            │2.9           │                                                        │
│62343563      │                   │           │             │              │                                                        │
│38373365-3630-│eal::climat        │md1@ecss1  │27.02 21:19:4│host-4        │Температура АКБ ниже критической!                       │
│6335-3033-6233│                   │           │1            │              │                                                        │
│37643437      │                   │           │             │              │                                                        │
└──────────────┴───────────────────┴───────────┴─────────────┴──────────────┴────────────────────────────────────────────────────────┘
Selected: 5
Total: 31

[exec at: 27.02.2019 21:23:00, exec time: 125ms, nodes: md1@ecss1]

Команды управления масками предупреждений

maskadd

Данной командой добавляется фильтр записей в таблице предупреждений (маска).

Путь команды:

/domain/<DOMAIN>/alarms/maskadd

Синтаксис:

maskadd all | [[-l <LOCATION>|-il <Loc1>,..,<LocN>] [-c <CLASS>|-ic <Cl1>,..,<ClN> ] [-i <INSTANCE>|-ii <Ins1>,..,<InsN>]] [-e true|false]

Параметры:

all - маскировать все предупреждения;-l - производить отбор записей по заданному местоположению подсистемы <LOCATION>, которая сгенерировала предупреждение (названия ноды, кластера, хоста);
-il - показывать все записи, кроме указанных "locations": Loc1,..,LocN;
-c - производить отбор записей по заданному классу предупреждения <CLASS>;
-ic - показывать все записи, кроме указанных классов предупреждений;
-i – производить отбор записей по заданной инстанции класса предупреждения;
-ii – показывать все записи, кроме указанных инстанций класса предупреждений;
-e - включить/выключить фильтр записей, по умолчанию фильтр включен, принимает значения:

  • true - включить;
  • false - выключить.

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/alarms/maskadd -i call_recording              
ok

[exec at: 27.02.2019 21:27:12, exec time: 303ms, nodes: md1@ecss2]

maskdel

Путь команды:

/domain/<DOMAIN>/alarms/maskdel

Командой производится удаление маски предупреждений.

Синтаксис:

maskdel all | MaskID

Параметры.

all - удалить все фильтры;
<MASKID> - идентификатор фильтра, значение "all" используется для удаления всех фильтров.

Пример:

Удалить фильтр с номером 38373365-6463-3336-6431-646565326633:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/alarms/maskdel 38373365-6463-3336-6431-646565326633   
Mask(s) successfully removed.

[exec at: 27.02.2019 21:47:45, exec time: 75ms, nodes: md1@ecss1]

masklist

Команда для просмотра активных масок предупреждений.

Путь команды:

/domain/<DOMAIN>/alarms/masklist

Синтаксис:

masklist

Параметры:

Команда не содержит аргументов.

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/alarms/masklist   
┌────────────────────────────────────┬──────┬──┬───┬──┬──────────────┬──┬───────────┬──┬────┬──────────────────────┐
│                 ID                 │  L   │IL│ C │IC│      I       │II│     D     │ID│ E  │         Date         │
├────────────────────────────────────┼──────┼──┼───┼──┼──────────────┼──┼───────────┼──┼────┼──────────────────────┤
│38373365-6339-3838-6638-313161626633│*     │  │*  │  │call_recording│  │biysk.local│  │true│2019.02.27 21:27:11.95│
│38373365-6438-3239-3733-306661333030│host-4│  │*  │  │*             │  │biysk.local│  │true│2019.02.27 21:28:14.78│
│38373365-6463-3336-6431-646565326633│*     │  │eal│  │*             │  │biysk.local│  │true│2019.02.27 21:28:32.18│
└────────────────────────────────────┴──────┴──┴───┴──┴──────────────┴──┴───────────┴──┴────┴──────────────────────┘
Total: 3

Colunms:
 ID - identificator of mask
 L  - location of alarm
 IL - ignore list of alarm locations
 C  - class of alarm
 IC - ignore list of alarm classes
 I  - instance of alarm
 II - ignore list of alarm instances
 D  - domain of alarm
 ID - ignore list of alarm domains
 E  - Enabled or disabled: true or false

[exec at: 27.02.2019 21:28:53, exec time: 105ms, nodes: md1@ecss1]

maskmod

Данная команда позволяет модифицировать заданную маску предупреждений.

Путь команды:

/domain/<DOMAIN>/alarms/maskmod

Синтаксис:

maskmod <MASKID> all | [[-l <LOCATION>|-il <Loc1>,..,<LocN>] [-c <CLASS>|-ic <Cl1>,..,<ClN> ] [-i <INSTANCE>|-ii <Ins1>,..,<InsN>]] [-e true|false]

Параметры:

<MASKID> - идентификатор фильтра;all - маскировать все предупреждения;
-l - производить отбор записей по заданному местоположению подсистемы <Location>, которая сгенерировала предупреждение (названия ноды, кластера, хоста);
-il - показывать все записи, кроме указанных "locations": Loc1,..,LocN;
-c - производить отбор записей по заданному классу предупреждения <Class>;
-ic - показывать все записи, кроме указанных классов предупреждений;
-i – производить отбор записей по заданной инстанции класса предупреждения;
-ii – показывать все записи, кроме указанных инстанций класса предупреждений;
-e - включить/выключить фильтр записей, по умолчанию фильтр включен, принимает значения:

  • true - включить;
  • false - выключить.

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/alarms/maskmod 38373365-6339-3838-6638-313161626633 -i zone_page              
ok

[exec at: 27.02.2019 21:40:37, exec time: 75ms, nodes: md1@ecss1]

masktrace

Команда трассировки маски предупреждения.

Путь команды:

/domain/<DOMAIN>/alarms/masktrace

Синтаксис:

masktrace [-l <LOCATION>] [-c <CLASS>] [-i <INSTANCE>]

Параметры:

  • -l - трассировать по <LOCATION>;
    Формат <location>: node_name@hostname;
  • -c - трассировать по <CLASS>;
    Формат <CLASS>: ClassName::Subclass1::...::SubclassN;
  • -i - трассировать по <INSTANCE>;

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/alarms/masktrace -l host-4    
Event will be masked by:
┌────────────────────────────────────┬──────┬──┬─┬──┬─┬──┬───────────┬──┬────┬──────────────────────┐
│                 ID                 │  L   │IL│C│IC│I│II│     D     │ID│ E  │         Date         │
├────────────────────────────────────┼──────┼──┼─┼──┼─┼──┼───────────┼──┼────┼──────────────────────┤
│38373365-6438-3239-3733-306661333030│host-4│  │*│  │*│  │biysk.local│  │true│2019.02.27 21:28:14.78│
└────────────────────────────────────┴──────┴──┴─┴──┴─┴──┴───────────┴──┴────┴──────────────────────┘
Total: 1

Colunms:
 ID - identificator of mask
 L  - location of alarm
 IL - ignore list of alarm locations
 C  - class of alarm
 IC - ignore list of alarm classes
 I  - instance of alarm
 II - ignore list of alarm instances
 D  - domain of alarm
 ID - ignore list of alarm domains
 E  - Enabled or disabled: true or false

[exec at: 27.02.2019 21:43:00, exec time: 134ms, nodes: md1@ecss2]