Skip to content

Модуль PrometheusRegistry

Фасад над внутренним классом CollectorRegistry.

  • управляет реестром по умолчанию;
  • позволяет регистрировать/снимать регистрацию коллекторов;
  • собирает метрики из всех коллекторов и возвращает массив семейств в промежуточном формате.

Реестр по умолчанию

Функция ПолучитьРеестрПоУмолчанию() Экспорт

Ленивая инициализация объекта CollectorRegistry:

  • при первом вызове создаёт Новый CollectorRegistry();
  • далее возвращает уже созданный экземпляр.

Используется модулем Prometheus и может использоваться напрямую, если нужно управлять регистрацией коллекторов.

Регистрация коллекторов

Функция Зарегистрировать(Коллектор) Экспорт

Регистрирует коллектор в системе метрик.

Вызов делегируется в CollectorRegistry.Register(Коллектор) реестра по умолчанию.

Функция СнятьРегистрацию(Коллектор) Экспорт

Снимает регистрацию коллектора:

  • вызывает CollectorRegistry.Unregister(Коллектор).

Возвращает Истина, если коллектор был снят, иначе Ложь.

Процедура ЗарегистрироватьОбязательно(Коллектор) Экспорт

Обёртка над Зарегистрировать:

  • вызывает Зарегистрировать(Коллектор);
  • при неуспехе выбрасывает исключение "Не удалось зарегистрировать коллектор метрик".

Полезно при инициализации критичных метрик, без которых приложение не должно продолжать работу.

Сбор метрик

Функция Собрать() Экспорт

Собирает метрики из:

  • Реестра по умолчанию (CollectorRegistry.Gather()).

Возвращает массив семейств метрик:

  • каждое семейство — структура с полями Имя, Тип, Справка, Сэмплы;
  • структура соответствует промежуточному формату, описанному в спецификации библиотеки.