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

Система 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

ПозицияНазваниеОписание
1seizuresКоличество занятий.
2notRoutedКоличество вызовов, по которым не была выполнена маршрутизация по следующим причинам:
  • набор номера не был осуществлен;
  • набранный номер неполный;
  • набранный номер некорректный.
3congestionКоличество неуспешных вызовов из-за:
  • отсутствия свободных ресурсов, необходимых для обслуживания вызова;
  • ошибок системы.

e502Type2

e502Type2 — Overall measurements on internal traffic.

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

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

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

ПозицияНазваниеОписание
1seizuresКоличество занятий.
2congestionКоличество неуспешных вызовов из-за:
  • отсутствия свободных ресурсов, необходимых для обслуживания вызова;
  • ошибок системы.
3successfulКоличество успешных вызовов:
  • вызываемая сторона занята;
  • вызываемая сторона не отвечает;
  • получен ответ от вызываемой стороны.
4incompleteКоличество неуспешных вызовов.

e502Type3

e502Type — Overall measurements on originating outgoing traffic.

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

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

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

ПозицияНазваниеОписание
1seizuresКоличество занятий.
2congestionКоличество неуспешных вызовов из-за:
  • отсутствия свободных ресурсов, необходимых для обслуживания вызова;
  • ошибок системы.
3overflowКоличество необслуженных вызовов из-за отсутствия свободных каналов в направлении.
4successfulКоличество успешных вызовов.
5incompleteКоличество неуспешных вызовов:
  • набранный номер некорректный.

e502Type4

e502Type4 — Overall measurements on incoming traffic.

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

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

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

ПозицияНазваниеОписание
1seizuresКоличество занятий.
2notRoutedКоличество вызовов, по которым не была выполнена маршрутизация по следующим причинам:
  • набранный номер неполный;
  • набранный номер некорректный.
3congestionКоличество неуспешных вызовов из-за:
  • отсутствия свободных ресурсов, необходимых для обслуживания вызова;
  • ошибок системы.

e502Type5

e502Type5 — Overall measurements on incoming terminating traffic.

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

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

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

ПозицияНазваниеОписание
1seizuresКоличество занятий.
2congestionКоличество неуспешных вызовов из-за:
  • отсутствия свободных ресурсов, необходимых для обслуживания вызова;
  • ошибок системы.
3successfulКоличество успешных вызовов.
4incompleteКоличество неуспешных вызовов.

e502Type6

e502Type6 — Overall measurements on transit traffic.

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

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

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

ПозицияНазваниеОписание
1seizuresКоличество занятий.
2congestionКоличество неуспешных вызовов из-за:
  • отсутствия свободных ресурсов, необходимых для обслуживания вызова;
  • ошибок системы.
3overflowКоличество необслуженных вызовов из-за отсутствия свободных каналов в направлении.
4successfulКоличество успешных вызовов.
5incompleteКоличество неуспешных вызовов.

e502Type9

e502Type9 — Incoming traffic measurements.

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

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

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

ПозицияНазваниеОписание
1seizuresКоличество занятий.
2trafficЗначение нагрузки в эрлангах за интервал сбора статистической информации.
3congestionКоличество неуспешных вызовов из-за:
  • отсутствия свободных ресурсов, необходимых для обслуживания вызова;
  • ошибок системы.
4overflowКоличество необслуженных вызовов из-за отсутствия свободных каналов в направлении.
5inServiceКоличество рабочих сircuits.
6outServiceКоличество нерабочих сircuits.

e502Type10

e502Type10 — Outgoing traffic measurements.

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

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

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

ПозицияНазваниеОписание
1seizuresКоличество занятий.
2trafficЗначение нагрузки в эрлангах за интервал сбора статистической информации.
3overflowКоличество необслуженных вызовов из-за отсутствия свободных каналов в направлении.
4blockedКоличество необслуженных вызовов из-за trunk reservation.
5answeredКоличество отвеченных вызовов.
6inServiceКоличество рабочих сircuits.
7outServiceКоличество нерабочих сircuits.
8dualSeizuresКоличество занятий both-way circuits.

e502Type11

e502Type11 — Route destination traffic measurements.

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

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

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

ПозицияНазваниеОписание
1destinationНаименование направления.
2seizuresКоличество занятий.
3effectiveCallsКоличество состоявшихся разговоров.
4trafficЗначение нагрузки в эрлангах за интервал сбора статистической информации.
3

congestion

Количество неуспешных вызовов из-за:
  • отсутствия свободных ресурсов, необходимых для обслуживания вызова;
  • ошибок системы.
6blockedКоличество необслуженных вызовов из-за trunk reservation.
7sourceНаименование входящей circuit group.

e502Type12

e502Type12 — Measurements on subscriber line groups.

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

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

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

ПозицияНазваниеОписание
1origTrafficЗначение нагрузки в эрлангах за интервал сбора статистической информации
(исходящий трафик).
2termTrafficЗначение нагрузки в эрлангах за интервал сбора статистической информации
(терминируемый (входящий) трафик).
3origSeizuresКоличество исходящих занятий.
4termSeizuresКоличество терминируемых (входящих) занятий.
5termCallsКоличество успешных входящих занятий.

e502Type15

e502Type15 — Traffic dispersion and duration.

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

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

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

ПозицияНазваниеОписание
1inletНаименование инициатора вызова (абонентская линия, circuit group, system).
2timeSeizureInletВремя занятия на инициирующей стороне (inlet).
3dialledDigitsНабранные цифры (номер вызываемого абонента).
4servicesСписок сервисов, активированных в процессе обработки вызова.
5outletНаименование терминирующей стороны (абонентская линия, circuit group, system).
6timeSeizureOutletВремя занятия на терминирующей стороне (outlet).
7timeOccurrenceВремя начала обработки вызова на терминирующей стороне.
8timeACMВремя формирования сообщения ACM (address complete message.)
9timeAnswerВремя формирования сигнала ответа.
10timeReleaseOutletВремя релиза на терминирующей стороне.
11timeReleaseInletВремя релиза на инициирующей стороне.

e502Type16

e502Type16 — Quality-of-service assessment.

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

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

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

ПозицияНазваниеОписание
1sourceНаименование инициатора вызова (абонентская линия, circuit group, system).
2timeSeizureInletВремя занятия на инициирующей стороне (inlet).
3dialledDigitsНабранные цифры (номер вызываемого абонента).
4unsuccessfulCauseПричина неуспешного вызова.
5timeACMВремя формирования сообщения ACM (address complete message).
6resultРезультат вызова.

e502Type20

e502Type20 — Exchange performance monitoring.

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

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

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

ПозицияНазваниеОписание
1bidsКоличество занятий в направлениях (circuit groups).
2crossDelayMinМинимальное время задержки прохождения сигнала от инициирующей стороны (inlet) к терминирующей (outlet) (мкс).
3crossDelayMaxМаксимальное время задержки прохождения сигнала от инициирующей стороны (inlet) к терминирующей (outlet) (мкс).
4crossDelayAvgСреднее время задержки прохождения сигнала от инициирующей стороны (inlet) к терминирующей (outlet) (мкс).
5switchLossКоличество необслуженных вызовов.

ITU-T Q.752

q752Table1

q752Table1 — MTP signalling link faults and performance.

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

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

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

ПозицияНазваниеОписание
1clusterНазвание кластера, в который входят адаптеры SS7.
2spcКод пункта сигнализации.
3slidИдентификатор SL.
4durInServiceПродолжительность нахождения линии связи в состоянии обслуживания.
5failureAllReasonsСбой SL — все причины.
6localAutoChangeoverЛокальное автоматическое переключение.
7localAutoChangebackЛокальное автоматическое восстановление.
8restorationsВосстановление SL.

q752Table2

q752Table2 — MTP signalling link availability.

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

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

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

ПозицияНазваниеОписание
1clusterНазвание кластера, в который входят адаптеры SS7.
2spcКод пункта сигнализации.
3slidИдентификатор SL.
4durUnavailAllReasonsПродолжительность состояния недоступности SL (по любой причине).
5durUnavailLinkFailureПродолжительность недоступности SL, вследствие сбоя линии связи.
6durUnavailRemoteProcessorOutageПродолжительность недоступности SL, обусловленная выходом из строя удаленного процессора.
7startRemoteProcessorOutageВремя начала выхода из строя удаленного процессора.
8stopRemoteProcessorOutageВремя остановки выхода из строя удаленного процессора.

q752Table3

q752Table3 — MTP signalling link utilization.

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

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

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

ПозицияНазваниеОписание
1clusterНазвание кластера, в который входят адаптеры SS7.
2spcКод пункта сигнализации.
3slidИдентификатор SL.
4thresholdLevelПороговое значение загруженности SL.
5SIFandSIOoctetsTransКоличество переданных SIF и SIO октетов.
6octetsRetransmittedПовторно передаваемые октеты.
7MSUsTransmittedКоличество передаваемых сигнальных единиц сообщения.
8SIFandSIOoctetsReceivedКоличество полученных SIF и SIO октетов.
9MSUsReceivedКоличество полученных сигнальных единиц.
10congestionIndicationsПоказатели перегруженности SL.
11cumulativeDurationCongestionСуммарная продолжительность перегруженности SL.
12MSUsDiscardedCongestionMSU, выгружаемые из-за перегруженности SL.
13congestionEventsLossMSUsКоличество событий перегруженности, завершающихся потерей MSU.

q752Table4

q752Table4 — MTP signalling link set and route set availability.

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

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

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

ПозицияНазваниеОписание
1clusterНазвание кластера, в который входят адаптеры SS7.
2lsidИдентификатор комплекта трактов сигнализации.
3durUnavailLinkSetПродолжительность недоступности комплекта трактов сигнализации.
4startLinkSetFailureНачало выхода из строя комплекта трактов сигнализации.
5stoptLinkSetFailureПрекращение выхода из строя комплекта трактов сигнализации.
6initBroadcastTFPfailureLSИнициирование широковещательного TFP, вследствие отказа комплекта трактов сигнализации.
7initBroadcastTFArecoveryLSИнициирование широковещательного TFA для восстановления измеряемого комплекта трактов сигнализации.
8unavailRouteНедоступность набора маршрутов для данных направлений.
9durUnavailRouteПродолжительность недоступности набора маршрутов.
10startUnavailRouteНачало недоступности набора направлений.
11stopUnavailRouteПрекращение недоступности набора направлений.
12changeLSUsedAdjacentSPИзменение в комплекте трактов сигнализации, используемом для соседнего SP.

q752Table5

q752Table5 — MTP signalling point status.

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

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

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

ПозицияНазваниеОписание
1clusterНазвание кластера, в который входят адаптеры SS7.
2spcКод пункта сигнализации.
3NIИдентификатор сети.
4SIИдентификатор службы.
5adjacentSPinaccessСоседний SP недоступен.
6durAdjacentSPinaccessДлительность состояния недоступности соседнего SP.
7stopAdjacentSPinaccessПрекращение состояния недоступности соседнего SP.
8MSUdiscardedMSU, выгружаемые вследствие ошибки в данных маршрутизации.
9UPunavailMSUtransUser Part Unavailable MSU transmitted.
10UPunavailMSUrecvUser Part Unavailable MSU received.
11TFCreceivedКоличество принятых TFC.

q752Table15

q752Table15 — SS No. 7 MTP message accounting.

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

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

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

ПозицияНазваниеОписание
1clusterНазвание кластера, в который входят адаптеры SS7.
2spcКод пункта сигнализации.
3NIИдентификатор сети.
4messagesReceivedКоличество принятых сообщений.
5octetsReceivedКоличество принятых октетов.
6sessagesSentКоличество отправленных сообщений.
7octetsSentКоличество отправленных октетов.

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

mgTraffic

mgTraffic — MG traffic statistics.

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

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

ПозицияНазваниеОписание
1typeТип шлюза.
2mgidИдентификатор шлюза.
3directionНаправление соединения: входящее/исходящее.
4durationДлительность соединения.
5sentPktsКоличество отправленных пакетов.
6recvPktsКоличество принятых пакетов.
7lostPktsКоличество потерянных пакетов.
8lostPktsPerПроцент потерянных пакетов.
9jitterМаксимальное значение джиттера.

hostResources

hostResources — Host resources.

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

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

ПозицияНазваниеОписание
1locationИдентификатор ноды (включает название ноды и хоста).
2nodeCPUAvgСредняя загрузка CPU ноды.
3nodeCPUMaxМаксимальная загрузка CPU ноды.
4hostCPUAvgСредняя загрузка CPU хоста.
5hostCPUMaxМаксимальная загрузка CPU хоста.
6reductionsКоличество редукций.
7ETS countКоличество ets таблиц.
8nodeMemTotalОбщий объем памяти, выделенный для ноды.
9nodeMemProcsОбъем памяти, выделенный для процессов.
10nodeMemProcsUsedИспользуемый объем памяти для процессов.
11nodeMemSystemСлужебный объем памяти.
12nodeMemAtomОбъем памяти, выделенный для данных типа atom.
13nodeMemAtomUsedИспользуемый объем памяти для данных типа atom.
14nodeMemBinaryОбъем памяти, выделенный для данных типа binary.
15nodeMemCodeОбъем памяти, выделенный для кода Erlang.
16nodeMemEtsОбъем памяти, выделенный для ets таблиц.

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

SystemPrefixDomainSubsystemPrefixMetricNameVar1Var2MetricTypeOptionsОписание
ecss10.common.system | Доменcorestatistics_upload_time.histogramundefinedundefinedhistogram
Содержит гистограмму времени вставки статистик в MySQL
ecss10.common.system | Доменcorecpm_resource_allocation_attemptscpNULLcounter
Количество попыток вызовов за период времени
ecss10.common.system | Доменcorecpm_allocated_resources.histocpNULLhistogram
Пиковое количество одновременных вызовов за период времени, значащее поле — max
ecss10.common.system | Доменcorecpm_allocated_resources.histocpNULLhistogram
Минимальное количество одновременных вызовов за период времени, значащее поле — min

Модуль cc_active_queue

SystemPrefixDomainSubsystemPrefixMetricNameVar1Var2MetricTypeOptionsОписание
ecss10.ссДоменqueueincoming_seizures.counterQueueIDundefinedcounterautoresetСчетчик входящих занятий распределенных на очередь
ecss10.ссДоменqueueincoming_accepted_seizures.counterQueueIDundefinedcounterautoresetСчетчик принятых занятий распределенных на очередь (занятие поставлено в очередь или сразу распределено на агента)
ecss10.ссДоменqueueincoming_rejected_seizures.counterQueueIDundefinedcounterautoresetСчетчик занятий распределенных на очередь, но отклоненных по каким-либо причинам
ecss10.ссДоменqueuewaiting_calls.histogramQueueIDundefinedhistogramautoresetГистограмма количества вызовов ожидающих в очереди
ecss10.ссДоменqueuewaiting_time.histogramQueueIDundefinedhistogram
Гистограмма времени ожидания вызовов в очереди

Модуль core_trike_tm

SystemPrefixDomainSubsystemPrefixMetricNameVar1Var2MetricTypeOptionsОписание
ecss10.sswДоменtrunk_managerincoming_seizures.counterTrunkIDundefinedcounterautoresetСчетчик входящих занятий на транк
ecss10.sswДоменtrunk_managerincoming_accepted_seizures.counterTrunkIDundefinedcounterautoresetСчетчик принятых занятий на транке
ecss10.sswДоменtrunk_managerincoming_rejected_seizures.counterTrunkIDundefinedcounterautoresetСчетчик отклоненных по каким-либо причинам занятий на транке
ecss10.sswДоменtrunk_managerincoming_active_channels.histogramTrunkIDundefinedhistogram
Гистограмма количества входящих активных вызовов на транке
ecss10.sswДоменtrunk_manageroutgoing_active_channels.histogramTrunkIDundefinedhistogram
Гистограмма количества исходящих активных вызовов на транке

Модуль core_trike_dm

SystemPrefixDomainSubsystemPrefixMetricNameVar1Var2MetricTypeOptionsОписание
ecss10.sswДоменdirection_managerincoming_seizures.counterDirectionIDundefinedcounterautoresetСчетчик входящих занятий на направление
ecss10.sswДоменdirection_managerincoming_accepted_seizures.counterDirectionIDundefinedcounterautoresetСчетчик принятых занятий на направление
ecss10.sswДоменdirection_managerincoming_rejected_seizures.counterDirectionIDundefinedcounterautoresetСчетчик отклоненных по каким-либо причинам занятий на направлении
ecss10.sswДоменdirection_manageroutgoing_active_channels.histogramDirectionIDundefinedhistogram
Гистограмма количества исходящих активных вызовов на направлении

Модуль core_trike_cmp

SystemPrefixDomainSubsystemPrefixMetricNameVar1Var2MetricTypeOptionsОписание
ecss10.sswДоменdirection_managerincoming_seizures.counterCPM-DialogIDundefinedcounterautoresetСчетчик входящих занятий на cpm-dialog в домене
ecss10.sswДоменdirection_managerincoming_accepted_seizures.counterCPM-DialogIDundefinedcounterautoresetСчетчик принятых занятий на cpm-dialog в домене
ecss10.sswДоменdirection_managerincoming_rejected_seizures.counterCPM-DialogIDundefinedcounterautoresetСчетчик отклоненных по каким-либо причинам занятий на cpm-dialog в домене
ecss10.sswДоменdirection_manageractive_calls.histogramCPM-DialogIDundefinedhistogram
Гистограмма количества активных вызовов на cpm-dialog в домене
ecss10.sswДоменdirection_managerincoming_seizures.counterundefinedundefinedcounterautoresetОбщий счетчик входящих занятий в домене
ecss10.sswДоменdirection_managerincoming_accepted_seizures.counterundefinedundefinedcounterautoresetОбщий счетчик принятых занятий в домене
ecss10.sswДоменdirection_managerincoming_rejected_seizures.counterundefinedundefinedcounterautoresetОбщий счетчик отклоненных по каким-либо причинам занятий в домене

Модуль custom_cb_trike_task_service

SystemPrefixDomainSubsystemPrefixMetricNameVar1Var2MetricTypeOptionsОписание
ecss10.commonДоменcoreall_callbacks.countWidgetIdundefinedcounter
Счетчик запущенных и завершенных callback-ов с WidgetId в домене
ecss10.commonДоменcoresuccess_finished_callbacks.countWidgetIdundefinedcounter
Счетчик успешно завершенных callback-ов с WidgetId со статусом Cause(ISUP) в домене
ecss10.commonДоменcoreunsuccess_finished_callbacks.countWidgetIdCausecounter
Счетчик не успешно завершенных callback-ов с WidgetId со статусом Cause(ISUP) в домене
ecss10.commonДоменcoreunsuccess_finished_callbacks_by_client.countWidgetIdCausecounter
Счетчик не успешно завершенных из-за клиента callback-ов с WidgetId со статусом Cause(ISUP) в домене
ecss10.commonДоменcoreunsuccess_finished_callbacks_by_operator.countWidgetIdCausecounter
Счетчик не успешно завершенных из-за оператора callback-ов с WidgetId со статусом Cause(ISUP) в домене
ecss10.commonДоменcoreunsuccess_attempts_callback.countWidgetIdCausecointer
Счетчик не успешных попыток callback-а с WidgetId

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

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

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

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

МетрикаИмя в системеvariable_part_1variable_part_2Примечания
Количество поступивших в систему вызовов без номера вызывающего абонентаempty_a_number_calls_cNULLNULL
Количество успешных вызовов за период времени (вызовов с ответом вызываемого абонента)success_calls_cNULLNULL
Количество вызовов на занятых абонентов за период времениbusy_calls_cNULLNULL
Количество вызовов без ответа вызываемого абонента за период времениno_answer_calls_cNULLNULL
Общее кол-во неуспешных исходящих вызовов за периодunsuccess_out_calls_cNULLNULL
Отношение неуспешных вызовов ко всему количеству вызовов---Фиктивная метрика. Визуализируется только на grafana
Количество попыток внешних входящих вызовов за период времениtotal_trunk_in_calls_cNULLNULL
Общее количество неуспешных входящих вызововtotal_unsuccess_trunk_in_calls_cNULLNULL
Количество раз набора номера вне плана набораtotal_invalid_number_calls_cNULLNULL

Команды просмотра вызывных статистических данных доступны из 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

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

Переменная окруженияОписаниеЗначение по-умолчанию
GF_SECURITY_ADMIN_USERЛогин аккаунта администратора в Grafanaadmin
GF_SECURITY_ADMIN_PASSWORDПароль аккаунта администратора в Grafanaadmin
GF_SERVER_HTTP_PORTПорт, прослушиваемый Grafana внутри контейнера (менять крайне не рекомендуется)3000
GF_SERVER_PROTOCOLПротокол доступа в Grafanahttp
MYSQL_USERИмя пользователя, имеющего доступ к БД ecss_statisticsstatistics
MYSQL_PASSWORDПароль пользователя, имеющего доступ к БД ecss_statisticsstatistics
MYSQL_HOSTАдрес хоста с сервером MySQLstatistics.mysql.ecss
ZABBIX_USERПароль аккаунта администратора в Zabbix
ZABBIX_PASSWORDПароль аккаунта администратора в Zabbix
ZABBIX_HOSTАдрес хоста с сервером Zabbix
PROMETHEUS_HOSTАдрес хоста с сервером Prometheus

Например, если нужно указать иное доменное имя/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.