Перейти к основному содержанию
`Ctrl`+`K`

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

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

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

    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.