Журнал изменений

Журнал описывает изменения подсистемы по выпускам, от новых к старым.

Выпуск обозначается версией конфигурации: значение свойства «Версия» конфигурации совпадает с меткой vX.Y.Z, которой выпуск помечен в системе контроля версий. Последний выпуск — v1.0.0.

Не выпущено

Изменения приняты в ветку разработки и войдут в ближайший выпуск.

Мониторинг: состав метрик приведён к соглашениям Prometheus

Состав метрик на работающей базе сам не обновляется

Новый состав метрик применяется сам только на базе, где метрики ещё ни разу не заполнялись. На работающей базе его применяет администратор — командой «Первоначальное заполнение» на форме «Настройки метрик» (раздел «Prometheus», панель действий, команда «Настройки»).

Заголовок команды говорит о первоначальном заполнении, но команда применяет индекс метрик целиком и к уже заполненному справочнику: она же выполняет и обновление.

Прежде чем выполнить команду, прочитайте что она изменит: она перезаписывает вручную изменённые алгоритмы метрик и сбрасывает назначенное им персональное расписание.

Пока команда не выполнена, ни одно изменение метрик, внесённое выпуском, до базы не доходит. Перечисленное ниже — следствия, которые заметны в ответе на опрос:

• четыре переименованные метрики выгружаться перестают. Прежние имена гасит регламентное задание «Регламентные операции Prometheus» (пэмРегламентныеОперации) при первом выполнении после обновления конфигурации; задание предопределённое и включено по умолчанию, а при выключенном задании прежние имена продолжают выгружаться прежними алгоритмами;
• четыре пришедшие им на смену метрики в ответе не появляются;
• pde_queue_length и pde_oldest_pending_age_seconds продолжают считаться алгоритмами прежнего выпуска, то есть pde_queue_length по-прежнему выгружается с меткой label, а не queue;
• pde_formation_duration_seconds, pde_send_duration_seconds и pde_incoming_duration_seconds продолжают выгружаться датчиками Gauge с меткой aggregation. Панель или правило оповещения, перестроенные на histogram_quantile по рядам _bucket, останутся пустыми, пока команда не выполнена;
• pde_messages_per_minute выгружаться перестаёт: она внесена в перечень упразднённых метрик, и её гасит то же регламентное задание, что и прежние имена переименованных, — команда обновления для этого не нужна.

Переименованные метрики

Прежнее имя	Новое имя
pde_scrape_duration	pde_metric_calculation_duration_seconds
pde_last_refresh	pde_metric_last_refresh_timestamp_seconds
pde_error_count	pde_operations_awaiting_intervention
pde_retry_count	pde_operations_awaiting_retry

Переименование выполнено без переходного периода: прежнее и новое имя одновременно не выгружаются. Панели Grafana и правила оповещений, построенные на прежних именах, перестают получать данные, поэтому запросы в них подлежат замене.

Смысл двух метрик изменился вместе с именем. pde_operations_awaiting_intervention считает только операции, исчерпавшие число попыток, а pde_error_count считал все операции в состоянии ошибки, поэтому пороги оповещений подлежат пересмотру, а не только переименованию. Метка error_type упразднена, разбивка ведётся по потоку данных.

Метрики, сохранившие имя

Метрика	Прежний набор меток	Новый набор меток
pde_queue_length	label со значениями incomingQueue, outcomingQueue, outcomingFormingQueue	queue со значениями incoming, outgoing, distribution
pde_oldest_pending_age_seconds	queue со значениями incoming, outgoing, distribution	queue со значениями incoming, outgoing, distribution

У pde_queue_length изменились и имя метки, и набор её значений: запросы вида pde_queue_length{label="incomingQueue"} записываются как pde_queue_length{queue="incoming"}.

У pde_oldest_pending_age_seconds набор меток прежний, но изменился состав учитываемых операций: операция, которую подсистема больше не возьмёт в работу, возраст очереди больше не увеличивает. Наблюдаемые значения обеих метрик после обновления отличаются от прежних, поэтому подобранные для них пороги оповещений подлежат пересмотру.

Прочие изменения состава метрик

• pde_formation_duration_seconds, pde_send_duration_seconds и pde_incoming_duration_seconds выгружаются типом Histogram вместо Gauge. Метка aggregation упразднена, пороги отклика строятся выражением histogram_quantile.
• pde_messages_per_minute выключена: в поставке у неё снят признак активности, а измерять пропускную способность стала pde_messages_processed_total типа Counter. Метрика внесена в перечень упразднённых метрик, поэтому гаснет сама, регламентным заданием «Регламентные операции Prometheus», — команда для этого не нужна.
• pde_sync_incoming_duration_seconds упразднена: она исключена из индекса и внесена в перечень упразднённых метрик, поэтому гаснет сама, регламентным заданием «Регламентные операции Prometheus», — команда для этого не нужна. Время обработки входящих сообщений измеряет pde_incoming_duration_seconds.
• Добавлена pde_metric_calculation_errors — число метрик, расчёт которых при формировании ответа завершился ошибкой.

Что изменит команда «Первоначальное заполнение»

Команда перезаписывает настройки предопределённых метрик

• Текст алгоритма предопределённой метрики заменяется текстом из макета. Правка алгоритма, выполненная администратором, теряется без предупреждения.
• Персональное расписание метрики сбрасывается, а прежнее регламентное задание при этом не удаляется. Метрика возвращается в общий цикл расчёта и одновременно продолжает рассчитываться осиротевшим персональным заданием, то есть считается дважды. Задание перестаёт быть видно из формы метрики и удаляется только из списка регламентных заданий.

Ручные правки алгоритмов и перечень метрик с персональным расписанием следует выписать до выполнения команды, а осиротевшие задания — удалить сразу после неё.

Метрики, заведённые администратором вручную как обычные, непредопределённые элементы справочника пэмМетрики, командой не затрагиваются: она проходит по индексу предопределённых метрик.

Порядок обновления и таблицы соответствия имён — в разделе Обновление подсистемы на работающей базе.

v1.0.0 — 23 февраля 2026

Журнал изменений начат после этого выпуска. Изменения выпуска v1.0.0 и предшествующих ему в журнале не описаны.