
### Общая информация

Логи приложения пишутся локально на каждую ноду кластера. Доступ к ним осуществляется напрямую на сервере в каталоге `/var/log/zakroma`.

Все логи разделены по сервисам (zakroma-archive, zakroma-archive-gateway, zakroma-archive-notification, zakroma-archive-workflow, zakroma-archive-ui). Каждый сервис ведет собственный лог-файл.

### Путь к логам

```
/var/log/zakroma
```

### Пример содержимого каталога

```bash
[admin@worker-1 ~]$ ls -lh /var/log/zakroma
-rw-------. 1 zakroma zakroma  1.5K Aug 20 00:44 zakroma-archive.log
-rw-------. 1 zakroma zakroma 1.2M Aug 20 15:49 zakroma-archive-gateway.log
-rw-------. 1 zakroma zakroma  19M Aug 20 15:49 zakroma-archive-ui.log
```

### Описание логов

* **`zakroma-archive.log`** — логи агента, отвечающего за хранения данных. 
* **`zakroma-archive-gateway.log`** — логи компонента Gateway, через который проходят внешние запросы.
* **`zakroma-archive-ui.log`** — логи интерфейса администрирования.

### Ротация и размер логов

* Логи ротацируются средствами **logrotate**.
* Размер и глубина хранения логов может быть настроена через конфигурацию ротации (задается в `group_vars` ansible ролей).

### Доступ и права

* Владелец логов: пользователь **`zakroma`**.
* Чтение логов доступно только пользователям с правами root или пользователю `zakroma`.

### Дополнительно

* Для централизованного сбора логов рекомендуется использовать **Fluent Bit** или **Loki**, настроив форвардинг из локальных файлов.
* В случае проблем первичная диагностика выполняется через просмотр локальных логов командами:

```bash
tail -f /var/log/zakroma/zakroma-archive.log
```
```bash
tail -f /var/log/zakroma/zakroma-archive-gateway.log
```
```bash
tail -f /var/log/zakroma/zakroma-archive-ui.log
```


Где находятся логи приложения

BareMetal/VMs

Таблица соответствия версий

Изменения в архиве поставки (changelog)

1.4.0 Версия поставки

Настройка Keycloak

Настройка PostgreSQL

Настройка окружения

Установка

Диагностика и устранение неполадок