Как включить APDEX в 1С и настроить контроль производительности

APDEX (Application Performance Index) — стандартный показатель производительности, который в 1С используется для оценки того, насколько быстро система отвечает пользователям. Включить APDEX в 1С можно двумя способами: через настройку технологического журнала с помощью файла logcfg.xml или через подсистему оценки производительности (БСП) и инструмент ЦУП. Выбор зависит от того, нужен ли вам разовый сбор данных для диагностики или постоянный мониторинг.

Механизм APDEX делит все операции на три категории по времени выполнения: удовлетворительные, допустимые и неприемлемые. Граница между ними задаётся целевым временем отклика T. Операции быстрее T считаются хорошими, от T до 4T — терпимыми, дольше 4T — плохими. Итоговый индекс от 0 до 1 показывает общую картину: чем ближе к единице, тем лучше пользователи оценивают скорость работы.

Прежде чем включать сбор APDEX, определитесь с целевым временем отклика для вашей системы. Для интерактивных операций проведения документов типичные ориентиры — доли секунды до нескольких секунд, для тяжёлых отчётов порог выбирают выше. Некорректно выбранное T приведёт к тому, что индекс будет либо всегда «отличным», либо всегда «плохим», и пользы от мониторинга не будет.

Что такое APDEX в контексте 1С и когда он нужен

APDEX в 1С измеряет время выполнения ключевых операций — вызовов сервера, обращений к СУБД, сервисных вызовов — и сводит их в единый индекс удовлетворённости. Это удобно, когда нужно объективно ответить на жалобы «1С тормозит»: вместо субъективных ощущений вы получаете число, которое можно отслеживать во времени и сравнивать между периодами.

Включать сбор APDEX имеет смысл при расследовании проблем производительности, при приёмочном тестировании после обновления конфигурации, при планировании мощностей сервера и при контроле SLA. Если система работает стабильно и жалоб нет, постоянный сбор можно настроить с умеренной детализацией, чтобы не создавать лишнюю нагрузку.

Включение APDEX через технологический журнал (logcfg.xml)

Технологический журнал — встроенный механизм кластера серверов 1С, который включается файлом конфигурации logcfg.xml. Чтобы собирать события APDEX, файл нужно разместить в каталоге conf сервера 1С (или в каталоге, заданном параметром запуска) и добавить в него секцию с элементом apdex. После изменения файла настройки применяются автоматически в течение короткого времени, перезапуск службы не требуется.

В секции apdex задаётся целевое время отклика через элемент с соответствующим свойством. Минимальный рабочий пример конфигурации выглядит так:

<config xmlns="http://v8.1c.ru/v8/tech-log">
<log location="C:\1clogs" history="24">
<event>
<eq property="name" value="EXCP"/>
</event>
<property name="all"/>
</log>
<apdex>
<targetTime>1</targetTime>
</apdex>
</config>

События APDEX записываются в технологический журнал и содержат вычисленные значения индекса по интервалам. Данные из журнала затем разбираются вручную, скриптами или загружаются в инструменты анализа. Учтите, что журнал пишется на каждом сервере кластера отдельно — при нескольких рабочих серверах logcfg.xml нужно разместить на каждом из них.

1. 1
   Определите целевое время отклика T для ключевых операций
2. 2
   Создайте или отредактируйте файл logcfg.xml в каталоге conf сервера 1С
3. 3
   Добавьте секцию apdex с элементом targetTime и нужными событиями
4. 4
   Дождитесь автоматического применения настроек (обычно до минуты)
5. 5
   Проверьте, что в каталоге журнала появились файлы с событиями
6. 6
   Повторите настройку на всех рабочих серверах кластера

Включение оценки производительности в конфигурациях на БСП

В типовых конфигурациях на базе Библиотеки стандартных подсистем есть встроенный механизм «Оценка производительности». Он фиксирует время выполнения ключевых операций и рассчитывает APDEX автоматически. Включается он в разделе администрирования: «Настройки» → «Поддержка и обслуживание» → «Оценка производительности» (точный путь зависит от конфигурации). Там же задаётся целевое время отклика и периодичность расчёта индекса.

Для работы механизма нужно, чтобы замеры выполнялись регламентным заданием, а накопленные данные периодически выгружались. В настройках укажите расписание выгрузки и при необходимости — каталог обмена. Собранные данные можно просматривать во встроенных отчётах или передавать в ЦУП для централизованного мониторинга нескольких баз.

Ограничение этого способа: замеряются только операции, обёрнутые в API оценки производительности. Типовые конфигурации уже содержат такие замеры для основных сценариев, но самописные доработки нужно оборачивать в замеры вручную через программный интерфейс подсистемы.

Настройка ЦУП для централизованного мониторинга APDEX

Центр управления производительностью (ЦУП) — отдельная конфигурация, которая собирает показатели APDEX и другие метрики с нескольких информационных баз в одном месте. Это основной вариант для организаций с несколькими продуктивными системами: вместо разбора журналов на каждом сервере вы получаете единую панель с индексами, трендами и детализацией до конкретных операций.

Настройка строится в два этапа. Сначала в каждой контролируемой базе включается оценка производительности и настраивается выгрузка данных в общий каталог или по HTTP. Затем в ЦУП добавляются подключения к этим базам, задаётся расписание загрузки показателей и настраиваются пороги сигнализации — при падении APDEX ниже заданного уровня ЦУП формирует оповещение.

Сравнение способов сбора APDEX

Технологический журнал (logcfg.xml)

Подходит для разовой диагностики и низкоуровневого анализа. Не требует изменения конфигурации, но данные нужно разбирать вручную или скриптами.

Подсистема «Оценка производительности» (БСП)

Подходит для постоянного мониторинга одной базы. Простая настройка из интерфейса, но замеряются только операции, обёрнутые в API подсистемы.

ЦУП

Подходит для нескольких баз и регулярного контроля SLA. Требует развёртывания отдельной конфигурации и настройки обмена.

Выбор целевого времени отклика и проверка результата

Главная ошибка при включении APDEX — произвольный выбор T. Правильный подход: сначала соберите фактические времена выполнения ключевых операций за репрезентативный период (например, неделю обычной работы), затем установите T чуть выше медианного времени для «хороших» операций. Слишком жёсткий порог сделает индекс постоянно низким и демотивирует, слишком мягкий — скроет реальные проблемы.

Для разных типов операций пороги должны отличаться. Проведение документа и построение годового отчёта — операции разного класса, и мерить их одним T некорректно. В ЦУП и в подсистеме БСП можно задавать целевое время для отдельных ключевых операций индивидуально.

Контрольные точки

Как проверить, что APDEX работает

Файлы технологического журнала

Норма

В указанном каталоге появляются файлы с событиями после применения logcfg.xml

Тревожный признак

Каталог пуст — проверьте путь, права доступа и синтаксис XML

Данные оценки производительности

Норма

В отчётах появляются замеры операций и значения APDEX за период

Тревожный признак

Замеров нет — проверьте, что регламентное задание выполняется без ошибок

Адекватность индекса

Норма

Индекс реагирует на реальные периоды замедления

Тревожный признак

Индекс всегда около 1 или 0 — пересмотрите целевое время T

Типичные ошибки и ограничения

Самая частая проблема — синтаксические ошибки в logcfg.xml: незакрытые теги, неверное пространство имён, опечатки в именах свойств. При ошибке технологический журнал просто не включается, и это легко пропустить. Всегда проверяйте появление файлов журнала после правки конфигурации.

Вторая группа ошибок связана с эксплуатацией: журнал пишется в каталог с недостатком места на диске, история хранения не ограничена и файлы разрастаются, настройки забывают применить на всех серверах кластера. Задавайте параметр history для ограничения глубины хранения и следите за свободным местом.

Итоги и рекомендации по эксплуатации

Для разовой диагностики достаточно технологического журнала с секцией apdex — это быстрый способ получить данные без изменения конфигурации. Для постоянного мониторинга одной базы удобнее встроенная оценка производительности БСП. Если баз несколько и нужен контроль SLA, разворачивайте ЦУП.

Независимо от способа результат имеет смысл только при регулярном анализе: отслеживайте тренд индекса, реагируйте на устойчивое снижение, пересматривайте целевое время при изменении нагрузки или состава операций. APDEX — инструмент наблюдения, а не самоцель.

Частые вопросы

Нужно ли перезапускать сервер 1С после изменения logcfg.xml?

Нет. Кластер серверов периодически перечитывает файл конфигурации технологического журнала, и изменения применяются автоматически, обычно в течение минуты. Если настройки не подхватились, проверьте расположение файла и синтаксис XML.

Какое значение целевого времени T выбрать для начала?

Универсального значения нет. Практичный подход — собрать фактические времена выполнения ключевых операций за неделю и установить T немного выше типичного времени «быстрых» операций. Затем скорректируйте порог по результатам наблюдений.

Можно ли собирать APDEX в файловой базе 1С?

Технологический журнал с logcfg.xml ориентирован на клиент-серверный вариант работы. В файловой базе используйте подсистему оценки производительности БСП — она работает независимо от режима развёртывания.

Влияет ли сбор APDEX на производительность системы?

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

Чем APDEX отличается от простого замера времени операций?

Простой замер даёт средние значения, которые сглаживают всплески. APDEX учитывает распределение: редкие, но долгие операции снижают индекс, отражая реальный пользовательский опыт. Поэтому индекс чувствительнее к деградации, чем среднее время.

Где смотреть собранные значения APDEX?

При сборе через технологический журнал — в файлах журнала (вручную или скриптами разбора). При использовании подсистемы БСП — во встроенных отчётах оценки производительности. При работе с ЦУП — на панелях мониторинга с детализацией по базам и операциям.