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

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

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

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

В таблице приведено описание структуры предупреждения.

Таблица — Структура предупреждения

ПолеОписание
SeverityУровень важности предупреждения, принимает значения:
  • cleared — предупреждение сброшена;
  • indeterminate — уровень предупреждения не определен;
  • critical — критическое предупреждение;
  • major — важный уровень предупреждения;
  • minor — незначительный уровень предупреждения;
  • warning — предупреждение.
Origseverity
IDУникальный идентификатор предупреждения. Служебная информация
Class

Класс предупреждения.
Описывается в виде: Класс::Подкласс1::...::ПодклассN.
Примеры:

ecss::pa::sip::user
ecss::cluster::core::cp
HW::Disks
ecss::cluster
ecss::cluster::node
ecss::oasys::mnesia

DomainИмя домена.
InstanceЭкземпляр класса предупреждения.
Пример: имя ноды, идентификатор call-process, название кластера, название шлюза.
LocationМестоположение ноды, которая сгенерировала предупреждение: имя ноды, название кластера, название хоста.
UserИмя пользователя, выставившего/сбросившего предупреждение. Системные предупреждения выставляются и сбрасываются от имени "[system]".
DateДата и время возникновения предупреждения.
ClearedДата и время сброса предупреждения.
DurationДлительность.
CauseТип причины предупреждения, принимает значения:
  • communicationsSubsystemFailure — коммуникации;
  • configurationOrCustomizationError — конфигурация;
  • outOfService — вывод из обслуживания;
  • softwareError — программная ошибка;
  • storageCapacityProblem — система хранения;
  • other — другая причина (не была отнесена к выше перечисленным).
TypeТип предупреждения, принимает значения:
  • communicationsAlarm — предупреждение, связанное с коммуникациями;
  • qualityOfServiceAlarm — предупреждение, связанное с качеством сервиса;
  • processingErrorAlarm — предупреждение, связанное с обработкой;
  • equipmentAlarm — предупреждение, связанное с оборудованием;
  • environmentalAlarm — предупреждение, связанное с окружением;
  • integrityViolation — предупреждение, связанное с неконсистентной информацией;
  • operationalViolation — предупреждение, связанное с некорректной работой;
  • physicalViolation — предупреждение, связанное с физическими нарушениями (например, выход оборудования из строя);
  • securityServiceOrMechanismViolation — предупреждение, связанное с безопасностью (например, несанкционированный доступ);
  • timeDomainViolation — предупреждение, связанное с возникновением несвоевременных или запрещенных событий;
  • other — другая (не была отнесена к выше перечисленным).
ProblemsВ текущей версии ПО не используется.
BackedupStatusВ текущей версии ПО не используется.
BackupObjectВ текущей версии ПО не используется.
TrendТенденция изменения важности предупреждения, принимает значения:
  • noChange — без изменений;
  • lessSevere — уменьшение важности;
  • moreSevere — увеличение важности.
ThresholdВ текущей версии ПО не используется.
NotificationIdentifierВ текущей версии ПО не используется.
CorrelatedNotificationsВ текущей версии ПО не используется.
StateChangeDefinitionВ текущей версии ПО не используется.
MonitoredAttributesВ текущей версии ПО не используется.
ProposedRepairActionsПредполагаемые действия для исправления предупреждения. В текущей версии ПО не используется.
MessageСообщение о предупреждении.
AdditionalInformationДополнительная информация

Для администратора виртуальной АТС команды выполняются на уровне виртуальной АТС в разделе 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@ds1@ecss1:/$ domain/biysk.local/alarms/clear all
[clear] Alarms will be cleared
Are you sure?: [n]/y ?> y
ok

[exec at: 09.02.2021 10:33:27, exec time: 2s 134ms, nodes: md1@ecss1 v.3.14.7.562]
Alarm list changed at 09.02.2021 10:33:28:
    critical: 5                 
    major   : 12                

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

admin@ds1@ecss1:/$ domain/biysk.local/alarms/clear -i ipset1:5064 --force
ok

[exec at: 09.02.2021 10:30:46, exec time: 14ms, nodes: md1@ecss1 v.3.14.7.562]

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

admin@ds1@ecss1:/$ domain/biysk.local/alarms/clear -l megaco1@ecss1 -c ecss::pa::megaco::domain
[clear] Alarms will be cleared
Are you sure?: [n]/y ?> y
ok

[exec at: 09.02.2021 10:29:37, exec time: 3s 424ms, nodes: md1@ecss1 v.3.14.7.562]
Alarm list changed at 09.02.2021 10:29:38:
    critical: 5                 
    major   : 13                

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@ds1@ecss1:/$ domain/biysk.local/alarms/delete before 2021/02/01 00:00:00
[delete] Cleared alarms will be deleted
Are you sure?: [n]/y ?> y
ok

[exec at: 09.02.2021 10:34:07, exec time: 2s 25ms, nodes: md1@ecss1 v.3.14.7.562]

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@ds1@ecss1:/$ domain/biysk.local/alarms/export md1@ecss1 all limit 100 alarm100.csv
Export is successful

[exec at: 09.02.2021 10:23:31, exec time: 65ms, nodes: md1@ecss1 v.3.14.7.562]

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@ds1@ecss1:/$ domain/biysk.local/alarms/generate-alarm host-4 eal::climat major moreSevere equipmentAlarm lowTemperatue Температура АКБ ниже критической!
Alarm was sent.

[exec at: 09.02.2021 10:25:33, exec time: 20ms, nodes: md1@ecss1 v.3.14.7.562]
Alarm list changed at 09.02.2021 10:25:34:
    critical: 6                 
    major   : 13                

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@ds1@ecss1:/$ cluster/mediator/md1/properties/rpss/set * defaultAlarmRowLimit 30
Property "defaultAlarmRowLimit" successfully changed from: 
25
   to
30.

[exec at: 09.02.2021 10:27:07, exec time: 148ms, nodes: md1@ecss1 v.3.14.7.562]

Пример:

admin@ds1@ecss1:/$ domain/biysk.local/alarms/list all select id, class, instance, date, location, message limit 5
┌────────────────────┬───────────────────────────┬───────────────────────────┬───────────────────┬────────────────────┬──────────────────────────────────────────────────────────────────────────────────┐
│         ID         │           Class           │         Instance          │       Date        │      Location      │                                     Message                                      │
├────────────────────┼───────────────────────────┼───────────────────────────┼───────────────────┼────────────────────┼──────────────────────────────────────────────────────────────────────────────────┤
│30363463-3463-3161-3│ecss::cluster              │core1                      │03.02 07:21:29     │megaco1@ecss1       │Communication core subsystem "core1" is down                                      │
│739-343864616239    │                           │                           │                   │                    │                                                                                  │
│30363463-3231-6637-3│ecss::cluster              │core1                      │01.02 07:25:00     │ds1@ecss1           │Communication core subsystem "core1" is down                                      │
│939-373765363663    │                           │                           │                   │                    │                                                                                  │
│30363462-6364-6264-6│ecss::cluster              │sip1                       │28.01 21:04:59     │ds1@ecss1           │SIP subsystem "sip1" is down                                                      │
│134-623033366665    │                           │                           │                   │                    │                                                                                  │
│30363463-6364-3561-6│eal::climat                │md1@ecss1                  │09.02 10:25:33     │host-4              │Температура АКБ ниже критической!                                                 │
│434-656130616131    │                           │                           │                   │                    │                                                                                  │
│30363463-6361-3938-3│ecss::pa::megaco::domain   │"biysk.local"              │09.02 07:17:10     │megaco1@ecss1       │Megaco start transport error                                                      │
│636-303535333335    │                           │                           │                   │                    │                                                                                  │
└────────────────────┴───────────────────────────┴───────────────────────────┴───────────────────┴────────────────────┴──────────────────────────────────────────────────────────────────────────────────┘
Selected: 5
Total: 39

[exec at: 09.02.2021 10:27:30, exec time: 28ms, nodes: md1@ecss1 v.3.14.7.562]

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

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@ds1@ecss1:/$ domain/biysk.local/alarms/maskadd -i call_recording
ok

[exec at: 09.02.2021 10:34:47, exec time: 34ms, nodes: md1@ecss1 v.3.14.7.562]

maskdel

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

/domain/<DOMAIN>/alarms/maskdel

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

Синтаксис:

maskdel all | MaskID

Параметры.

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

Пример:

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

admin@ds1@ecss1:/$ domain/biysk.local/alarms/maskdel all   
Mask(s) successfully removed.

[exec at: 09.02.2021 10:56:05, exec time: 36ms, nodes: md1@ecss1 v.3.14.7.562]

masklist

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

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

/domain/<DOMAIN>/alarms/masklist

Синтаксис:

masklist

Параметры:

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

Пример:

admin@ds1@ecss1:/$ domain/biysk.local/alarms/masklist             
┌────────────────────────────────────┬─┬──┬─┬──┬──────────────┬──┬───────────┬──┬────┬──────────────────────┐
│                 ID                 │L│IL│C│IC│      I       │II│     D     │ID│ E  │         Date         │
├────────────────────────────────────┼─┼──┼─┼──┼──────────────┼──┼───────────┼──┼────┼──────────────────────┤
│30363463-6364-3764-3732-636361356136│*│  │*│  │call_recording│  │biysk.local│  │true│2021.02.09 10:34:47.18│
│30363463-6364-3839-3263-343466383264│*│  │*│  │bond1.2:ТС    │  │biysk.local│  │true│2021.02.09 10:37:54.80│
└────────────────────────────────────┴─┴──┴─┴──┴──────────────┴──┴───────────┴──┴────┴──────────────────────┘
Total: 2

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: 09.02.2021 10:41:37, exec time: 23ms, nodes: md1@ecss1 v.3.14.7.562]

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@ds1@ecss1:/$ domain/biysk.local/alarms/maskmod 30363463-6364-3839-3263-343466383264 -i bond1.2:SIP61       
ok

[exec at: 09.02.2021 10:42:49, exec time: 36ms, nodes: md1@ecss1 v.3.14.7.562]

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@ds1@ecss1:/$ domain/biysk.local/alarms/masktrace -i bond1.2:SIP61
Event will be masked by:
┌────────────────────────────────────┬─┬──┬─┬──┬─────────────┬──┬───────────┬──┬────┬──────────────────────┐
│                 ID                 │L│IL│C│IC│      I      │II│     D     │ID│ E  │         Date         │
├────────────────────────────────────┼─┼──┼─┼──┼─────────────┼──┼───────────┼──┼────┼──────────────────────┤
│30363463-6364-3839-3263-343466383264│*│  │*│  │bond1.2:SIP61│  │biysk.local│  │true│2021.02.09 10:42:49.65│
└────────────────────────────────────┴─┴──┴─┴──┴─────────────┴──┴───────────┴──┴────┴──────────────────────┘
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: 09.02.2021 10:54:54, exec time: 34ms, nodes: md1@ecss1 v.3.14.7.562]