Модули экспорта статистики

Система ECSS-10 позволяет сохранять статистическую информацию на файловую систему в виде текстового файла в формате CSV либо в базу данных.

Текстовые файлы CSV

Если в системе было настроено сохранение статистики, но не был указан путь для хранения данных, то по умолчанию текстовые файлы CSV будут сохраняться в каталоге: /var/lib/ecss/<TYPE>/<NAME>/statistics.

где

• <TYPE> — тип владельца: domain, cluster;
• <NAME> — имя владельца.

В формате текстового файла могут быть использованы следующие переменные замены:

• #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

Поскольку в системе могут использоваться отличные от приведенных по умолчанию значения, то более подробную информацию о пути для сохранения статистики, формате файлов и составе модулей статистики вашей системы можно узнать у администраторов системы.

База данных

Для управления базой данных (далее БД) статистики используется СУБД MySQL.

Для просмотра статистики необходимо:

1. Подключиться к локальной консоли СУБД MySQL из под операционной системы Linux:
   mysql -u<STATISTIC_LOGIN> -p<STATISTIC_PASSWORD>
   где
   
   • <STATISTIC_LOGIN> — логин для пользователя БД статистики (логин задается при создании БД);
   • <STATISTIC_PASSWORD> — пароль для пользователя БД статистики (пароль задается при создании БД).

2. Указать базу данных для просмотра статистики:
   use <DB_NAME>;
   где

   • <DB_NAME> — имя БД статистики (задается при создании БД, в руководстве по настройке предложено использовать имя базы данных "statistics").

3. Просмотреть существующие таблицы в БД статистики:
   show tables;
   Пример

   mysql> show tables;
   +---------------------------+
   | Tables_in_ecss_statistics |
   +---------------------------+
   | E.502 Type1               |
   | E.502 Type10              |
   | E.502 Type11              |
   | E.502 Type12              |
   | E.502 Type15              |
   | E.502 Type16              |
   | E.502 Type2               |
   | E.502 Type20              |
   | E.502 Type3               |
   | E.502 Type6               |
   | E.502 Type9               |
   | Host.Resources            |
   | Iface.data.transter       |
   | MG.Traffic                |
   +---------------------------+
   14 rows in set (0.00 sec)

4. Просмотреть информацию в таблице можно командой:
   select * from `<TABLE_NAME>`;
   где
   — <TABLE_NAME> — имя таблицы.
   В команде реализована выборка записей по дате и количеству записей.
   Пример
   

   • Выборка записей по дате:

     select * from `E.502 Type16` where sys_end_date like '%2013-08-26%';

   • Просмотр последних десяти записей в таблице:

     mysql> select * from `E.502 Type16` ORDER BY `sys_stat_id` DESC LIMIT 10;
     +--------------------------------------+---------------------+---------------------+------------------------+---------------------+---------------+-------------------+---------+--------+
     | sys_stat_id                          | sys_start_date      | sys_end_date        | source                 | timeSeizureInlet    | dialledDigits | unsuccessfulCause | timeACM | result |
     +--------------------------------------+---------------------+---------------------+------------------------+---------------------+---------------+-------------------+---------+--------+
     | 31373034-6261-3137-3932-626564653435 | 2013-08-26 07:45:00 | 2013-08-26 08:00:00 | sub:300@192.168.23.212 | 2013-08-26 07:56:19 |               |              NULL | NULL    |     16 |
     | 31373034-6261-3137-3932-626564653435 | 2013-08-26 07:45:00 | 2013-08-26 08:00:00 | sub:300@192.168.23.212 | 2013-08-26 07:56:26 |               |              NULL | NULL    |     41 |
     | 31373034-6261-3137-3932-626564653435 | 2013-08-26 07:45:00 | 2013-08-26 08:00:00 | sub:300@192.168.23.212 | 2013-08-26 07:55:10 |               |              NULL | NULL    |     41 |
     | 31373034-6261-3137-3932-626564653435 | 2013-08-26 07:45:00 | 2013-08-26 08:00:00 | sub:100@192.168.23.212 | 2013-08-26 07:55:16 |               |              NULL | NULL    |     16 |
     | 31373034-6261-3137-3932-626564653435 | 2013-08-26 07:45:00 | 2013-08-26 08:00:00 | sub:300@192.168.23.212 | 2013-08-26 07:53:34 |               |              NULL | NULL    |     16 |
     | 31373034-6261-3137-3932-626564653435 | 2013-08-26 07:45:00 | 2013-08-26 08:00:00 | sub:700@192.168.23.212 | 2013-08-26 07:47:03 |               |              NULL | NULL    |     17 |
     | 31373034-6261-3137-3932-626564653435 | 2013-08-26 07:45:00 | 2013-08-26 08:00:00 | sub:100@192.168.23.212 | 2013-08-26 07:54:34 |               |                41 | NULL    |   NULL |
     | 31373034-6261-3137-3932-626564653435 | 2013-08-26 07:45:00 | 2013-08-26 08:00:00 | sub:100@192.168.23.212 | 2013-08-26 07:54:50 |               |              NULL | NULL    |     41 |
     | 31373034-6261-3137-3932-626564653435 | 2013-08-26 07:45:00 | 2013-08-26 08:00:00 | sub:300@192.168.23.212 | 2013-08-26 07:53:58 |               |              NULL | NULL    |     41 |
     | 31373034-6261-3137-3932-626564653435 | 2013-08-26 07:45:00 | 2013-08-26 08:00:00 | sub:100@192.168.23.212 | 2013-08-26 07:54:05 |               |              NULL | NULL    |     16 |
     +--------------------------------------+---------------------+---------------------+------------------------+---------------------+---------------+-------------------+---------+--------+
     10 rows in set (0.00 sec)

     CODE

Также для администрирования БД используются приложения с web-интерфейсом. Одним из таких приложений является phpmyadmin. Phpmyadmin позволяет через браузер осуществлять администрирование сервера MySQL, запускать команды SQL и просматривать содержимое таблиц и баз данных. 

Модули статистики

ITU-T E.502

e502Type1

e502Type1 — Overall measurements on originating traffic.

Данный модуль предназначен для сбора статистики по Типу 1 рекомендации ITU-T E.502.

Тип измерения — Абонентские линии: весь исходящий трафик.

Таблица 1 — Формат выходных данных e502Type1

e502Type2

e502Type2 — Overall measurements on internal traffic.

Данный модуль предназначен для сбора статистики по Типу 2 рекомендации ITU-T E.502.

Тип измерения — Абонентские линии: внутренний исходящий трафик.

Таблица 2 — Формат выходных данных e502Type2

e502Type3

e502Type — Overall measurements on originating outgoing traffic.

Данный модуль предназначен для сбора статистики по Типу 3 рекомендации ITU-T E.502.

Тип измерения — Абонентские линии: внешний исходящий трафик.

Таблица 3 — Формат выходных данных e502Type3

e502Type4

e502Type4 — Overall measurements on incoming traffic.

Данный модуль предназначен для сбора статистики по Типу 4 рекомендации ITU-T E.502.

Тип измерения — Группа каналов: входящий трафик.

Таблица 4 — Формат выходных данных e502Type4

e502Type5

e502Type5 — Overall measurements on incoming terminating traffic.

Данный модуль предназначен для сбора статистики по Типу 5 рекомендации ITU-T E.502.

Тип измерения — Группа каналов: входящий терминируемый (нетранзитный) трафик.

Таблица 5 — Формат выходных данных e502Type5

e502Type6

e502Type6 — Overall measurements on transit traffic.

Данный модуль предназначен для сбора статистики по Типу 6 рекомендации ITU-T E.502.

Тип измерения — Группа каналов: транзитный трафик.

Таблица 6 — Формат выходных данных e502Type6

e502Type9

e502Type9 — Incoming traffic measurements.

Данный модуль предназначен для сбора статистики по Типу 9 рекомендации ITU-T E.502.

Тип измерения — Группа каналов: входящий трафик.

Таблица 7 — Формат выходных данных e502Type9

e502Type10

e502Type10 — Outgoing traffic measurements.

Данный модуль предназначен для сбора статистики по Типу 10 рекомендации ITU-T E.502.

Тип измерения — Группа каналов: исходящий трафик.

Таблица 8 — Формат выходных данных e502Type10

e502Type11

e502Type11 — Route destination traffic measurements.

Данный модуль предназначен для сбора статистики по Типу 11 рекомендации ITU-T E.502.

Тип измерения — Группа каналов: исходящий трафик по направлениям.

Таблица 9 — Формат выходных данных e502Type11

e502Type12

e502Type12 — Measurements on subscriber line groups.

Данный модуль предназначен для сбора статистики по Типу 12 рекомендации ITU-T E.502.

Тип измерения — Группа абонентских линий: входящий/исходящий трафик.

Таблица 10 — Формат выходных данных e502Type12

e502Type15

e502Type15 — Traffic dispersion and duration.

Данный модуль предназначен для сбора статистики по Типу 15 рекомендации ITU-T E.502.

Тип измерения — Трафик: дисперсия и продолжительность.

Таблица 11 — Формат выходных данных e502Type15

e502Type16

e502Type16 — Quality-of-service assessment.

Данный модуль предназначен для сбора статистики по Типу 16 рекомендации ITU-T E.502.

Тип измерения — Оценка качества обслуживания

Таблица 12 — Формат выходных данных e502Type16

e502Type20

e502Type20 — Exchange performance monitoring.

Данный модуль предназначен для сбора статистики по Типу 20 рекомендации ITU-T E.502.

Тип измерения — Мониторинг производительности.

Таблица 13 — Формат выходных данных e502Type20

ITU-T Q.752

q752Table1

q752Table1 — MTP signalling link faults and performance.

Данный модуль предназначен для сбора статистики Таблица 1 рекомендации ITU-T Q.752.

Тип измерения — Отказы тракта сигнализации и качество работы.

Таблица 14 — Формат выходных данных q752

q752Table2

q752Table2 — MTP signalling link availability.

Данный модуль предназначен для сбора статистики Таблица 2 рекомендации ITU-T Q.752.

Тип измерения — Доступность тракта сигнализации МТР.

Таблица 15 — Формат выходных данных q752Table2

q752Table3

q752Table3 — MTP signalling link utilization.

Данный модуль предназначен для сбора статистики Таблица 3 рекомендации ITU-T Q.752.

Тип измерения — Использование тракта сигнализации МТР.

Таблица 16 — Формат выходных данных q752Table3

q752Table4

q752Table4 — MTP signalling link set and route set availability.

Данный модуль предназначен для сбора статистики Таблица 4 рекомендации ITU-T Q.752.

Тип измерения — Доступность комплекта трактов сигнализации и набора маршрутов.

Таблица 17 — Формат выходных данных

q752Table5

q752Table5 — MTP signalling point status.

Данный модуль предназначен для сбора статистики Таблица 5 рекомендации ITU-T Q.752.

Тип измерения — Статус пункта сигнализации МТР.

Таблица 18 — Формат выходных данных q752Table5

q752Table15

q752Table15 — SS No. 7 MTP message accounting.

Данный модуль предназначен для сбора статистики Таблица 15 рекомендации ITU-T Q.752.

Тип измерения — Учет сообщений МТР ОКС №7.

Таблица 19 — Формат выходных данных q752Table15

Другие типы статистик

mgTraffic

mgTraffic — MG traffic statistics.

Тип измерения — Данный модуль предназначен для сбора статистики с медиашлюза (MG).

Таблица 20 — Формат выходных данных mgTraffic

hostResources

hostResources — Host resources.

Тип измерения — Данный модуль предназначен для сбора статистики с кластеров системы ECSS-10.

Таблица 21 — Формат выходных данных hostResources

Cтатистика с агрегацией данных

Метрики реального времени с агрегацией данных

ECSS-10 и сопутствующие сервисы (например, контакт-центр или селекторная связь) формируют различные статистические метрики.

Система работает таким образом, что ПО формирует счетчики используя модуль ecss_statistics, который хранит счетчики в ets таблицах ноды (используется exometer_core).
Модуль ecss_statistics с заданной периодичностью осуществляет выгрузку значений счетчиков в СУБД MySQL в БД ecss_statistics в таблицу realtime_statistics.

Пример — список таблиц БД статистики:

sasha@ecss1:~$ mysql -ustatistics -p -D ecss_statistics -e 'show tables;'
Enter password: 
+---------------------------------+
| Tables_in_ecss_statistics       |
+---------------------------------+
| Host.Resources                  |
| historical_daily_statistics     |
| historical_hour_statistics      |
| historical_intrahour_statistics |
| historical_monthly_statistics   |
| historical_weekly_statistics    |
| realtime_statistics             |
| realtime_statistics_0           |
| realtime_statistics_1           |
| realtime_statistics_10          |
| realtime_statistics_11          |
| realtime_statistics_2           |
| realtime_statistics_3           |
| realtime_statistics_4           |
| realtime_statistics_5           |
| realtime_statistics_6           |
| realtime_statistics_7           |
| realtime_statistics_8           |
| realtime_statistics_9           |
| realtime_statistics_template    |
| stat_details                    |
| version                         |
+---------------------------------+

Счетчики могут быть разных типов (counter, gauge, histogram и др.), а так же могут быть непрерывными и с автосбросом значений после считывания (autoreset).

У счетчика есть имя и значение. Значение могут содержать несколько величин и зависит от типа счетчика.
Имя — это список термов, что позволяет формировать иерархическую (древовидную) структуру метрик.

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

• - intrahour (5ти минутки) — 62 дня
• - hour (1 час) — 62 дня
• - daily (1 день) — 5 лет
• - weekly (недельные) — 10 лет
• - monthly (за месяц) — 10 лет

В ECSS-10 принят следующий формат описания имени счетчика:
[SystemPrefix, Domain, SubsystemPrefix, MetricName, VariablePart1, VariablePart2, MetricType].

• SystemPrefix — идентифицирует систему генерирующую метрику и может принимать следующие значения:
  • ecss10.common — метрики общие для всех систем
  • ecss10.ssw — метрики специфичные для софтсвича
  • ecss10.cc — метрики специфичные для контакт-центра
  • ecss10.tc — метрики специфичные для сервиса селекторной связи (teleconference)
• Domain — идентификатор домена (виртуальной АТС) в рамках которого генерируется метрика
• SubsystemPrefix — идентифицирует подсистему в рамках выбранной системы, которая генерирует метрику и может принимать следующие значения:
  • queue — очередь (специфична для контакт-центра)
  • agent — агент (специфична для контакт-центра)
  • core — ядро (специфичная для софтсвича)
  • sip — адаптер протокола sip (специфичная для софтсвича)
  • megaco — адаптер протокола megaco (специфичная для софтсвича)
  • sigtran — адаптер протокола sigtran (специфичная для софтсвича)
  • mediator — медиатор (специфичная для софтсвича)
  • mycelium — брокер интеграционной шини (специфичная для софтсвича)
  • trunk_manager — менеджер транков
  • direction_manager — менеджер направлений
• MetricName — фиксированное имя метрики, должно описывать значение которое содержится в метрике, рекомендуется, чтобы так же был указан тип метрики
• VariablePart1 — 1я дополнительная переменная часть имени метрики, специфичная для конкретной метрики (может, например, содержать имя транка, имя очереди и т.п.)
• VariablePart2 — 2я дополнительная переменная часть имени метрики, специфичная для конкретной метрики (может, например, содержать идентификатор агента)
• MetricType — определяет тип метрики, может принимать следующие значения:
  • counter
  • gauge
  • meter
  • histogram

Ниже приведена таблица метрик реального времени генерируемых системой:

Модуль ecss_statistics

Модуль cc_active_queue

Модуль core_trike_tm

Модуль core_trike_dm

Модуль core_trike_cmp

Модуль custom_cb_trike_task_service

Вызывные статистики

В системе ECSS-10 реализована запись в БД вызывной статистики. Описание метрик приведено ниже.

У всех этих метрик система — ecss10.ssw и подсистема core. Доменные метрики имеют в поле БД имя своего домена, у системных домен — .system.

Если не написано обратного, у всех метрик значащим полем является value.

Команды просмотра вызывных статистических данных доступны из CLI и приведены в разделе "/domain/<DOMAIN>/core/statistics/ - команда просмотра статистик ядра системы"

Также есть возможность визуализировать данные с помощью отдельной системы Grafana.

Фильтры произвольной вызывной статистики

В системе ECSS-10 разработан механизм для создания пользователем произвольных метрик/статистик на основе вызывных данных (данных, на основе которых генерируются CDR, а именно mysql таблицы ecss_calls_db.tolltickets).

Каждый фильтр проверяет, если данный вызов соответствует заданным правилам rules (критериям, условиям), то в метрику с именем metric_name, переменными частями variable_part_1, variable_part_2 записывается +1 вызов. Т.е. метрика metric_name показывает сколько было вызовов, удовлетворяющих условиям описанным в правиле rules.

Список правил в фильтре работает по принципу "И", т.е. чтобы фильтр сработал все правила должны вернуть true.
Если же нам надо, чтобы в одну метрику попадали вызовы по разными критериям (по принципу "ИЛИ"), то необходимо сознать несколько фильтров, у которых параметр metric_name совпадает.

В качестве переменных частей (variable_part_1, variable_part_2), а также сравниваемого значения, можно использовать как фиксированные названия, так и макро-переменные. В этом случае вместо макро-переменной подставится значение из CDR записи вызова. Возможные значения макро-переменных:

• $OADDR_A — номер абонента А до маршрутизации
• $OADDR_B — номер абонента Б до маршрутизации
• $ADDR_A — номер абонента А после маршрутизации
• $ADDR_B — номер абонента Б после маршрутизации
• $RELEASE_CAUSE_A — Причина завершения вызова для абонента А
• $RELEASE_CAUSE_B — Причина завершения вызова для абонента B
• $RELEASE_CAUSE — Причина завершения вызова (зависит от release_initiator: 0/1 — для абонента А, 2 — для абонента B)
• $RELEASE_CAUSE_ISUP_A — ISUP причина завершения вызова для абонента А
• $RELEASE_CAUSE_ISUP_B — ISUP причина завершения вызова для абонента B
• $RELEASE_CAUSE_ISUP — ISUP причина завершения вызова (зависит от release_initiator: 0/1 — для абонента А, 2 — для абонента B)
• $RELEASE_INITIATOR — Сторона-инициатор релиза: 0 — system, 1 — calling, 2 — called
• $IFACE_A — Интерфейс абонента А
• $IFACE_B — Интерфейс абонента B
• $CATEGORY_A — Категория абонента А
• $CATEGORY_B — Категория абонента B
• $ENDPOINT_A_HOST — IP абонента А
• $ENDPOINT_A_PORT — Port абонента А
• $ENDPOINT_B_HOST — IP абонента B
• $ENDPOINT_B_PORT — Port абонента B
• $ISUP_SPC_A — SPC код абонента А
• $ISUP_SPC_B — SPC код абонента B
• $ISUP_DPC_A — DPC код абонента А
• $ISUP_DPC_B — DPC код абонента B
• $ISUP_NI_A — Тип сети абонента А
• $ISUP_NI_B — Тип сети абонента B
• $CIC_A — Номер CIC абонента А
• $CIC_B — Номер CIC абонента B
• $MODE — тип вызова(acd | callback | internal | message | mgm | normal | refer | supervise)
  • normal — обычный вызов. Вызовы, не относящиеся ни к одной из категорий, упомянутых ниже в этом списке, являются обычными и обладают mode = normal.
  • acd (automatic call distribution) — вызов, который инициирует очередь для соединения с оператором.
  • callback — обратный вызов, инициируемый одним из сервисов ДВО. Например Alarm, Callback, Custom Callback, Autoredial With Callback.
  • internal — служебный вызов, используемый некоторыми сервисами ДВО для внутренних нужд. Данные вызовы не попадают в CDR.
  • message — вызов, инициируемый сервисом CSTA SendMessage (ECMA-269 17.1.24 Send Message).
  • mgm — управление ДВО, выполняемое с телефонного аппарата.
  • refer — вызов, инициируемый SSW, в ответ на сообщение Refer (IETF draft-mahy-sip-remote-cc-05 Remote Call Control in SIP using the REFER method and the session-oriented dialog package).
  • supervise — вызов, инициируемый для присоединения к разговору супервизора КЦ.
• $OCDPN — оригинальный номер Б
• $RGN — redirecting number
• $RN — redirection number
• $TG_A — Транк-группа интерфейса абонента А
• $TG_B — Транк-группа интерфейса абонента B
• $CDR_GROUP — Имя CDR группы
• $IVR_WIDGET_ID — Идентификатор widget-а, для вызовов с IVR
• $CC_AGENT_A_ID — Идентификатор агента КЦ для абонента А
• $CC_AGENT_B_ID — Идентификатор агента КЦ для абонента B
• $CC_AGENT_A_GROUP — Имя группы, которой принадлежит агент КЦ для абонента А
• $CC_AGENT_B_GROUP — Имя группы, которой принадлежит агент КЦ для абонента B
• $CC_QUEUE — Имя очереди КЦ из которой пришел вызов
• $RATING — Значение из IVR блока "Оценка"

Отдельная категория макропеременных — динамически формируемые списки.

• $INVALID_NUMBER_RELEASE_CAUSES — список причин завершения вызова, отмеченных как "набор номера вне плана набора"
• $UNSUCCESSFUL_RELEASE_CAUSES — список причин завершения вызова, отмеченных как "неуспешные" (управляется с помощью команд /domain/<DOMAIN>/tts/statistics/<CMD> unsuccessful_release_causes)

Макропеременные на основе этих динамически формируемых списков работают только с оператором "in", и логически оправданное применение — только с фильтрами на основе release_cause_a(b), например:

release_cause_b in $UNSUCCESSFUL_RELEASE_CAUSE
release_cause_a in $INVALID_NUMBER_RELEASE_CAUSES

Использовать эти макропеременные в качестве variable_part_1(2) нельзя.

Каждое из правил в рамках фильтра представляет собой набор из трех полей:

1. Имя поля, на которое действует данное правило.

Возможные имена полей:

• oaddr_a — номер абонента А до маршрутизации
• oaddr_b — номер абонента B до маршрутизации
• addr_a — номер абонента А после маршрутизации
• addr_b — номер абонента B после маршрутизации
• dialed_digits — набранные цифры
• release_cause_a — причина завершения вызова для стороны А
• release_cause_isup_a — ISUP причина завершения вызова для стороны А
• release_description_a — текстовое описание причины релиза для стороны А
• release_cause_b — причина завершения вызова для стороны B
• release_cause_isup_b — ISUP причина завершения вызова для стороны B
• release_description_b — текстовое описание причины релиза для стороны B
• release_initiator — сторона-инициатор релиза: 0 — system, 1 — calling, 2 — called
• iface_a — интерфейс абонента А
• iface_b — интерфейс абонента B
• display_name_a — displayName абонента А после маршрутизации
• display_name_b — displayName абонента B после маршрутизации
• category_a — категория абонента А
• category_b — категория абонента B
• endpoint_a_host — IP сигнализации абонента А
• endpoint_a_port — порт сигнализации абонента А
• endpoint_b_host — IP сигнализации абонента Б
• endpoint_b_port — порт сигнализации абонента Б
• original_called_num — оригинальный номера абонента Б в случае переадресаций
• redirecting_num — redirecting номер
• redirection_num — redirection номер
• trunk_group_id_a — ID транка для стороны А
• trunk_group_id_b — ID транка для стороны B
• ivr_widget_id — идентификатор widget-а, для вызовов с IVR (сервиса CallBack).
• cdr_group — имя CDR группы
• cc_agent_a_id — Идентификатор агента КЦ для абонента А
• cc_agent_b_id — Идентификатор агента КЦ для абонента B
• cc_agent_a_group — Имя группы, которой принадлежит агент КЦ для абонента А
• cc_agent_b_group — Имя группы, которой принадлежит агент КЦ для абонента B
• cc_queue — Имя очереди КЦ из которой пришел вызов
• rating — Значение из IVR блока "Оценка"
• dpc — параметр DPC для вызовов через SIGTRAN
• is_answered — флаг, отвечен ли вызов

2. Оператор, который применяется к полю из п.1

Возможные операторы:

• = — сравнение поля с введенным значением
• in — проверяется, что поле соответствует одному из значений в списке в п.3
• like — проверяет, что значение из п.3 является подстрокой поля из п.1 (доступно только для текстовых полей)
• digitmap — проверяется, что поле удовлетворяет digitmap-у, записанному в значение из п.3 (доступно только для полей, в которых содержатся номера телефонов).
  А так же можно указать признак not, который означает что результат применения оператора будет инвертирован

3. Значение — значение для правила.

Возможные значения:

• фиксированное значение
• логически оправданная макропеременная

Описание команд для работы с фильтрами произвольной вызывной статистике приведено в разделе "/domain/<DOMAIN>/core/statistics/calls/filter — Команды управления фильтрами произвольной вызывной статистики"

Визуализация статистических данных в системе мониторинга "Grafana"

Система мониторинга ECSS-10 основана на Grafana, свободном фронтенде для визуализации time-series данных из различных источников, и предназначена для наблюдения за метриками программного коммутатора. Система поставляется в виде докер-контейнера, образ которого лежит в корпоративном репозитории. Для его корректной работы необходимы работающий ECSS-10 и сервер MySQL, на который загружаются метрики.

Docker

В качестве примера, установим систему grafana в docker-контейнере на машине с ОС Ubuntu-19.04. С этой машины должен быть доступен адрес или имя mysql-сервера ECSS-10.

Установка docker

В сети имеется много информации про контейнеризацию с помощью docker, познакомиться с возможностями и процессом установки не составит труда. Например, здесь описана неплохая инструкция по инсталляции.

Обновим индекс пакетов:

sudo apt update

Установим зависимости:

 sudo apt install apt-transport-https ca-certificates curl gnupg-agent software-properties-common

Теперь можно загрузить и установить пакет Docker Добавьте в систему GPG-ключ репозитория Docker:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

Добавьте этот репозиторий в APT:

sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable edge" 

Еще раз обновим индекс пакетов:

sudo apt update

Следующая команда позволяет переключиться из репозитория Ubuntu 19.04 в репозиторий Docker:

apt-cache policy docker-ce

Команда должна вернуть примерно следующее:

sasha@bsk2:~/soft/docker$ apt-cache policy docker-ce
docker-ce:
  Установлен: (отсутствует)
  Кандидат:   5:19.03.12~3-0~ubuntu-eoan
  Таблица версий:
     5:19.03.12~3-0~ubuntu-eoan 500
        500 https://download.docker.com/linux/ubuntu eoan/stable amd64 Packages
        500 https://download.docker.com/linux/ubuntu eoan/edge amd64 Packages
     5:19.03.11~3-0~ubuntu-eoan 500
        500 https://download.docker.com/linux/ubuntu eoan/stable amd64 Packages
        500 https://download.docker.com/linux/ubuntu eoan/edge amd64 Packages
     5:19.03.10~3-0~ubuntu-eoan 500
        500 https://download.docker.com/linux/ubuntu eoan/stable amd64 Packages
        500 https://download.docker.com/linux/ubuntu eoan/edge amd64 Packages
     5:19.03.9~3-0~ubuntu-eoan 500
        500 https://download.docker.com/linux/ubuntu eoan/stable amd64 Packages
        500 https://download.docker.com/linux/ubuntu eoan/edge amd64 Packages
     5:19.03.8~3-0~ubuntu-eoan 500
        500 https://download.docker.com/linux/ubuntu eoan/stable amd64 Packages
        500 https://download.docker.com/linux/ubuntu eoan/edge amd64 Packages
     5:19.03.7~3-0~ubuntu-eoan 500
        500 https://download.docker.com/linux/ubuntu eoan/stable amd64 Packages
        500 https://download.docker.com/linux/ubuntu eoan/edge amd64 Packages
     5:19.03.6~3-0~ubuntu-eoan 500
        500 https://download.docker.com/linux/ubuntu eoan/stable amd64 Packages
        500 https://download.docker.com/linux/ubuntu eoan/edge amd64 Packages

Обратите внимание: пакет docker-ce пока не установлен. Чтобы установить Docker Engine — Community, введите:

sudo apt install docker-ce docker-ce-cli containerd.io

После этого программа Docker будет установлена; также это запустит демона и настроит автозапуск процесса. Чтобы убедиться в том, что программа работает, запросите её состояние:

sasha@bsk2:~/soft/docker$ systemctl status docker
● docker.service — Docker Application Container Engine
   Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
   Active: active (running) since Fri 2020-06-26 09:41:50 +07; 57s ago
     Docs: https://docs.docker.com
 Main PID: 24689 (dockerd)
    Tasks: 13
   Memory: 38.2M
   CGroup: /system.slice/docker.service
           └─24689 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

июн 26 09:41:48 bsk2 dockerd[24689]: time="2020-06-26T09:41:48.554642224+07:00" level=warning msg="Your kernel does not support cgroup rt runtime"
июн 26 09:41:48 bsk2 dockerd[24689]: time="2020-06-26T09:41:48.554661303+07:00" level=warning msg="Your kernel does not support cgroup blkio weight"
июн 26 09:41:48 bsk2 dockerd[24689]: time="2020-06-26T09:41:48.554679115+07:00" level=warning msg="Your kernel does not support cgroup blkio weight_device"
июн 26 09:41:48 bsk2 dockerd[24689]: time="2020-06-26T09:41:48.555139402+07:00" level=info msg="Loading containers: start."
июн 26 09:41:49 bsk2 dockerd[24689]: time="2020-06-26T09:41:49.249973073+07:00" level=info msg="Default bridge (docker0) is assigned with an IP address 172.17.0.0/16. Daemon option --bip can be used to set
июн 26 09:41:49 bsk2 dockerd[24689]: time="2020-06-26T09:41:49.523473365+07:00" level=info msg="Loading containers: done."
июн 26 09:41:49 bsk2 dockerd[24689]: time="2020-06-26T09:41:49.933525762+07:00" level=info msg="Docker daemon" commit=48a66213fe graphdriver(s)=overlay2 version=19.03.12
июн 26 09:41:49 bsk2 dockerd[24689]: time="2020-06-26T09:41:49.933798200+07:00" level=info msg="Daemon has completed initialization"
июн 26 09:41:50 bsk2 dockerd[24689]: time="2020-06-26T09:41:50.311811318+07:00" level=info msg="API listen on /run/docker.sock

Теперь в системе работает сервис Docker.

Добавление пользователя в группу

По умолчанию команда docker требует привилегий root (или доступа к команде sudo). Также её можно запускать в группе docker, которая создаётся автоматически во время установки программы Docker.

Если вы попытаетесь запустить команду docker без префикса sudo и вне группы docker, вы получите ошибку:

docker: Cannot connect to the Docker daemon. Is the docker daemon running on this host?.
See 'docker run --help'.

Чтобы не пришлось набирать префикс sudo каждый раз, когда вам нужно запустить команду docker, добавьте своего пользователя в группу docker:

sudo usermod -aG docker ${USER}

Чтобы активировать это изменение, выйдите из системы и войдите снова, или же введите:

su — ${USER}

При этом будет запрошен пароль вашего пользователя.

Убедитесь, что пользователь добавлен в группу:

sasha@bsk2:~$ id -nG
sasha adm cdrom sudo dip plugdev lpadmin sambashare wireshark docker

Чтобы добавить в группу docker пользователя, который не является текущим, укажите в команде его имя:

sudo usermod -aG docker username

Можно проверить, что docker работает:

sasha@bsk2:~$ docker run hello-world

Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
 1. The Docker client contacted the Docker daemon.
 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
    (amd64)
 3. The Docker daemon created a new container from that image which runs the
    executable that produces the output you are currently reading.
 4. The Docker daemon streamed that output to the Docker client, which sent it
    to your terminal.

To try something more ambitious, you can run an Ubuntu container with:
 $ docker run -it ubuntu bash

Share images, automate workflows, and more with a free Docker ID:
 https://hub.docker.com/

For more examples and ideas, visit:
 https://docs.docker.com/get-started/

Подробную информацию о командах docker можно получить из справки:

sasha@bsk2:~$ docker help

Usage:	docker [OPTIONS] COMMAND

A self-sufficient runtime for containers

Options:
      --config string      Location of client config files (default "/home/sasha/.docker")
  -c, --context string     Name of the context to use to connect to the daemon (overrides DOCKER_HOST env var and default context set with "docker context use")
  -D, --debug              Enable debug mode
  -H, --host list          Daemon socket(s) to connect to
  -l, --log-level string   Set the logging level ("debug"|"info"|"warn"|"error"|"fatal") (default "info")
      --tls                Use TLS; implied by --tlsverify
      --tlscacert string   Trust certs signed only by this CA (default "/home/sasha/.docker/ca.pem")
      --tlscert string     Path to TLS certificate file (default "/home/sasha/.docker/cert.pem")
      --tlskey string      Path to TLS key file (default "/home/sasha/.docker/key.pem")
      --tlsverify          Use TLS and verify the remote
  -v, --version            Print version information and quit

Management Commands:
  builder     Manage builds
  config      Manage Docker configs
  container   Manage containers
  context     Manage contexts
  engine      Manage the docker engine
  image       Manage images
  network     Manage networks
  node        Manage Swarm nodes
  plugin      Manage plugins
  secret      Manage Docker secrets
  service     Manage services
  stack       Manage Docker stacks
  swarm       Manage Swarm
  system      Manage Docker
  trust       Manage trust on Docker images
  volume      Manage volumes

Commands:
  attach      Attach local standard input, output, and error streams to a running container
  build       Build an image from a Dockerfile
  commit      Create a new image from a container's changes
  cp          Copy files/folders between a container and the local filesystem
  create      Create a new container
  diff        Inspect changes to files or directories on a container's filesystem
  events      Get real time events from the server
  exec        Run a command in a running container
  export      Export a container's filesystem as a tar archive
  history     Show the history of an image
  images      List images
  import      Import the contents from a tarball to create a filesystem image
  info        Display system-wide information
  inspect     Return low-level information on Docker objects
  kill        Kill one or more running containers
  load        Load an image from a tar archive or STDIN
  login       Log in to a Docker registry
  logout      Log out from a Docker registry
  logs        Fetch the logs of a container
  pause       Pause all processes within one or more containers
  port        List port mappings or a specific mapping for the container
  ps          List containers
  pull        Pull an image or a repository from a registry
  push        Push an image or a repository to a registry
  rename      Rename a container
  restart     Restart one or more containers
  rm          Remove one or more containers
  rmi         Remove one or more images
  run         Run a command in a new container
  save        Save one or more images to a tar archive (streamed to STDOUT by default)
  search      Search the Docker Hub for images
  start       Start one or more stopped containers
  stats       Display a live stream of container(s) resource usage statistics
  stop        Stop one or more running containers
  tag         Create a tag TARGET_IMAGE that refers to SOURCE_IMAGE
  top         Display the running processes of a container
  unpause     Unpause all processes within one or more containers
  update      Update configuration of one or more containers
  version     Show the Docker version information
  wait        Block until one or more containers stop, then print their exit codes

Run 'docker COMMAND --help' for more information on a command.

Запуск контейнера с Grafana

Установка

Образ контейнера ecss_grafana можно получить, сделав запрос в техническую поддержку.

Для загрузки образа необходимо выполнить команду:

docker load -i ecss_grafana.tar

Запуск

Для запуска системы мониторинга достаточно указать только порт <port>, который будет соответствовать порту Grafana (3000):

docker run -p <port>:3000 ecss_grafana

Предполагается, что будут использоваться стандартные параметры доступа, указанные ниже. Если же какие-то параметры должны отличаться, необходимо воспользоваться переменными окружения:

Например, если нужно указать иное доменное имя/IP сервера MySQL (например ssw1.eltex.loc):

docker run -p 3000:3000 -e MYSQL_HOST='ssw1.eltex.loc' ecss_grafana

Если имя резолвится через /etc/hosts, нужно добавить флаг:

-v /etc/hosts:/etc/hosts

Таким образом, для создания сервиса-демона, осуществляющего мониторинг офиса на порту 3000, понадобится сделать что-то вроде:

docker run -d -p 3000:3000 -e MYSQL_HOST='ssw1.eltex.loc' -v /etc/hosts:/etc/hosts --rm --name grafana ecss_grafana

Пример, если вместо имени используется IP MySQL:

docker run -d -p 3000:3000 -e MYSQL_HOST='192.168.1.71' --rm --name grafana ecss_grafana

Просмотр запущенных контейнеров:

bsk@bsk:~/tmp$ docker ps
CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS                    NAMES
99012354be4d        ecss_grafana        "/bin/run.sh"       43 seconds ago      Up 38 seconds       0.0.0.0:3000->3000/tcp   grafanaРабота с dashboard

Для удобства пользования системой мониторинга вместе с ней поставляются заранее созданные дашборды (наборы графиков), визуализирующие различные метрики ECSS-10. Описание метрик приведено в разделе "Cтатистика с агрегацией данных"
Для доступа к ним можно воспользоваться вкладкой "Manage dashboards" или панелью "Recently viewed dashboards", если она не пустая, на главной странице.

Для просмотра статистики нужно открыть требуемую метрику, например, вызывную статистику:

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

Пример отображения метрик ECSS-10:

Или статистики по транкам:

Также есть возможность редактирования и создания собственных дашбордов и источников данных. Для этого нужно перейти в раздел настроек("Configuration") и выбрать нужный источник данных, например, "ECSS-10 Statistics"

Подробнее о подключении собственных источников данных — в официальной документации по системе Grafana.