Замеряемый

Аннотация для автоматического замера длительности выполнения методов (аналог @Timed из Spring Boot).

Синтаксис

&Замеряемый[(Значение)]
Функция ИмяМетода(...) Экспорт
    ...
КонецФункции

Параметры

Значение

Тип: Строка (опционально)

Имя метрики. Должно соответствовать формату OTel (ASCII, точки как разделители). Если не указано, используется "ИмяБина.ИмяМетода.duration" с автоматической транслитерацией кириллицы.

Описание

Аннотация &Замеряемый оборачивает метод в декоратор, который:

1. Фиксирует время начала вызова
2. После завершения метода записывает длительность (в мс) в гистограмму OTel
3. При исключении записывает длительность с атрибутом exception

Атрибуты гистограммы: code.function.name, code.namespace, exception (при ошибке).

При размещении на конструкторе (вместе с &Желудь) инструментируются все экспортные методы класса.

Примеры

Инструментация одного метода

&Замеряемый("payments.process.duration")
Функция ОбработатьПлатёж(Данные) Экспорт
    Возврат ПровестиПлатёж(Данные);
КонецФункции

Инструментация всех методов класса

&Желудь
&Замеряемый
Процедура ПриСозданииОбъекта()
КонецПроцедуры

Комбинирование с другими аннотациями

&Наблюдаемый("orders.process")
&Замеряемый("orders.duration")
Функция ОбработатьЗаказ(ИдЗаказа) Экспорт
    Возврат СформироватьОтвет(ИдЗаказа);
КонецФункции

См. также

• Наблюдаемый — создание span'ов вокруг методов
• Подсчитываемый — счётчик вызовов методов