Диагностика высокой загрузки ЦП с помощью файлов coolwsd или loolwsd от Collabora.

Высокая загрузка ЦП процессом coolwsdили устаревшим loolwsdпроцессом не является автоматически ошибкой: Collabora создает рабочие процессы обработки документов, и открытие или редактирование сложных файлов может потреблять ресурсы ЦП. Сначала определите, какой процесс потребляет ресурсы ЦП, затем сопоставьте его с открытыми документами и пользователями в консоли администратора. Если один документ занимает рабочий процесс, пока тот простаивает, проверьте журналы и настройки очистки, прежде чем перезапускать что-либо; завершение работы рабочих процессов может прервать активное редактирование.

Определите название услуги и измерьте нагрузку.

В более новых установках используется это coolwsdимя; в более старых установках может по-прежнему отображаться . В примечаниях к обновлениюloolwsd Collabora до версии 21.11 описывается однократная миграция с на . Сопоставляйте имена служб и конфигураций, установленных на вашем хосте, вместо того, чтобы предполагать, что каждое развертывание идентично./etc/loolwsd/loolwsd.xml/etc/coolwsd/coolwsd.xml

На хосте с systemd проверьте службу, а затем выведите список процессов, использующих ЦП:

systemctl status coolwsd
ps -eo pid,ppid,%cpu,%mem,etime,cmd --sort=-%cpu | head -n 20

Если служба называется loolwsd, подставьте это имя в команду systemctl. Проанализируйте несколько показаний за определенный период времени, topа не рассматривайте один короткий всплеск как постоянную проблему. Изучите дерево процессов: ЦП может использоваться рабочими процессами документов под демоном, а не самим родительским процессом. В Docker проверьте общий объем ресурсов контейнера с помощью docker stats --no-stream CONTAINER_NAME; в Kubernetes используйте соответствующие метрики ресурсов пода. Эти показания описывают разные области применения, поэтому внимательно сравните значения для хоста, контейнера и рабочих процессов.

Найдите документ или рабочую нагрузку, ставшие причиной всплеска активности.

Войдите в консоль администратора Collabora и просмотрите список подключенных пользователей, открытых документов, использование ресурсов и последние графики. В официальном разделе часто задаваемых вопросов Collabora описаны эти возможности мониторинга. Если нагрузка возрастает во время открытия или преобразования большой электронной таблицы, презентации, PDF-файла или документа, понаблюдайте, снизится ли она после завершения этой операции. Временный всплеск нагрузки, связанный с реальной рабочей нагрузкой, требует планирования мощностей или уменьшения рабочей нагрузки; сам по себе он не является признаком неконтролируемого роста нагрузки.

Если после закрытия документа пользователем он по-прежнему потребляет много ресурсов ЦП, убедитесь, что ни одна сессия браузера или интеграция не удерживает его открытым. Запишите идентификатор документа, отображаемый в консоли, идентификатор процесса, продолжительность, объем используемой памяти, а также информацию о том, был ли файл активен или простаивал. Избегайте указания личных или конфиденциальных названий документов в публичных запросах в службу поддержки.

Сравните демон с его дочерними процессами; наиболее загруженным рабочим процессом может быть не родительский процесс coolwsd.

Перед изменением настроек сервера сопоставьте историю использования ЦП с данными активных пользователей и документами.

Используйте журналы событий, чтобы отличить всплеск активности от простоя работника.

При установке systemd на основе пакетов проверьте последние сообщения службы:

journalctl -u coolwsd --since "15 minutes ago"

Используйте это, loolwsdесли это имя службы в вашей системе. Ищите повторяющиеся ошибки загрузки документов или преобразования, перезапуски рабочих процессов и сообщения, появляющиеся в моменты повышения загрузки ЦП. Если ваша система записывает данные в файл, а не в системный журнал, используйте настроенное место назначения для логов. Для контейнеров просмотрите журналы контейнеров Collabora с помощью команды log вашей среды выполнения. Соответствующее местоположение и доступные сообщения различаются в зависимости от метода установки и версии.

Повторяющаяся ошибка, связанная с одним файлом, предполагает выделение копии этого файла и проверку, повторяется ли та же закономерность. Широкое увеличение количества ошибок, затрагивающих множество документов, указывает на параллельную обработку или нехватку ресурсов сервера. Если журналы указывают на известный дефект, обновите Collabora через поддерживаемый канал для вашей установки; проверьте примечания к выпуску для вашей редакции и версии, вместо того чтобы применять несвязанное обходное решение.

Корректируйте параллельное выполнение только тогда, когда это подтверждают имеющиеся доказательства.

Схема конфигурации Collabora определяет per_document.max_concurrencyмаксимальное количество потоков, используемых при обработке документа. Текущий официальный шаблон конфигурации coolwsd также описывает проверки очистки для документов, которые остаются неактивными и превышают заданные пороговые значения ресурсов. Точные значения по умолчанию и доступные поля могут различаться в зависимости от версии, поэтому перед внесением изменений проверьте coolwsd.xmlконфигурацию, поставляемую с вашей установленной версией.

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

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

Сравните состояние службы с последними сообщениями в журнале, чтобы определить, совпадает ли увеличение загрузки ЦП с ошибками или перезапусками рабочих процессов.

Перед изменением пороговых значений параллельного выполнения или очистки проверьте схему установленной версии.

Проверьте изменения безопасным способом.

• Перед изменением конфигурации необходимо зафиксировать показания процессора и памяти.
• Уточните, относится ли загрузка к самому coolwsd/loolwsd или к обработчику документов.
• Используйте консоль администратора и журналы для идентификации активных документов и сопоставления времени всплеска активности.
• После внесения одного контролируемого изменения повторите ту же рабочую нагрузку и сравните показатели загрузки ЦП, время открытия документа, скорость отклика при редактировании и поведение обработчиков событий.
• Перед тем как считать проблему решенной, убедитесь, что активные пользователи по-прежнему могут редактировать и сохранять файлы.

Если загрузка ЦП остается высокой при отсутствии активных документов, сохраняется после контролируемой перезагрузки или совпадает с повторяющимися сбоями, соберите информацию о версии Collabora, способе установки, журналах служб/контейнеров, дереве процессов и очищенных данных документов для разработчика или поставщика. Избегайте многократного завершения дочерних процессов: Collabora управляет этими рабочими процессами, и ручное завершение может нарушить работу пользователей без устранения основной причины.