У плагина WP Discourse есть собственная система ведения журналов (начиная с версии v2.2.5). Ниже приведён обзор того, как она работает и как её использовать. Если у вас возникнут вопросы, пожалуйста, напишите ниже.
Что записывается в журналы
Все основные функции WP Discourse записывают ошибки (начиная с версии v2.3.5). Чтобы регистрировать каждое действие, включая успешные, можно включить подробное ведение журналов для соответствующего набора функций, по которому вы хотите получить больше информации. Ищите настройку, начинающуюся со слова «Подробный…», на соответствующей вкладке настроек.
Как хранятся журналы
Плагин хранит до 10 дней журналов в своей собственной папке uploads/wp-discourse в виде файлов .log, по одному файлу в день. Это означает, что одновременно будет храниться не более 10 файлов, с ограничением размера 5,25 МБ на файл. При достижении этого лимита самый старый файл удаляется при создании нового (т. е. происходит ротация журналов).
Если на вашем экземпляре WordPress невозможно хранить файлы журналов, например, папка загрузок имеет ограниченные права доступа, то система ведения журналов WP Discourse пока не будет работать для вас (все журналы будут отбрасываться).
Наш логгер является расширением широко используемого Monolog, который имеет множество обработчиков, форматтеров и процессоров. Мы добавим возможность использования сайтами другого обработчика (из Monolog или собственного), как только убедимся в эффективности нашего начального локального обработчика .log.
Как просматривать журналы
Вы можете просматривать свои журналы на новой вкладке администратора WP Discourse под названием «Журналы». Это позволяет легко увидеть содержимое каждого файла журнала.
Как делиться журналами
В просмотрщике журналов вы можете скачать ZIP-архив, содержащий ваши журналы, и файл «метаданных» о вашем экземпляре WordPress (версии программного обеспечения и значения настроек WP Discourse). Это упрощает просмотр ваших журналов локально или, возможно, их обмен с кем-то, кто помогает диагностировать проблему.
Обратите внимание на раздел «Конфиденциальность» ниже перед тем, как делиться своими журналами с третьей стороной.
Конфиденциальность
В журналах не содержится:
- любой информации, позволяющей идентифицировать личность, например, имён, адресов электронной почты и адресов; или
- секретов, например, вашего токена API Discourse.
Это минимальные требования, чтобы сделать возможным обмен вашими журналами с третьей стороной, которая помогает вам диагностировать проблему. Тем не менее, перед обменом своими журналами с кем-либо вы должны учитывать конфиденциальность данных вашего сайта и ваших пользователей, а также свои обязательства, связанные с этими данными.