Установка Витрины данных конфигурации установки Лайт

Перед установкой витрины данных конфигурации установки Лайт необходимо произвести подготовительные работы согласно статье Подготовка к установке витрины данных конфигурации Лайт.

Пожалуйста, посмотрите короткое видео или ознакомьтесь с текстом ниже.

Настройка конфигурационного файла

Чтобы запустить процесс установки витрины с помощью Ansible, необходимо настроить конфигурационный файл. Для этого выполните следующие действия:

1. Переименовать файл custom.example.yml расположенный в папке ansible/group_vars/ в custom.yml. Для этого выполните команду:

cp -n ansible/group_vars/custom.example.yml ansible/group_vars/custom.yml

2. В файле custom.yml указать корректные значения для следующих переменных:

• server_ip - адреса сервера. Укажите IP-адрес сервера, на который будет установлена витрина. Например:

server_ip: "172.16.10.59"

• server_user_name - имя пользователя операционной системы. Укажите имя пользователя операционной системы сервера, под которым будет производиться установка витрины, например:

server_user_name: datamart

• podd_kafka_topic_prefix - префикс перед именем топиков для ПОДД-агента. Укажите мнемонику витрины. Например:

podd_kafka_topic_prefix: "user_prefix."

Следует обязательно ставить символ . (точка) после определения параметра префикса!

Установка витрины

Для установки витрины выполните команду:

docker-ansible-cmd ansible-playbook -i hosts install.yml

Начнется процесс установки витрины.

Установка витрины завершена. При успешной установке параметр failed должен иметь значение - 0.

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

После установки витрины следует провести ее проверку.

Проверка витрины

Для проверки установки витрины следует выполнить следующие действия:

1. Открыть в браузере web-интерфейс Portainer для управления docker-контейнерами по адресу:

IP:9000

• IP - адрес сервера,
• 9000 - порт сервера.

2. Ввести логин и пароль администратора Portainer. По умолчанию - admin/ password.

3. Нажать значок Get Started, чтобы определить и автоматически настроить локальную среду.

4. Нажать на главной странице ссылку local.

5. Нажать значок Containers.

6. Просмотреть в разделе Container list наличие следующих docker-контейнеров:

Состав докер-контейнеров в Portainer на примере витрины данных конфигурации установки Лайт (версии 1.6.0):

Наименование компонента	Версия	Функциональное назначение
csv-uploader	1.0.23	Интерфейс создания структуры витрины и загрузки данных
elasticsearch	7.10.2	Сервис полнотекстового поиска, аналитики и хранения логов
filebeat	7.10.2	Легковесный клиент для сбора и передачи логов в Greylog
grafana	8.4.4	Аналитика и интерактивная визуализация мониторинга
graylog	4.2.7	Сбор и передача журналов событий (логов) для Elasticsearch
kafka	2.13-2.6.0-alt-p10-r3	Распределённая система обмена сообщениями (брокер)
kafka-postgres-reader	0.3.0	Коннектор для чтения между Kafka и СУБД PostgreSQL
kafka-postgres-writer	0.3.0	Коннектор для записи между Kafka и СУБД PostgreSQL
mongo	4.4	Сервисная, документо-ориентированная CУБД для Greylog
node_exporter	v1.3.1	Сервис экспорта системных метрик (процессор, память, и т.д.)
podd-adapter-mppr	5.0.13	Адаптер ПОДД для связи ядра витрины с Агентом ПОДД
podd-adapter-mppw	5.0.5	Адаптер ПОДД для связи ядра витрины с Агентом ПОДД
podd-adapter-query	5.1.9	Адаптер ПОДД для связи ядра витрины с Агентом ПОДД
portainer	2.14.0	Система управления контейнеризованными сервисами
postgres	13.4	Объектно-реляционная СУБД для хранения данных витрины
prometheus	v2.34.0	База данных временных рядов для мониторинга среды
query-execution	5.7.0	Сервис исполнения запросов ProStore
status-monitor	5.7.0	Отслеживание состояния топиков брокера сообщений Kafka
zookeeper	3.5.7-alt-p10-r3	Централизованная служба управления конфигурацией

7. Подключиться к программе по ssh и выполнить запрос:

curl -X POST -H "Content-Type: application/json" -d '{"requestId": "797de19a-54e2-4c9c-af6e-a9ee312230b5","datamartMnemonic": "base01","sql": "CHECK_VERSIONS()"}' http://0.0.0.0:9090/query/execute

Пример успешного ответа:

8. Подключиться к Grafana.

Для этого следует перейти по адресу: http://{host}:3000 и выполнить авторизацию: логин: admin, пароль: admin (указаны значения по умолчанию).

Проверить, что показатели Healthcheck Leaviness и Readiness (дашборд Lite) работают (индикатор зеленого цвета).

9. Просмотреть лог-файл установки (ansible/ansible.log). Лог-файл не должен содержать записей с ошибками установки. 

Запуск и остановка витрины

Витрина не имеет графического интерфейса. При необходимости любой из сервисов/модулей можно остановить и запустить заново.

Для ручной остановки и запуска необходимо подключиться по ssh на сервер и с правами sudo использовать штатный функционал systemctl.

Например:

sudo systemctl stop query-execution sudo systemctl start query-execution sudo systemctl stop status-monitor sudo systemctl start status-monitor