Log Storage (logstore)

Содержание

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

Описание

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

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

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

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

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

Ограничения

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

Параметры

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

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

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

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

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

Пример узла

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

  "group": 11110,
  "order": 1,

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

См. также

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