Collector

В контейнере *collector* находят службы. ответственные за сбор статистики трафика абонентов, а так же DHCP-сервер.
Для настройки коллектора в меню базовой системы откройте "Систему сбора статистики"

!base_collector.png|border=0,width=900!


{toc:maxLevel=2}

h1. Управление модулем
{code:title=Пример команды}/app/collector/service start{code}
{code:title=Что еще возможно помимо start}
backup Создать резервную копию контейнера
backup_download Скачать резервную копию с FTP-сервера. Принимает имя резервной копии
backup_local_list Показать список резервных копий на локальном сервере
backup_ftp_list Показать список резервных копий на FTP-сервере
backup_restore Восстановить все файлы из резервной копии. Принимает имя резевной копии
backup_upload Загрузить последнюю резервную копию на FTP-сервер

destroy Полностью остановить контейнер
build Выполнить сборку контейнера

check Запустить полную проверку. Выполняется angel + monitoring
angel Выполнить все angel-тесты
monitoring Выполнить все monitoring-тесты

restart Остановить и перезапустить контейнер
start Запустить контейнер
status Показать статус контейнер
stop Остановить контейнер
{code}
*Файл настроек*
{code}/app/collector/cfg/config{code}

h1. Создание конфигурационных файлов

Конфигурация генерируется динамический вызовом скрипта genconfig
{code}chroot /app/collector/ /genconfig{code}

h1. Настройка взаимодействия *asr_billing* и *collector*

Необходимо, чтобы пароли контекста collector в API биллинга соответствовали в конфигурационных файлах *asr_billing* и *collector*
{code}grep collector.psw /app/asr_billing/cfg/config
network['api.collector.psw']='testpassword'{code}
{code}grep collector.psw /app/collector/cfg/config
network['api.collector.psw']='testpassword'{code}

h1. Netflow Collector

Отвечает за сбор статистики трафика.
Опция в конфигурационном файле:
{code}app['nf_collector.enabled']='1'{code}

* {code:title=init файл}/app/collector/etc/init.d/nf_collector{code}
* {code:title=Служба находится в chroot контейнере, поэтому управлять ей так}
chroot /app/collector /etc/init.d/nf_collector status
chroot /app/collector /etc/init.d/nf_collector stop
chroot /app/collector /etc/init.d/nf_collector start
chroot /app/collector /etc/init.d/nf_collector restart
{code}
* {code:title=Конфигурационный файл}/app/collector/etc/netflow_collector/nf_collector.conf{code}
* {code:title=Соотнесение подсетей с типом трафика (внешний, льготный и т.д.)}/app/collector/etc/netflow_collector/network.csv{code}
Настраивается по статье "[Тарифы. Редактор правил и сетей|http://docs.carbonsoft.ru/pages/viewpage.action?pageId=48693347#%D0%A2%D0%B0%D1%80%D0%B8%D1%84%D1%8B-%D0%A0%D0%B5%D0%B4%D0%B0%D0%BA%D1%82%D0%BE%D1%80%D0%BF%D1%80%D0%B0%D0%B2%D0%B8%D0%BB%D0%B8%D1%81%D0%B5%D1%82%D0%B5%D0%B9]" \\ \\
* {code:title=Лог}/app/collector/var/log/nf_collector.log{code} \\

Отладка получения netflow описана в статье "[Настройка и проверка netflow-потоков|CarbonBilling:Настройка и проверка netflow-потоков]"

h3. IP коллектора по-умолчанию

169.254.38.13

h1. Traf reporter

Отвечает за передачу данных о потреблении трафика в биллинг.
Рекомендуется не изменять ни каких настроек демона, отладку работы можно провести по логу.

* *init файл*
{code}/app/collector/etc/init.d/traf-reporter{code}
* *Лог*
{code}/app/collector/var/log/reporter.log{code}

По-умолчанию данные собираются в папку */app/collector/var/dump*

h1. DHCP

Настройка описана в статье "[CarbonBilling:DHCP]"
Интеграция с коммутаторами для option 82 описана в разделе "[Взаимодействие с коммутаторами]"

Хранилище детализации трафика абонентов (Детальная статистика).
Модуль имеет ограниченное сопровождение: новые функции не появляются, поведение существующих не изменяется и не дорабатывается. В качестве замены рекомендуется использовать *NfSen*.
Работа с детальной статистикой описана в статье "[СОРМ. Доступ для сотрудников правоохранительных органов.]"
Отображение в личном кабинете описано в статье "[CarbonBilling:Детальная статистика в личном кабинете]"

Для сортировки статистики используется файл *users.csv*. Он формируется демоном *sync_billing.py*, выполняя синхронизацию с биллингом каждые 30 секунд.

* *init файлы*
{code}/app/collector/etc/init.d/bstatd{code}
* *Конфигурационный файл*
{code}/app/collector/cfg/bstatd.conf{code}
* *Сопоставление IP-адресов абонентов с ID учетных записей*
{code}/app/collector/mnt/var/lib/collector/users.csv{code}
* *Лог*
{code}/app/collector/var/log/bstatd.log{code}

h1. NfSen

Новый интерфейс детальной статистики. Настраивается по статье "[nfsen]"

* *init файл*
{code}/app/collector/etc/init.d/nfsen{code}
* *Конфигурационный файл*
{code}/app/collector/etc/nfsen/nfsen.conf{code}
* *Лог*
{code}/app/collector/var/log/messages{code}

Отладку работы демона можно произвести используя утилиту *grep*:
{code}tail -f /app/collector/var/log/messages | grep -i nfsen{code}

h1. sync_billing.py

Скрипт синхронизации *sync_billing.py* получает данные из биллинга для правильной работы collector: nf_collector, bstatd, dhcpd
Синхронизация проходит каждые 30 секунд.
Демон не имеет настроек.

* *init файл*
{code}/app/collector/etc/init.d/sync_billing{code}
* *исполняемый файл*
{code}/app/collector/usr/local/sbin/sync_billing.py{code}
* *Лог*
{code}/app/collector/var/log/sync_billing.log{code}

Синхронизируемые данные:

* *Сопоставление IP-адресов абонентов с ID учетных записей для bstatd*
{code}/app/collector/var/lib/collector/users.csv{code}
* *Список* *[подсетей для тарификации|Правила и сети]*
{code}/app/collector/etc/netflow_collector/network.csv{code}
* *IP-пулы DHCP-сервера*
Пулы для синхронизации настраиваются по статье "[CarbonBilling:Пулы IP адресов]"