1. Сконфигурируйте параметры сервера, на который будет производиться установка сервиса удаленного логирования в файле/etc/ansible-iot/latest/inventory.

sudo nano /etc/ansible-iot/latest/inventory

Структура раздела elk в файле/etc/ansible-iot/latest/inventory:

[elk]
localhost       ansible_connection=local        ansible_sudo_pass=password

Описание основных параметров сервиса удаленного логирования в файле inventory:

ПараметрЗначение по умолчаниюТребуемое значениеОписание
<без имени>localhostlocalhost

Адрес сервера, на который будет производиться установка сервиса.

Так как предполагается локальная установка, используется значение localhost.

ansible_connection
locallocal

Способ подключения к серверу.

local — локальное подключение.

ansible_sudo_pass
passwordpassword

Пароль для получения привилегий суперпользователя



2. Сконфигурируйте параметры для установки сервиса удаленного логирования в файле/etc/ansible-iot/latest/vars/default.yml.

sudo nano /etc/ansible-iot/latest/vars/default.yml

Базовая структура разделов iot и elk в файле /ansible-iot/vars/default.yml:

# Параметры установки платформы.
iot:
  # Имя (IP-адрес) сервера, на котором будет производиться развертывание платформы IoT.
  #  ВАЖНО!!! В 'serverName' нужно прописывать то имя (IP-адрес), по которому будет доступна платформа.
  serverName: "external.iot.address"

# Параметры установки сервисов логирования (Elasticsearch + Logstash + Kibana).
elk:
  # Нужно ли добавлять в платформу appender, отправляющий логи в logstash.
  # В нем нет необходимости, если ELK не развернут или не настроен; это лишь спровоцирует сообщения об ошибках отправки
  # в логах платформы.
  enable: false
  # Имя (IP-адрес) сервера, на котором будет развернут ELK.
  # По умолчанию совпадает с 'iot.serverName', что предполагает установку рядом с платформой (на том же хосте).
  # В таком случае хосты в инвентаре в группах [iot] и [monitoring] должны совпадать.
  serverName: "{{ iot.serverName }}"
  # Директория для установки системы логирования.
  installDir: /storage/elk

Описание основных параметров удаленного логирования в файле default.yml:

Жирным шрифтом выделены параметры, значения которых необходимо задать, опираясь на столбец "Значение по умолчанию" с учетом ваших индивидуальных требований.

ПараметрЗначение по умолчаниюТребуемое значениеОписание

elk.enable

false

false

Активация отправки логов платформы в Logstash.

Данное значение требуется только в конфигурации платформы умного дома, в конфигурации сервиса удаленного логирования этот параметр не используется и может иметь любое значение.

elk.serverName

{{ iot.serverName }}

Доменное имя или IP-адрес сервера удаленного логирования

Адрес сервера удаленного логирования.
Данный адрес должен быть доступен для запросов с сервера платформы умного дома.

elk.installDir

/storage/elk

/storage/elk

Путь до директории, где будут храниться данные сервиса удаленного логирования.


3. Сконфигурируйте параметры для работы сервиса удаленного логирования в файле/etc/ansible-iot/latest/vars/service_parameters.yml.

sudo nano /etc/ansible-iot/latest/vars/service_parameters.yml

Базовая структура разделов iot и elk в файле /ansible-iot/vars/service_parameters.yml:

# Параметры сервисов ELK (для docker-compose), сгруппированные по именам.
# 'port.map' — номер порта сервиса в сети хоста.
# 'port.export' — нужно ли выполнять маппинг порта из контейнера в сеть хоста.
elk:
  elasticsearch:
    rest:
      port:
        map: 9200
    nodes:
      port:
        map: 9300
  logstash:
    port:
      map: 5001
    api:
      port:
        map: 9600
  kibana:
    port:
      map: 5601

Описание основных параметров удаленного логирования в файле service_parameters.yml:

ПараметрЗначение по умолчаниюТребуемое значениеОписание
elk.logstash.port.map50015001Порт, который прослушивает сервис удаленного логирования для получения логов от платформы умного дома.