Объектные метрики и трассировка

У программистов есть возможность создавать свои метрики и трассировку по администрируемым объектам.

Что бы создать метрику, необходимо в классе «Метрики объектов» зарегистрировать запись:

val ropAcMetric = Btk_AcObjectMetricApi().register(
  idParent = Btk_AcObjectApi().findByMnemoCode("Btk_MenuTree"),
  sCode = "Btk_MenuTree_Metric_Test",
  sCaption = "Метрика динамического меню"
)

Внимание

Код метрического прибора или трассировки должен быть не более 255 символов, должен начинаться с буквы и может содержать только следующие специальные символы: „_“, „.“, „-„.

После регистрации администратор в настройках телеметрии во вкладке «Объектные метрики» может включить её для всех пользователей или определённого набора.

Для использования метрики в прикладном коде, необходимо получить метрику и увеличить счётчик.

val longCounterOpt = Btk_TelemetryPkg().getAcObjectLongCounter(
  idUser = Btk_UserApi().getCurrentUserID(),
  idAcObjectMetric = ropAcMetric.idj
)

longCounterOpt.foreach(_.add(1))

Внимание

Методы получения метрических приборов или трассировки возвращают монаду Option. В контейнере значение присутствует, только если на текущем пользователи включены настройки.

Для использования трассировки аналогичные методы, только регистрация происходит в классе Btk_AcObjectTrace.