docs(monitoring): «скребёт» заменено, поправлены падеж и тяжёлые фразы

- Зачем:
  - «что скребёт Prometheus» — калька со scrape, по-русски звучит коряво;
    рядом нашлись ошибка падежа и пара фраз, которые читаются с запинкой.
- Что:
  - заголовок набора и раздел названы по-русски: «за чем следит» и «кого
    опрашивает Prometheus».
  - «Единицы общие — сообщений за интервал» исправлено на именительный падеж.
  - разбиты две перегруженные фразы: про место диагностики версий и про то,
    что читать на панели сходимости.
- Проверка:
  - make config-test.
This commit is contained in:
ddadmin committed 2026-08-21 14:15:57 -04:00
1 parent 28177cff92
commit 06c77c5ed2
2 files changed
+7 -7

No files matched your search

+2 -2
View File
@@ -1,4 +1,4 @@
# Мониторинг: из чего собран и что скребёт
# Мониторинг: из чего собран и за чем следит
Набор описывает зону мониторинга: какие сервисы в неё входят, что собирает
Prometheus, какие источники данных подготовлены в Grafana, каким пользователем
@@ -24,7 +24,7 @@ ClickHouse, два подготовленных источника данных,
Плагин ClickHouse 4.20.0 входит в образ Grafana. Фоновая установка плагинов
при запуске отключена.
## Что скребёт Prometheus
## Кого опрашивает Prometheus
| Цель | Задание | Метка `role` | Откуда метрики |
|---|---|---|---|
+5 -5
View File
@@ -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 идёт чуть выше. Читать надо устойчивый разрыв между линиями; разница в
один столбец не значит ничего.
Панель смотрит на топик событий. У него приём непрерывный, и разрыв виден
сразу. Слепок заказов уезжает пачкой раз в модельные сутки, и вопрос к нему