Налаштування Observer-ів в Tariscope
Служба Tariscope Observer (або просто Observer) призначена для автоматичного отримання інформації про виконані виклики (CDR, SMDR, AMA та інші) від АТС або з файлів, що знаходяться в якійсь теці, первинної обробки цих даних, а також для виконання сценаріїв по окремим подіям.
Тобто Observer є ланкою, яка поєднує телефонну систему з системою Tariscope. Один Observer призначений для взаємодії з однією телефонною системою (АТС). Tariscope не має обмежень на кількість Observer-ів, з яких він може отримувати інформацію. Observer може бути налаштований на отримання CDR інформації з різних типів джерел даних, які описуються нижче. Вибір типу джерела даних в першу чергу залежить від типу телефонної системи, з якої отримуються CDR дані.
Observer можуть знаходитися як на тому ж сервері, де знаходиться система Tariscope, так і на віддаленому комп’ютері (сервері), який має зв’язок з сервером Tariscope через IP мережу. Будь-який, локальний чи віддалений Observer повинен мати IP зв’язок з сервером Tariscope (служба TS.MAIN) та Microsoft SQL Server-ом (надалі “SQL сервер”), на якому встановлена база даних Tariscope. При запуску Observer-а він зв’язується з сервером Tariscope, отримує від нього рядок підключення до бази даних, після чого підключається до бази даних Tariscope. Якщо у вас використовуються міжмережевий екран або інші системи безпеки, ви повинні налаштувати їх так, що забезпечити IP доступ Observer-у до серверу Tariscope (IP порт: 8001) та SQL серверу (IP порт: 1433, 1434).
У якості подій, на які може реагувати Observer виконанням конкретного сценарію можуть бути:
- Підключення джерела даних.
- Відключення джерела даних.
- Зміна класу абонента. Ця подія актуальна, якщо ліцензія Tariscope включає функцію обмеження для абонентів.
- Зміна класу груп. Ця подія актуальна, якщо ліцензія Tariscope включає функцію обмеження для груп або груп і абонентів.
- Періодична подія.
- Новий виклик опрацьовано. Сценарій по цій події дозволяє виконати якусь додаткову обробку даних по інформації про отриманий виклик. Наприклад, можна перевіряти, чи не належить набраний номер до якоїсь конкретної групи телефонних номерів.
- Помилка підключення бази даних. Ця подія може бути актуальна, якщо Observer і Microsoft SQL Server знаходяться на різних серверах. При втрачанні зв’язку з базою даних можна надсилати повідомлення адміністратору.
Незалежно від того ви налаштовуєте локальні Observer-и чи віддалені, треба виконати налаштування в додатку Tariscope. Ці налаштування однакові для обох типів Observer-ів. В подальшому буде розглянуте особливості доналаштування віддалених Observer-ів.
В меню Tariscope виберіть: Збір даних/Observer → Керування збором даних. З’явиться сторінка, приклад якої наведений на малюнку 1.
Малюнок 1
Додаємо новий Observer. Клацніть по іконці Додати на панелі інструментів. З’явиться меню, в якому виберіть Новий Observer. З’явиться вікно, яке наведено на малюнку 2.
Малюнок 2
В позиції Назва введіть назву профайлу Observer-а. Рекомендуємо називати профайл ім’ям телефонної системи, з якої цей Observer буде приймати дані. Наприклад, треба отримувати дані з CUCM (Cisco). В цьому разі краще і назвати профайл: CUCM. Назва не повинна містити будь-яких символів, окрім літер і цифр. Клацніть Зберегти. В підтвердження створення профайлу відобразиться вікно (Малюнок 3).
Малюнок 3
Клацніть Налаштування. З’явиться вікно Налаштування Tariscope Observer (назва профайлу), приклад якого показаний на малюнку 4.
Малюнок 4
Клацніть по посиланню ‘тут’ і виберіть існуючу в системі телефонну систему. Для нашого прикладу це повинно бути саме CUCM.
В переліку Джерело даних виберіть відповідне джерело. Для нашого прикладу якщо CUCM налаштований як FTP клієнт, то в якості джерела даних повинен бути FTP сервер. Для інших типів телефонних систем у якості джерела даних можуть бути: FTP клієнт, TCP клієнт або сервер, локальна або віддалена папка та інші, в залежності від того, яким чином телефонна система віддає CDR дані. Для налаштування параметрів джерела даних клацніть по кнопці, яка знаходиться праворуч від переліку Джерело даних і виконайте налаштування. Опис налаштування конкретного джерела даних дивіться в документації.
Позиція Місце зберігання оброблених CDR призначена для вибору теки для зберігання первинних CDR даних, які отримуються з телефонної системи. Ці дані можуть бути використані при необхідності повної переобробки даних про виклики. За замовчуванням вони зберігаються в теці C:\ProgramData\Tariscope. Журнали CDR мають розширення CDR, а назва файлу включає назву профіля Observer-а та дату.
В переліку Період створення виберіть період для створення журналів з первинними CDR даними. Період створення залежить від активності виконання викликів. Чим вона вище, тим краще вибирати менший період. За замовчування пропонується в якості періоду один місяць.
В переліку Ведення журналу виберіть рівень деталізації журналу роботи профілю Observer-а. Найменш детальний рівень – це Статус, найбільш детальний рівень – Налагодження.
На цьому налагодження локального Observer-а закінчується. Якщо ви виконуєте налагодження віддаленого Observer-а, то увімкніть перемикач Віддалений збір даних.
Клацніть по кнопці Зберегти. Сторінка Збір даних прийме вигляд подібний до того, що показаний на малюнку 5.
Малюнок 5
Якщо ви створили локальний Observer, то його можна запустити, для чого клацніть по іконці Управління і виберіть пункт Запустити.
В тому випадку, коли ви налаштовували профайл для віддаленого Observer-а, виконайте наступні дії.
Робота на віддаленому сервері
Перед виконанням налаштувань на віддаленому сервері ви повинні:
- Виконати налаштування, які вказані вище на сервері Tariscope;
- Якщо на сервері Tariscope працює файревол, додайте правила, які забезпечать доступ до IP портів: 8001 (на ньому працює сервер Tariscope), 1433, 1434 (порти SQL серверу).
- Перевірте, що сервер, де встановлений Tariscope, доступний по мережі з віддаленого серверу, де встановлюється віддалений Observer.
На віддаленому сервері (комп’ютері) виконайте інсталяцію Tariscope.
При виконанні інсталяції на етапі Компоненти Tariscope (малюнок 1.1.5 в статті за наведеному вище посиланню) виберіть Observer сервер. За замовчування інсталяція виконується в теку: C:\Program Files (x86)\SoftPI\Tariscope
Для запуску віддаленого Observer-а ви повинні знати:
- IP адресу сервера, де встановлений сервер Tariscope. Наприклад, IP адреса сервера Tariscope: 10.10.0.148
- а також назву профайлу, який там був створений саме для цього Observer-а. В нашому прикладі це: CUCM
Відкрийте Командний рядок з правами адміністратора Windows. Виконайте там наступні команди:
1. Перехід то теки з програмним забезпеченням. Якщо ви встановлювали в теку за замовчуванням, то це буде команда:
cd C:\Program files (x86)\SoftPI\Tariscope\Microservices
2. Далі запустіть віддалений Observer, в якості параметрів його вкажіть назву профайлу (параметр name) та URL серверу Tariscope (параметр main). Приклад такої програми наведений нижче:
.\Tariscope.Observer.exe /name=CUCM /main=”http://10.10.0.148:8001”
В цьому прикладі назва профайлу CUCM, а URL серверу Tariscope: http://10.10.0.148:8001 , де 10.10.0.148 – це IP адреса серверу, а 8001 – IP порт, на якому працює сервер.
Приклад такого вводу даних показаний на малюнку 6.
Малюнок 6
Якщо всі налаштування виконані правильно і мережа забезпечує доступ від віддаленого Observer-а до серверу Tariscope, то буде виконане підключення Observer-у до Tariscope та SQL Server-у.
Перевірити результат підключення Observer-у можна у його журналі. Журнали роботи Observer-ів, як локальних так і віддалених, ведуться в теці C:\ProgramData\Tariscope\Logs\Observer відповідно на сервері Tariscope або на віддаленому сервері. Журнал має назву [Назва профайлу].log. Для нашого прикладу це буде файл: CUCM.log
Цей журнал створюється тільки після успішного підключення віддаленого Observer-а до серверу Tariscope. Якщо журнал відсутній, це означає, що підключення не відбулося.
Приклад журналу показаний на малюнку 7.
Малюнок 7
Впевнитися в підключенні віддаленого Observer-у до Tariscope можна також в Tariscope на сторінці Observer-ів (малюнок 8). Як видно на малюнку, в стовпці Стан сервісу відображається значення В мережі.
Малюнок 8
Ви повинні залишити відкритим вікно Командний рядок з працюючим віддаленим Observer-ом. Закриття Командного рядку призведе до завершення роботи Observer-а. І для повторного запуску треба буде знову завантажити Командний рядок і повторити вказані вище команди.
Для створення інших віддалених Observer-ів треба повторити всі вказані вище дії: створити в Tariscope профайл, запустити віддалений Observer з відповідною назвою профайлу.
Ви можете запустити віддалені Tariscope Observer-и в якості Windows служб. Для цього можна скористатися, наприклад, сторонньою програмою nssm.
Для створення служби для віддаленого Observer запустіть програму nssm наступною командою:
nssm install TS.Observer,
де TS.Observer – назва служби, яка створюється. Якщо ви створюєте декілька служб, то вони повинні мати різні назви.
Як наслідок виконання команди з’явиться вікно, наведене на малюнку 9.
Малюнок 9
В позиції Path введіть шлях до файлу Observer-а:
C:\Program files (x86)\SoftPI\Tariscope\Microservices\Tariscope.Observer.exe
В позиції Arguments введіть параметри Observer: назву профайлу і URL серверу Tariscope. Для нашого прикладу це буде:
/name=CUCM /main=http://10.10.0.148:8001
Клацніть Install service. Буде створена відповідна служба Windows, яку треба запустити з Windows вікна Служби (малюнок 10).
Малюнок 10
