From 06c77c5ed2b1e5af854f791fb8b5465653deb35f Mon Sep 17 00:00:00 2001 From: Dmitry Dementev Date: Fri, 21 Aug 2026 14:15:57 -0400 Subject: [PATCH] =?UTF-8?q?docs(monitoring):=20=C2=AB=D1=81=D0=BA=D1=80?= =?UTF-8?q?=D0=B5=D0=B1=D1=91=D1=82=C2=BB=20=D0=B7=D0=B0=D0=BC=D0=B5=D0=BD?= =?UTF-8?q?=D0=B5=D0=BD=D0=BE,=20=D0=BF=D0=BE=D0=BF=D1=80=D0=B0=D0=B2?= =?UTF-8?q?=D0=BB=D0=B5=D0=BD=D1=8B=20=D0=BF=D0=B0=D0=B4=D0=B5=D0=B6=20?= =?UTF-8?q?=D0=B8=20=D1=82=D1=8F=D0=B6=D1=91=D0=BB=D1=8B=D0=B5=20=D1=84?= =?UTF-8?q?=D1=80=D0=B0=D0=B7=D1=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Зачем: - «что скребёт Prometheus» — калька со scrape, по-русски звучит коряво; рядом нашлись ошибка падежа и пара фраз, которые читаются с запинкой. - Что: - заголовок набора и раздел названы по-русски: «за чем следит» и «кого опрашивает Prometheus». - «Единицы общие — сообщений за интервал» исправлено на именительный падеж. - разбиты две перегруженные фразы: про место диагностики версий и про то, что читать на панели сходимости. - Проверка: - make config-test. --- docs/architecture/monitoring/README.md | 4 ++-- docs/architecture/monitoring/data.md | 10 +++++----- 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/architecture/monitoring/README.md b/docs/architecture/monitoring/README.md index e113b67..e0526af 100644 --- a/docs/architecture/monitoring/README.md +++ b/docs/architecture/monitoring/README.md @@ -1,4 +1,4 @@ -# Мониторинг: из чего собран и что скребёт +# Мониторинг: из чего собран и за чем следит Набор описывает зону мониторинга: какие сервисы в неё входят, что собирает Prometheus, какие источники данных подготовлены в Grafana, каким пользователем @@ -24,7 +24,7 @@ ClickHouse, два подготовленных источника данных, Плагин ClickHouse 4.20.0 входит в образ Grafana. Фоновая установка плагинов при запуске отключена. -## Что скребёт Prometheus +## Кого опрашивает Prometheus | Цель | Задание | Метка `role` | Откуда метрики | |---|---|---|---| diff --git a/docs/architecture/monitoring/data.md b/docs/architecture/monitoring/data.md index 6292aef..d57be99 100644 --- a/docs/architecture/monitoring/data.md +++ b/docs/architecture/monitoring/data.md @@ -8,7 +8,7 @@ красное и зелёное живёт в проверках и дагах DQ. Свой вопрос каждая панель называет заголовком прямо на экране. Здесь — только -источники: разговор ниже про них. +источники, о них и речь ниже. | Панель | Откуда берёт | |---|---| @@ -27,7 +27,7 @@ Читает свежесть физическую `_dist`, а не каноническое `ods.*_v`. Представление прячет за собой `FINAL` и отвечает про текущее состояние сущностей, а вопрос -здесь про доставку: местом диагностики доставленных версий физическая таблица +здесь про доставку. Местом диагностики доставленных версий физическая таблица названа там же, где заведено представление (`sql/ddl/30-ods-views.sql`). Поток и брак считаются по слою сырья. Сырьё записывает каждую доставку и ничего @@ -67,7 +67,7 @@ Произведённое живёт в Kafka, приземлившееся — в ClickHouse, и со своей стороны ни одна из них не видит другую. Поэтому панель смешанная: ряд «произведено в Kafka» приходит из Prometheus, ряд «приземлилось в ClickHouse» — из ClickHouse. -Единицы общие — сообщений за интервал панели. Со стороны Kafka это разность +Единицы общие: сообщения за интервал панели. Со стороны Kafka это разность офсетов топика, «сейчас минус интервал назад», с суммой по обеим партициям; со стороны ClickHouse — `count()` строк сырья по тому же интервалу. @@ -87,8 +87,8 @@ Kafka» приходит из Prometheus, ряд «приземлилось в C Точка в точку ряды всё равно не совпадут, и ждать этого не надо: опрос экспортёра не попадает на границы столбцов, поэтому на разгоне потока линия -Kafka идёт чуть выше. Читается устойчивый разрыв между линиями, а не разница в -один столбец. +Kafka идёт чуть выше. Читать надо устойчивый разрыв между линиями; разница в +один столбец не значит ничего. Панель смотрит на топик событий. У него приём непрерывный, и разрыв виден сразу. Слепок заказов уезжает пачкой раз в модельные сутки, и вопрос к нему