Log Storage (logstore)

Содержание

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

Описание

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

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

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

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

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

Ограничения

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

Параметры

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

Table 2. Параметры
Имя	Тип	Умолчание	Описание
`name`	`str`	required	Имя. Может состоять из латинских букв и цифр, должно начинаться с буквы.
`roletype`	`str`	required	Тип роли. Возможные значения: `"logstore"`.
`ext`	`json`	empty	Дополнительные опции роли. Содержит json объект или список.
`enabled`	`bool`	empty	Флаг активности роли. При установке в false роль не участвует в валидации и не запускается.
`limit_of_cores`	`int`	empty	Ограничитель количества используемых логических ядер процессора. По умолчанию: 0 - не ограничено.
`logging_default_level`	`int`	empty	Уровень логирования по умолчанию, заданный адресно для экземпляра роли (типа микросервиса). Подробнее
`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`	Максимальный размер хранимых лог-файлов, в ГБ. При достижении наиболее старые данные автоматически удаляются.
`takeover`	`bool`	global	Выключатель режима takeover. `Failover` - активация менее приоритетного экземпляра сервиса при обнаружении недоступности более приоритетного экземпляра сервиса (лидера группы active-passive). `Takeover` - активация более приоритетного экземпляра сервиса (лидера группы active-passive) во время его восстановления, сопровождающееся остановкой сервиса на менее приоритетном экземпляре сервиса. Если режим включен - takeover осуществляется автоматически. Если режим выключен - takeover не осуществляется, восстановленный лидер группы временно становится фолловером и ожидает выгрузки сервиса на менее приоритетном экземпляре. Если опция не задана, то применяется ее значение из параметров текущего сайта. Если не задано в сайте, то применяется значение из раздела general. Если нигде не задано - takeover включен для более точного распределения нагрузки по заданным в конфигурации приоритетам.

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

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

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

Пример узла

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

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

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

См. также

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