0then0
RU

Метрики и учёт

OverflowLens

Точные границы, когда переполнение кардинальности скрывает исходы запросов. Вычислить возможную долю ошибок, когда OpenTelemetry свёл атрибуты запросов в overflow-серию.

Релиз
v0.2.1, 2 нояб. 2026 г.
Где работает
Браузерное приложение с локальной обработкой файлов; доступен автономный архив
Лицензия
Apache-2.0
Открыть приложениеСкачать автономный архивИсходный код

Скачать автономный архив: Приложение доступно в браузере. Архив v0.2.1 можно запустить локально.

Known successes                 900
Known errors                      1
SDK overflow                     99
Total                         1,000

Possible true error rate       0.1% … 10%
Maximum allowed error rate       1%
Conclusion: Cannot determine from these data
Задокументированный результат встроенного синтетического примера delta при пороге 1%; это не измерение рабочей системы.

Что делает

Импортируйте сохранённый счётчик запросов OpenTelemetry и сравните возможную долю ошибок со своим порогом. Режим delta анализирует один интервал сбора; cumulative сопоставляет снимки до и после. Файлы разбираются локально в Web Worker; подсчёт и границы рассчитываются в браузере. Размещённое приложение скачивает свои ресурсы; импортированные файлы, порог и экспортированные отчёты никуда не загружаются.

Для кого

  • Разработчикам, которые разбирают долю ошибок после переполнения кардинальности в OpenTelemetry SDK.

Ограничения

  • Принимаются несжатые UTF-8 OTLP JSON со счётчиками Sum, монотонными и целочисленными, до 5 МиБ на файл. Это не сервер живых метрик и не средство полной оценки SLO.
  • Для накопительного окна нужны сопоставимые полные снимки с неизменной атрибуцией и известным неизменным временем начала, без сбросов и уменьшения счётчиков.
  • Допущения о происхождении данных нужно подтвердить. Файл не доказывает, что при обработке сохранились все значения счётчиков и точки переполнения.

Типичные сценарии

Разобрать интервал delta

Откройте встроенный пример, подтвердите допущения и посмотрите, почему при границах от 0,1% до 10% нельзя определить соблюдение порога 1%.

Сравнить накопительные снимки

Выберите выгрузки до и после из одной непрерывной истории счётчика. В браузерную сборку включена синтетическая пара из лаборатории SDK.

Скачать

Последний стабильный релиз v0.2.1, опубликован 2 нояб. 2026 г.. Примечания к релизу. Данные о релизах проверены 2 нояб. 2026 г. по GitHub Releases.

Любая платформа

Скачать: Архив ZIP 96 кБ
  • Универсальная
  • Пакет
  1. Распакуйте ZIP и раздайте его папку по HTTP. Node.js и Go не нужны.

Проверка загрузки

В SHA256SUMS.txt перечислены хеши SHA-256 файлов релиза. Совпадение хеша показывает, что ваш файл идентичен загруженному в релиз. Это контрольная сумма, а не подпись автора: она не доказывает, кто собрал файл.

shasum -a 256 -c --ignore-missing SHA256SUMS.txt

Первый запуск

  1. Откройте приложение и выберите пример delta или cumulative. SDK и свои файлы не нужны.

  2. Для уже опубликованной автономной сборки скачайте ZIP, распакуйте и запустите статический HTTP-сервер внутри overflowlens-0.2.1:

    python3 -m http.server 8080 --bind 127.0.0.1

  3. Откройте http://127.0.0.1:8080, выберите режим, подтвердите допущения о происхождении данных и задайте максимально допустимый процент ошибок. Экспортируйте JSON, чтобы сохранить объяснение.

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

  • Современный браузерЗаявлено, запуск не проверялся

    Статическое приложение на GitHub Pages; для автономного архива нужен HTTP-сервер, открытие через file:// не подходит.

Вопросы и сообщения об ошибках — в трекер задач проекта. О проблемах безопасности сообщайте так, как описано в его политике безопасности.