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

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

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

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

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

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

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

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

longCounterOpt.foreach(_.add(1))
```

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

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