Если вы находитесь в ОС Linux, подключитесь к командной консоли под пользователем admin.
Команда для подключения:
ssh admin@localhost -p 8023
Нужно добавить "правило сбора статистики". При необходимости указать, в какой модуль будет экспортироваться статистика:
Команда для администратора системы:
/cluster/mediator/<CLUSTER>/statistics/add
<TYPE> <INTERVAL> [<GROUPS>] <EXPORT> [;
<EXPORT_1>; .... ; <EXPORT_N>] [OPTIONS]
Команда для администратора виртуальной АТС:
/domain/<DOMAIN>/statistics/add
<TYPE> <INTERVAL> [<GROUPS>] <EXPORT> [;
<EXPORT_1>; .... ; <EXPORT_N>] [OPTIONS]
где
<CLUSTER> - имя кластера с ролью MEDIATOR;
<DOMAIN> - имя виртуальной АТС;
<TYPE> - модули статистики. Для просмотра списка данных, с которыми оперирует модуль статистики, воспользуйтесь командой statmodinfo;
<INTERVAL> - интервал экспорта статистической информации, в минутах (>=5);
<GROUPS> - название группы или список названий групп фильтров. Данный параметр является обязательным для типов e502Type9, e502Type10, e502Type11, e502Type12. В остальных случаях этот параметр не указывается;
<EXPORT> - модули экспорта статистики:
- txt_file_export;
- rpss_db_export.
Модуль экспорта статистики "txt_file_export"
Модуль "txt_file_export" выполняет сохранение статистической информации в виде текстового файла в формате CSV.
Поддерживаемые опции [options]:
... txt_file_export [--dir <PATH>] [--format <FORMAT>]
где
--dir - флаг, используется для указания директории для сохранения экспортируемых файлов, опциональный параметр. <PATH> - путь для записи отчетов. Если в названии директорий содержатся пробелы, то параметр должен вводиться в кавычках. По умолчанию установлена директория /var/lib/ecss/<TYPE>/<NAME>/statistics, где:
- <TYPE> - тип владельца: domain или cluster;
- <NAME> - название владельца.
--format - флаг, используется для указания формата выходного файла отчета, опциональный параметр.
<FORMAT> - формат выходного файла отчета, могут быть использованы следующие переменные замены:
- #Name - название отчета (предоставляется модулем статистики);
- #SY - год начальной даты отчета;
- #SM - месяц начальной даты отчета;
- #SD - день начальной даты отчета;
- #Shh - часы начальной даты отчета;
- #Smm - минуты начальной даты отчета;
- #Sss - секунды начальной даты отчета;
- #Soffset - сдвиг относительно UTC начальной даты отчета;
- #EY - год конечной даты отчета;
- #EM - месяц конечной даты отчета;
- #ED - день конечной даты отчета;
- #Ehh - часы конечной даты отчета;
- #Emm - минуты конечной даты отчета;
- #Ess - секунды конечной даты отчета;
- #Eoffset - сдвиг относительно UTC конечной даты отчета.
Модуль экспорта "rpss_db_export"
Модуль "rpss_db_export" выполняет сохранение статистической информации в базу данных.
Поддерживаемые опции [options]:
... rpss_db_export <dbConnections_name> [--recovery-dir <PATH>]
где
<dbConnections_name> - название строки подключения к базе данных, должно соответствовать одному из созданных ранее подключений dbConnections (описание приведено выше);
<PATH> - путь, по которому нужно сохранять отчеты статистики в случае недоступности базы данных, опциональный параметр. Экспорт данных из этой директории выполняется автоматически при первом успешном подключении к базе данных.
Примеры
Экспорт в базу данных:
/cluster/mediator/md1/statistics/add hostResources 5 rpss_db_export stat_conn
Экспорт в базу данных с указанием директории для хранения:
/cluster/mediator/md1/statistics/add hostResources 5 rpss_db_export stat_conn --recovery-dir /var/lib/ecss/statistics
Экспорт в текстовый файл с расширением "csv" и базу данных с указанием директории для хранения:
/cluster/mediator/md1/statistics/add hostResources 5 rpss_db_export stat_conn --recovery-dir /var/lib/ecss/statistics; txt_file_export
Для просмотра списка данных, с которыми оперирует модуль статистики, используется команда:
Команда администратора системы:
/cluster/mediator/<CLUSTER>/statistics/statmodinfo <ModuleName> [-m]
Команда администратора виртуальной АТС:
/domain/<DOMAIN>/statistics/statmodinfo <ModuleName> [-m]
где
<CLUSTER> - имя кластера с ролью MEDIATOR;
<DOMAIN> - имя виртуальной АТС;
<ModuleName> - название модуля статистики;
[-m] - флаг, при указании которого выводится информация о текущих названиях колонок модуля. Названия колонок модуля статистики можно изменить командой addcolmap.
Пример
/cluster/mediator/md1/statistics/statmodinfo e502Type1 Description: "Overall measurements on originating traffic" ------------------------------------------------------------------------------------------------------- |N| Name | Type | Description | |-+----------+-------+--------------------------------------------------------------------------------| |1|seizures |integer|Number of originating seizures | |2|notRouted |integer|Number of call attempts not routed due to: no dialling, incomplete dialling, inv| | | | |alid address | |3|congestion|integer|Number of call attempts lost due to internal congestion | ------------------------------------------------------------------------------------------------------- /cluster/mediator/md1/statistics/statmodinfo hostResources -m Current columns mapping: --------------------- |N| Name |New name| |-+--------+--------| |1|location|node | ---------------------
Для изменения названий колонок модуля статистики используется команда:
Команда администратора системы:
/cluster/mediator/<CLUSTER>/statistics/addcolmap <MODULE> <ColumnName> <NewColumnName>
Команда администратора виртуальной АТС:
/domain/<DOMAIN>/statistics/addcolmap <MODULE> <ColumnName> <NewColumnName>
где
<CLUSTER> - имя кластера с ролью MEDIATOR;
<DOMAIN> - имя виртуальной АТС;
<MODULE> - название модуля статистики;
<ColumnName> - оригинальное название столбца;
<NewColumnName> - новое название столбца.
Пример
/cluster/mediator/md1/statistics/addcolmap hostResources location node ok /cluster/mediator/md1/statistics/statmodinfo hostResources -m Current columns mapping: --------------------- |N| Name |New name| |-+--------+--------| |1|location|node | ---------------------
Для удаления созданного соответствия столбцов модуля статистики используется команда:
Команда администратора системы:
/cluster/mediator/<CLUSTER>/statistics/delcolmap <MODULE> <ColumnName>
Команда администратора виртуальной АТС:
/domain/<DOMAIN>/statistics/delcolmap <MODULE> <ColumnName>
где
<CLUSTER> - имя кластера с ролью MEDIATOR;
<DOMAIN> - имя виртуальной АТС;
<MODULE> - название модуля статистики;
<ColumnName> - оригинальное название столбца.
Пример
/cluster/mediator/md1/statistics/delcolmap hostResources location ok
Для просмотра всех созданных "правил сбора статистики" используется команда:
Команда администратора системы:
/cluster/mediator/<CLUSTER>/statistics/list
Команда администратора виртуальной АТС:
/domain/<DOMAIN>/statistics/list
где
<CLUSTER> - имя кластера с ролью MEDIATOR;
<DOMAIN> - имя виртуальной АТС;
Пример
/cluster/mediator/md1/statistics/list ----------------------------------------------------------------------------------------------------- | ID | Module |Interval| Start time |End time | Exports | ----------------------------------------------------------------------------------------------------- |17a13034-3937-6639-3063-653238346436|e502Type12| 900 |2010.12.22 11:30|undefined|txt_file_export| ----------------------------------------------------------------------------------------------------- Total: 1
При необходимости удалить "правило сбора статистики" воспользуйтесь командой:
Команда администратора системы:
/cluster/mediator/<CLUSTER>/statistics/delete <StatID>
Команда администратора виртуальной АТС:
/domain/<DOMAIN>/statistics/delete <StatID>
где
<CLUSTER> - имя кластера с ролью MEDIATOR;
<DOMAIN> - имя виртуальной АТС;
<StatID> - идентификатор правила (соответствует значению поля 'ID' вывода команды list), при указании значения "all" будут удалены все правила.
Пример
Удаление всех правил:
/cluster/mediator/md1/statistics/delete all
Удаление определенного правила:
/cluster/mediator/md1/statistics/delete 17a13034-3937-3439-3334-613664666363