Log Storage (logstore)

Содержание

Описание
Ограничения
Параметры
Пример конфигурации
См. также

Описание

Обеспечивает длительное хранение лог-файлов со всех серверов и нод. Существует внутри каждого сайта независимо от других.

Является поставщиком данных для API доступа к лог-файлам. Использует дисковое хранилище, предельный размер сохраняемых данных настраивается в опциях, после чего данные автоматически подчищаются.

Резервируется в режиме Active-Passive. Не масштабируется.

Table 1. Системные характеристики

Код	`logstore`
Режим работы	`Сервис`
Режим резервирования	`Active-Passive`
Типы сайтов	`Любые`
Слой	`Служебный`
Размещение	`Внутренний`
Сохранение и восстановление состояния при перезагрузке	`Да`
Приложение	`rostell_logstore`
Собственное хранилище	`Файловая система`

Ограничения

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

Параметры

Описание столбцов в таблице

Table 2. Параметры
Имя	Тип	Умолчание	Описание
`name`	`str`	required	Имя. Может состоять из латинских букв и цифр, должно начинаться с буквы.
`roletype`	`str`	required	Тип функциональной роли. Возможные значения: `"logstore"`.
`iface`	`str`	required	Алиас сетевого интерфейса сервера, на котором будет происходить внутреннее взаимодействие функциональных ролей между собой.
`group`	`int`	required	Номер группы. Горизонтальное масштабирование внутри сайта не поддерживается. Все экземпляры функциональной роли на сайте должны иметь одинаковое значение. Целое число от `1` до `9999999`.
`order`	`int`	required	Порядок экземпляра функциональной роли в рамках группы. Определяет в каком порядке будет происходить перетекание в режиме Active-Passive.
`storepath`	`str`	empty	Алиас каталога на сервере для размещения и хранения лог-файлов. По умолчанию: `"/var/lib/rostell/_workdir/<NODE_NAME>/log/logstore"`. Ожидается, что в качестве каталога будет подключено сетевое хранилище, доступное всем экземплярам функциональной роли.
`storedays`	`int`	`2`	Количество дней для хранения лог-файлов. При достижении устаревшие данные автоматически удаляются.
`storesize`	`int`	`100`	Максимальный размер хранимых лог-файлов, в ГБ. При достижении наиболее старые данные автоматически удаляются.

Пример конфигурации

Управление конфигурацией производится в приложении, доступном для администраторов мастер-домена. Приложение скрывает полное содержание конфигурации, однако тем не менее оно доступно через API.

Конфигурация содержит раздел для описания всех экземпляров всех функциональных ролей. Параметры определяются для каждого конкретного экземпляра функциональной роли.

Пример узла

{
  "name": "logstore1",
  "roletype": "logstore",
  "iface": "eth0",

  "group": 201,
  "order": 1,

  "storepath": "alias://paths/c"
}

См. также

Конфигурация