Описание

Кластер с ролью Mediator используется для сбора и экспорта статистической информации. На рисунке 1 приведена общая схема взаимодействия кластера Mediator с другими кластерами системы.

Рисунок 1 — Общая схема взаимодействия кластера Mediator с другими кластерами системы

В качестве источников статистики могут выступать следующие компоненты ECSS-10:

  • TTS – подсистема кластера CORE, обеспечивает функции тарификации и взаимодействия с посредником СОРМ;
  • Core – кластер системы ECSS-10, отвечающий за управление обслуживанием телефонных вызовов и предоставление услуг;
  • Adapters (SIP, Megaco, SIGTRAN) – кластера адаптации определенного сигнального протокола к внутреннему протоколу сигнализации системы ECSS-10;
  • DS – кластер хранения долговременных данных (конфигурационные данные, состояния интерфейсов, маршрутизация) системы ECSS-10.

В качестве статистической информации выступают события вызова (call events) и счетчики (counters).
Каждый кластер, принимающий участие в обработке вызова, формирует соответствующий набор событий и счетчиков, которые агрегируются в кластере Mediator в соответствии с указанными правилами. Правило агрегации определяется "модулем статистики". "Модулем экспорта" статистики является база данных. "Правилом сбора статистики" является совокупность "модуля статистики", интервала экспорта и "модуля (или модулей) экспорта".

В общем виде схема обработки статистики представлена на рисунке 2.

Рисунок 2 — Схема обработки статистики

Порядок настройки системы сбора статистики обслуживания вызовов

Для настройки системы сбора статистики используется интерфейс командой строки.

Если нужно использовать "модули экспорта", то необходимо произвести настройку базы данных: создать схему и пользователя. Пользователь должен: иметь права на создание, удаление таблиц; иметь права на создание, удаление индексов; выполнять команды "select", "update", "delete".

Порядок конфигурирования системы сбора статистики:

  1. Настройка взаимодействия с "модулем экспорта" (опционально).
  2. Добавление "правил сбора статистики".

Настройка взаимодействия с "модулем экспорта"

В текущей версии программного обеспечения поддерживается экспорт только в базу данных MySQL.

MySQL

Настройка системы управления базами данных (СУБД) MySQL производится командами, которые выполняются из командной консоли управления операционной системы Linux (shell).

  1. Перед началом конфигурирования нужно убедиться, что СУБД MySQL установлена на хосте (см. раздел по установке в разделе Инсталляция MySQL-сервера).
  2. Для создания базы данных и пользователя в СУБД MySQL нужно подключиться к локальной консоли MySQL командой:

    mysql -u<ADMIN_LOGIN> -p<ADMIN_PASSWORD>

    где

    <ADMIN_LOGIN> — логин администратора MySQL, по умолчанию root;
    <ADMIN_PASSWORD> — пароль администратора MySQL (пароль задается при установке БД).

    Пример

    Подключение к MySQL с логином "root" и паролем "root":

    ssw@ecss1:~$ mysql -uroot -proot
Warning: Using a password on the command line interface can be insecure.
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 40637
Server version: 5.6.27-0ubuntu0.14.04.1-log (Ubuntu)

Copyright (c) 2000, 2015, Oracle and/or its affiliates. All rights reserved.

Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql>

  3. Для создания базы данных по статистике с именем "statistics" используется команда:

    CREATE DATABASE statistics;

  4. Создание пользователя для доступа к базе данных по статистике выполняется командой:

    CREATE USER 'stat_user'@'host' IDENTIFIED BY 'password_for_stat_user';

    где

    • stat_user — имя пользователя для доступа к базе данных по статистике;
    • host — определенный хост или маска хостов, с которых пользователь может подключаться к базе данных. Для разрешения подключения с любого хоста используется значение "%";
    • password_for_stat_user — пароль пользователя для доступа к базе данных по статистике.

  5. Настройка прав доступа для данного пользователя выполняется командой:

    GRANT CREATE, DROP, INDEX, SELECT, INSERT, UPDATE, DELETE, EXECUTE, ALTER ON statistics.* TO 'stat_user'@'host';

    где

    • stat_user — имя пользователя для доступа к базе данных по статистике;
    • host — определенный хост или маска хостов, с которых пользователь может подключаться к базе данных. Для разрешения подключения с любого хоста используется значение "%".

Создание строки подключения к базе данных

Если вы сейчас находитесь в ОС Linux, подключитесь к командной консоли CLI под пользователем admin.

Пароль по умолчанию: password.

Команда для подключения:

ssh admin@localhost -p 8023

В общем виде команда добавления строки подключения к базе данных выглядит следующим образом:

/cluster/mediator/<CLUSTER>/properties/rpss/set <NODE> dbConnections <dbConnections_name> <TYPE> database=<DATABASE> host=<HOST> password=<PASSWORD> port=<PORT> user=<USER>

где

<CLUSTER> — имя кластера;
<NODE> — имя ноды, символ "*" используется для указания всех нод заданного кластера;
<dbConnections_name> — название строки подключения к базе данных;
<TYPE> — тип базы данных, в данной версии ПО поддерживается только MySQL;
<DATABASE> — имя базы данных (statistics);
<HOST> — адрес хоста, на котором расположена база данных. Как правило, база и система ECSS-10 расположены на одном хосте, в этом случае нужно указать значение 127.0.0.1; 
<PORT> — порт для подключения к СУБД MySQL. По умолчанию значение порта — 3306. Если ваша база данных не использует другой порт, то данный параметр не настраивается;
<USER> — имя пользователя для доступа к базе данных по статистике;
<PASSWORD> — пароль пользователя для доступа к базе данных по статистике.

Пример

Создание строки подключения "stat_conn" к базе данных MySQL:

/cluster/mediator/md1/properties/rpss/set * dbConnections stat_conn mysql database=statistics host=127.0.0.1 user=stat_user password=password_for_stat_user

Удаление строки подключения выполняется командой:

/cluster/mediator/<CLUSTER>/properties/rpss/clean <NODE> dbConnections <dbConnections_name>

где

<CLUSTER> — имя кластера;
<NODE> — имя ноды, символ "*" используется для указания всех нод заданного кластера;
<dbConnections_name> — название строки подключения к базе данных.

Настройка системы сбора статистики обслуживания вызовов

Если вы находитесь в ОС Linux, подключитесь к командной консоли под пользователем admin.

Пароль по умолчанию: password.

Команда для подключения:

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 конечной даты отчета.
Значение по умолчанию: #Name/#Name_#SY#SM#SD#Shh#Smm_#EY#EM#ED#Ehh#Emm #Eoffset.

Модуль экспорта "rpss_db_export"

Модуль "rpss_db_export" выполняет сохранение статистической информации в базу данных.

Поддерживаемые опции [options]:

... rpss_db_export <dbConnections_name> [--recovery-dir <PATH>]

где

<dbConnections_name> — название строки подключения к базе данных, должно соответствовать одному из созданных ранее подключений dbConnections (описание приведено выше);

<PATH> — путь, по которому нужно сохранять отчеты статистики в случае недоступности базы данных, опциональный параметр. Экспорт данных из этой директории выполняется автоматически при первом успешном подключении к базе данных.

Примеры

  1. Экспорт в базу данных:

    /cluster/mediator/md1/statistics/add hostResources 5 rpss_db_export stat_conn

  2. Экспорт в базу данных с указанием директории для хранения:

    /cluster/mediator/md1/statistics/add hostResources 5 rpss_db_export stat_conn --recovery-dir /var/lib/ecss/statistics

  3. Экспорт в текстовый файл с расширением "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" будут удалены все правила.

Пример

  1. Удаление всех правил:

    /cluster/mediator/md1/statistics/delete all

  2. Удаление определенного правила:

    /cluster/mediator/md1/statistics/delete 17a13034-3937-3439-3334-613664666363