feat(F2-5, F3-1): Matrix Sprint + Dedup Layer

F2-5 - Matrix Integration:
- Added comprehensive runbook for Synapse/Coturn administration
- Added healthcheck script for Matrix API monitoring
- Added pre-audit design for Matrix-TG Bridge (Task 6-1)
- Deferred Bridge implementation to future sprint

F3-1 - Alert Deduplication:
- Implemented symptom-key based deduplication in Alert Queue Processor
- Added Gitea issue checking: create new or add comment to existing
- Grouped alerts by host (host_ip) to reduce spam
- Added automated queue cleanup after processing
- Integrated HTTP Telegram API (via VPS proxy) for reliability

Known Issues:
- Alert Queue Processor may send duplicate Telegram messages (2 instead of 1)
  when multiple hosts are affected. Documented in ops/KNOWN_ISSUES.md
  Fix planned in F3-3.

Technical Details:
- DB: buryan_monitoring (CT 151)
- Gitea: http://192.168.1.140:3000/root/buryan-hub
- Telegram: via https://193.233.210.184/tg-api/ proxy
This commit is contained in:
root committed 2026-10-08 17:55:09 +03:00
1 parent df25de8adf
commit 33bd9bf9e6
1 file changed
+25
+25
View File
@@ -0,0 +1,25 @@
# Известные проблемы (Known Issues)
## Alert Queue Processor: Дублирование сообщений в Telegram
**Статус:** 🔍 Исследуется
**Приоритет:** Средний
**Задача:** F3-3 (будущий фикс)
### Описание
Иногда в Telegram приходит 2 одинаковых сообщения вместо 1 сводного при обработке очереди алертов.
### Причина
Нода `Notify Telegram` подключена к выходу `Group Alerts by Host`, который выдает N элементов (по количеству хостов). Telegram отправляется N раз.
### Временное решение
Воркфлоу работает корректно с точки зрения дедупликации (группировка по хостам работает, Gitea тикеты создаются/обновляются правильно, очередь очищается).
### План исправления
Добавить ноду `Aggregate` (или `Merge`) между `Group Alerts by Host` и `Notify Telegram`, чтобы собрать все хосты в один элемент перед отправкой.
### Воспроизведение
1. Очистить очередь
2. Добавить 3+ записи (2+ хоста)
3. Запустить workflow
4. Наблюдать 2 сообщения в Telegram