Установка

Системные требования

  • Дистрибутив: Debian 9, 10

Минимальные

  • CPU: x86_64, 4 ядра, SSE 4.2
  • RAM: 4 ГБ
  • HDD: 2 ГБ

Рекомендуемые

  • CPU: x86_64, 4 ядра, SSE 4.2
  • RAM: 16+ ГБ
  • HDD: 1+ ТБ

Процедура установки

Collector распространяется в виде образов Docker, хранящихся на нашем сервере. Чтобы получить к ним доступ, свяжитесь с нами

Необходим доступ от целевой машины к репозитариям дистрибутива.

Команды выполнять от root.

1. Установить вспомогательное ПО

Выполнить от root:

apt-get --yes install tar wget

2. Установить Docker и Docker-Compose

Следуя официальной документации по установке для вашей ОС:

3. Скачать и распаковать необходимые файлы

mkdir collector && cd collector
wget https://docs.mitigator.ru/master/dist/collector/clickhouse.xml
wget https://docs.mitigator.ru/master/dist/collector/docker-compose.yml
wget https://docs.mitigator.ru/master/dist/collector/docker-compose.gateway.yml
wget https://docs.mitigator.ru/master/dist/collector/init-db.sh
wget https://docs.mitigator.ru/master/dist/collector/dashboard.json
wget https://docs.mitigator.ru/master/dist/collector/dashboard.yml
wget https://docs.mitigator.ru/master/dist/collector/datasources.yml
wget https://docs.mitigator.ru/master/dist/collector/ipv4_dictionary.xml
wget https://docs.mitigator.ru/master/dist/collector/location_dictionary.xml

4. Скачать базы GeoIP (необязательно)

Collector поставляется с несколькими настроенными панелями Grafana. Некоторые из них используют GeoIP. Для их работы нужно скачать бесплатную базу данных GeoLite2 в формате CSV и распаковать файлы в каталог geolite2:

collector/
    docker-compose.yml
    geolite2/
        GeoLite2-City-Blocks-IPv4.csv
        (прочие файлы GeoLite2)

Распакованные файлы нужно обработать командой:

find collector/geolite2 -name '*.csv' -exec sed -e "s|,\('[^,]\+\)|,\"\1\"|g" -i {} \;

5. Удостовериться, что задан адрес коллектора

В файле .env удостовериться, что задана корректная переменная COLLECTOR_HOST_ADDRESS. Исправить ее при необходимости.

6. Авторизоваться на docker.mitigator.ru

docker login docker.mitigator.ru

7. Запустить Collector

cd collector
docker-compose up -d