docs(wiki): document collector and grafana hardening

2026-05-28 11:05:59 +03:00
parent cc9e4a0669
commit 79eff54774
8 changed files with 453 additions and 0 deletions
@@ -0,0 +1,71 @@
+# Server Infrastructure
+
+## 2.2 Local state retention
+
+Коммит `cc9e4a0` добавил отдельный server-side maintenance path для контроля роста локального state на AW server.
+
+## `aw-prune-local-state.sh`
+
+Скрипт `aw-server/aw-prune-local-state.sh` устанавливается в:
+
+```text
+/usr/local/bin/aw-prune-local-state.sh
+```
+
+Назначение:
+
+- чистит старые backup-файлы в `{{ aw_server_data_dir }}/backups`;
+- отдельно удерживает последние DB backups и JSON backups;
+- удаляет временные архивы из `/tmp`: `activitywatch-*.zip`, `hayabusa-*.zip`, `aw-hayabusa-profiles.txt`;
+- удаляет временные WebUI/worktime artifacts старше одного дня: `aw-worktime-ui-bridge.py`, `views-default.json`, `apply_webui_ru_patch.out`.
+
+## systemd unit и timer
+
+Ansible создает:
+
+```text
+/etc/systemd/system/aw-prune-local-state.service
+/etc/systemd/system/aw-prune-local-state.timer
+```
+
+Timer:
+
+```ini
+[Timer]
+OnCalendar=*-*-* 04:40:00
+Persistent=true
+```
+
+То есть очистка запускается ежедневно в `04:40`; если хост был выключен, `Persistent=true` догонит пропущенный запуск.
+
+## Retention-параметры
+
+Параметры задаются в `ansible/group_vars/aw_server.yml`:
+
+| Переменная | Значение по умолчанию | Назначение |
+| --- | ---: | --- |
+| `aw_server_backup_retention_days` | `7` | Возраст backup-файлов, после которого они могут быть удалены. |
+| `aw_server_backup_keep_last_db` | `2` | Минимум последних DB backup'ов, которые всегда сохраняются. |
+| `aw_server_backup_keep_last_json` | `2` | Минимум последних JSON backup'ов, которые всегда сохраняются. |
+| `aw_server_journal_system_max_use` | `100M` | Лимит persistent journald storage. |
+| `aw_server_journal_runtime_max_use` | `50M` | Лимит runtime journald storage. |
+| `aw_server_journal_system_keep_free` | `500M` | Минимально свободное место, которое journald должен оставить на FS. |
+
+## journald retention
+
+`deploy_aw_server.yml` устанавливает drop-in:
+
+```text
+/etc/systemd/journald.conf.d/aw-rus-retention.conf
+```
+
+Содержимое управляется Ansible:
+
+```ini
+[Journal]
+SystemMaxUse={{ aw_server_journal_system_max_use }}
+RuntimeMaxUse={{ aw_server_journal_runtime_max_use }}
+SystemKeepFree={{ aw_server_journal_system_keep_free }}
+```
+
+После изменения drop-in playbook перезапускает `systemd-journald` и выполняет `journalctl --vacuum-size={{ aw_server_journal_system_max_use }}`. Это ограничивает рост логов без ручной очистки и снижает риск заполнения rootfs на AW server.