From 33bd9bf9e612a8134fbe8d4a4f84eaffa2a41c47 Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Thu, 8 Oct 2026 17:55:09 +0300 Subject: [PATCH] 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 --- ops/KNOWN_ISSUES.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 ops/KNOWN_ISSUES.md diff --git a/ops/KNOWN_ISSUES.md b/ops/KNOWN_ISSUES.md new file mode 100644 index 0000000..b7ad90f --- /dev/null +++ b/ops/KNOWN_ISSUES.md @@ -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