label size extension

2026-07-07T13:37:15Z

**Было:** Prometheus decoder ограничивает длину значений меток метрик максимум 256 символами. Попытка передать метрику с более длинным значением метки приводит к исключению `TPrometheusDecodeException`. **Стало:** Максимальная длина значения метки расширена до 1024 символов. Системы, которые генерируют метрики с более длинными значениями (например, с ID источников данных, URL, или сложных идентификаторов), теперь могут успешно передавать такие метрики в Unified Agent без ошибок. **Практический эффект:** Улучшение совместимости с внешними системами мониторинга и приложениями, которые требуют передачи длинных меток. Существующие системы с метками < 256 символов продолжают работать без изменений. --- ## С точки зрения разработчика ### Структурные изменения Расширение требовало изменения способа хранения длины строки в пуле коротких строк: 1. **Prometheus decoder** (library/cpp/monlib): - `MAX_LABEL_VALUE_LEN`: 256 → 1024 2. **Short string pool** (logbroker/unified_agent/common): - `MaxLabelSize`: 255 → 1024 - **Ключевое изменение:** Размер строки теперь хранится как `ui16` (2 байта) вместо `unsigned char` (1 байт) - Было: `*slot->Payload() = static_cast(s.size())` - Стало: `memcpy(slot->Payload(), &size, sizeof(ui16))` - Это позволяет хранить строки до 65535 символов (но логически ограничено на уровне валидации) ### Изменённые файлы | Файл | Основные изменения | |------|------------------| | `prometheus_decoder.cpp` | `MAX_LABEL_VALUE_LEN: 256 → 1024` | | `prometheus_decoder_ut.cpp` | +2 юнит-теста для новых граничных значений | | `short_string_pool.h` | `MaxLabelSize: 255 → 1024`, operator[] использует ui16 для чтения размера | | `short_string_pool.cpp` | Allocation и copy логика адаптирована для ui16 | ### Тестирование Добавлены два новых юнит-теста: - **LabelValueAtNewLimitIsAccepted:** Метрика с меткой ровно 1023 символа успешно парсится ``` "m{l=\"" + string(1023, 'a') + "\"} 1\n" ``` - **LabelValueOverNewLimitStillThrows:** Метрика с меткой ≥1024 символов выбрасывает исключение ``` "m{l=\"" + string(1024, 'a') + "\"} 1\n" // → TPrometheusDecodeException: "trying to parse too long label value, size >= 1024" ``` ### Безопасность и совместимость - ✅ Обратно совместимо: строки < 256 символов работают так же - ✅ Валидация: лимит 1024 проверяется на уровне Ref() в пуле - ✅ Граничные случаи: добавлены тесты для 1023 и 1024 символов - ✅ Выделение памяти: правильно рассчитано с учётом новых 2 байт для размера - ✅ Я не нашел ситуации когда закодированная строка (длина + строка) улетала куда-то из пула и потом пыталась раскодироваться. Так что считаю, что миграции никакой не надо и все обратно совместимо. НАДЕЮСЬ Я НЕ ОШИБАЮСЬ commit_hash:b30852954951bd8e65d69777a59ffeb58da76b47

[cpp/monlib] add ability to mangle name in prometheus decoder

2026-03-02T10:04:29Z

commit_hash:ef6584bf0941f50d0833dacd3b5d14cfc1cd30a8

Fix prometheus nan parsing

2025-12-12T14:14:17Z

commit_hash:ea34eba995ae4c386785fe89df58c439a2e3ea63

Intermediate changes

2025-01-21T08:24:01Z

commit_hash:cdae472f061820ed9998426cf0624c300468cdc8

Remove Size, Empty and Data usages from library

2024-10-04T07:14:38Z

commit_hash:ef5ad4cfa9e68bbfc586492e8c376c732d0a48af

manage prometheus

2024-03-19T09:19:04Z

a543f08a6f2957757c54b3f9e5a095389a51dbeb

skip metrics without name label instead of crashing KIKIMR-21198

2024-03-18T09:10:58Z

c7b986ea7dbf4feee593ab829a2ad361d46c77b0

fix prometheus_decoder ConsumeCounter

2024-02-06T09:39:13Z

feat contrib: aiogram 3

2024-01-19T10:10:03Z

Relates: https://st.yandex-team.ru/, https://st.yandex-team.ru/

External build system generator release 65

2023-12-05T09:25:06Z

Update tools: yexport, os-yexport

ydb/library/cpp/monlib/encode/prometheus, branch main