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

Подробное описание структуры предупреждения приведено в Части 5 Руководство по обслуживанию системы ECSS-10 , в разделе Описание структуры предупреждения.

Для администратора системы команды выполняются на уровне кластера в разделе /cluster/mediator/<MEDIATOR>/alarms/.

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

<DOMAIN> - имя виртуальной АТС.
<CLUSTER> - имя кластера с ролью MEDIATOR.

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

clear

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

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

/domain/<DOMAIN>/alarms/clear

Синтаксис:

команда уровня виртуальной АТС:
clear all | [-l <LOCATION> -c <CLASS> -i <INSTANCE>]

Параметры:

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

Пример:

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

ecss-root@[pa_sip1@leonid1]:/# domain/kolek.domain/alarms/clear all
You should enter 'y' or 'n'.
Are you sure?: [n]/y ?>

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

ecss-root@[pa_sip1@leonid1]:/# domain/kolek.domain/alarms/clear -i pa_megaco
You should enter 'y' or 'n'.
Are you sure?: [n]/y ?>

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

ecss-root@[pa_sip1@leonid1]:/# domain/kolek.domain/alarms/clear -l ds1@leonid
You should enter 'y' or 'n'.
Are you sure?: [n]/y ?>

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

ecss-root@[pa_sip1@leonid1]:/# domain/kolek.domain/alarms/clear -c hw::interfaces
You should enter 'y' or 'n'.
Are you sure?: [n]/y ?>

delete

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

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

/domain/<DOMAIN>/alarms/delete

Синтаксис:

delete all|last <N>|before <DATA>

Параметры:

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" - текущая дата.

Пример:

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

ecss-root@[pa_sip1@leonid1]:/# domain/kolek.domain/alarms/delete all
[delete] Cleared alarms will be deleted
Are you sure?: [n]/y ?>y

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> - имя файла.

Пример:

ecss-root@[core1@leonid1]:/# domain/111/alarms/export md1@leonid1/var/log/2

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> - текст предупреждения.

Пример:

/domain/p.city/alarms/generate-alarm 192.168.1.1 my::alarm:class warning noChange qualityOfServiceAlarm other My test alarm

list

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

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

/domain/<DOMAIN>/alarms/list

Синтаксис:

list [all|cleared] [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. Изменить значение по умолчанию можно командой:

/cluster/mediator/<some_mediator_cluster>/properties/rpss/set * defaultAlarmRowLimit 30

Пример:

ssw@[mycelium@ecss3]:/#> cluster/mediator/md3/alarms/list select class, instance, location, cause order by class 
--------------------------------------------------------------------------------------------------------------------
|         Class         |                   Instance                    | Location  |            Cause             |
|-----------------------+-----------------------------------------------+-----------+------------------------------|
|ecss::cluster::core::cp|pa.megaco->62393034-6231-6435-3663-646563386636|core3@ecss3|softwareError                 |
|ecss::cluster::core::cp|pa.megaco->61333034-6231-6230-3862-663765313262|core1@beam |softwareError                 |
|ecss::cluster::core::cp|pa.megaco->63623034-6231-6331-6362-656234353732|core3@ecss3|softwareError                 |
|ecss::cluster::core::cp|pa.megaco->37613034-6231-6261-6531-663861623664|core1@beam |softwareError                 |
|ecss::cluster::core::cp|pa.megaco->38663034-6231-6231-3362-646562633930|core1@beam |softwareError                 |
|ecss::cluster::core::cp|pa.megaco->61343034-6231-6332-3033-636432653637|core1@beam |softwareError                 |
|ecss::cluster::core::cp|pa.megaco->33383034-6231-6166-3363-366336313838|core1@beam |softwareError                 |
|ecss::cluster::core::cp|pa.megaco->65613034-6231-6264-3439-353133643665|core3@ecss3|softwareError                 |
|ecss::pa::sip::trunk   |MAX_P                                          |sip3@ecss3 |communicationsSubsystemFailure|
|ecss::pa::sip::user    |6303@d.local                                   |sip3@ecss3 |communicationsSubsystemFailure|
--------------------------------------------------------------------------------------------------------------------
Total: 10

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

maskadd

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

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

domain/<DOMAIN>/alarms/maskadd

Синтаксис:

Параметры:

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

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

Пример:

ecss-root@[core1@leonid1]:/# domain/111/alarms/maskadd -l tts1@leonid1  
ok

maskdel

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

/domain/<DOMAIN>/alarms/maskdel

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

Синтаксис:

maskdel <MASKID>

Параметры.

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

Пример:

Удалить фильтр с номером 37313034-6438-3266-6232-343239303534:

ecss-root@[core1@leonid1]:/# domain/111/alarms/maskdel 37313034-6438-3266-6232-343239303534
Mask(s) successfully removed.

masklist

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

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

/domain/<DOMAIN>/alarms/masklist

Синтаксис:

masklist

Параметры:

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

Пример:

ecss-root@[core1@leonid1]:/# domain/111/alarms/masklist 
--------------------------------------------------------------------------------------------------
|                 ID                 |     L     |IL|C|IC|I|II| D |ID| E  |         Date         |
|------------------------------------+-----------+--+-+--+-+--+---+--+----+----------------------|
|37313034-6438-3266-6261-313435613538|*          |  |*|  |*|  |111|  |true|2013.03.18 16:36:43.80|
|37313034-6438-3266-6262-643661353539|ds1@leonid1|  |*|  |*|  |111|  |true|2013.03.18 16:37:13.31|
|37313034-6438-3266-6264-633161623861|md1@leonid1|  |*|  |*|  |111|  |true|2013.03.18 16:37:45.49|
--------------------------------------------------------------------------------------------------
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

maskmod

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

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

/domain/<DOMAIN>/alarms/maskmod

Синтаксис:

Параметры:

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

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

Пример:

ecss-root@[core1@leonid1]:/# domain/111/alarms/maskmod 37313034-6438-3266-6261-313435613538 -e false 
ok

masktrace

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

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

/domain/<DOMAIN>/alarms/masktrace

Синтаксис:

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

Параметры:

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

Пример:

ecss-root@[core1@leonid1]:/# domain/111/alarms/masktrace -i tau72

Быстрые ссылки

Дерево страниц

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

clear

delete

export

generate-alarm

list

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

maskadd

maskdel

masklist

maskmod

masktrace