Files
openspec-lab/openspec/changes/archive/2026-09-08-vinograd-rostelecom-channel-monitoring/proposal.md
T

48 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Proposal: vinograd-rostelecom-channel-monitoring
## Why
Внешний канал связи «Винный город» (провайдер Ростелеком, договор Бастион)
периодически пропадает: 2026-09-08 08:07 (MSK) UptimeKuma зафиксировал
**100% потерю пакетов на шлюзе 83.239.50.145** (PING, 10/10 lost). Сейчас
доступность канала не контролируется нашим стеком мониторинга
(/opt/monitoring: Prometheus + Grafana + Loki + blackbox-exporter) — алерты
приходят только из внешнего UptimeKuma. Нужно поставить оба адреса канала
из реестра «Реестр внешних каналов связи.ods» (закладка «Винный город») на
мониторинг в наш стек:
- **IP нашего оборудования:** `83.239.50.146` (Static IP, маска 255.255.255.252 /30)
- **Шлюз:** `83.239.50.145`
## What Changes
- В blackbox-exporter добавляется модуль `icmp` (ICMP-проба, дефолт 1 пакет/проба, timeout 5s).
- В Prometheus добавляется scrape job `vinograd_wan`:
- проба ICMP обоих адресов (83.239.50.145 шлюз, 83.239.50.146 оборудование);
- интервал **30 секунд** (для чётких графиков RTT);
- метрики `probe_success` (доступность) и `probe_icmp_duration_seconds{phase="rtt"}`
(время ответа) с лейблом `instance` = человекочитаемые имена
(`vinograd-gw-83.239.50.145`, `vinograd-cpe-83.239.50.146`).
- Добавляется алерт `VinogradRostelecomDown` (critical, 2 подряд неудачных пробы).
- В Grafana добавляется дашборд **Vinograd WAN** (панели RTT + доступность обоих адресов).
- Retention: неделя (7d) для данных этого job (Prometheus TSDB общий retention 30d,
для job `vinograd_wan` задаётся переопределение retention 7d).
## Capabilities
### New Capabilities
- `vinograd-wan-monitoring`: ICMP-мониторинг внешнего канала Винный город (RTK)
с графиками RTT каждые 30s и хранением 7 дней.
### Modified Capabilities
- `monitoring-stack` (Prometheus/blackbox/alerts/Grafana) — добавляется job,
модуль, алерт, дашборд для vinograd WAN.
## Impact
- `/opt/monitoring/blackbox.yml` — модуль `icmp`
- `/opt/monitoring/prometheus.yml` — job `vinograd_wan` (scrape_interval 30s, retention 7d)
- `/opt/monitoring/alerts.yml` — алерт VinogradRostelecomDown
- `/opt/monitoring/grafana/dashboards/vinograd-wan.json` — новый дашборд
- `/opt/monitoring/README.md` — документация (адреса, метрики, алерт)
- `/opt/monitoring/EXPERIENCE.md` — заметка об опыте