====== Log Statistics Plugin ======

---- plugin ----
description: Этот плагин предоставляет файл журнала (комбинированный с NCSA, например Apache) всех доступов к страницам DokuWiki.
author     : Andreas Gohr
email      : dokuwiki@cosmocode.de
type       : action
lastupdate : 2016-07-06
compatible : Binky, Angua, Adora Belle, Detritus, Elenor of Tsort, Greebo, Igor, Kaos
depends    : 
conflicts  : 
similar    : statistics
tags       : logging, statistics

downloadurl: https://github.com/cosmocode/dokuwiki-plugin-logstats/zipball/master
bugtracker : https://github.com/cosmocode/dokuwiki-plugin-logstats/issues
sourcerepo : https://github.com/cosmocode/dokuwiki-plugin-logstats/
donationurl: 
----

Первоначально этот плагин был написан [[jean-francois.lalande@ensi-bourges.fr|Jean-François Lalande]] на основе [[wiki:tips:logging|кода]]  Matthias Grimm.

Плагин logstats предоставляет файл журнала (NCSA combined, т.е. как apache) всех доступов к страницам DokuWiki и медиафайлам. Таким образом, этот файл может быть использован для генерации различных статистических данных об использовании dokuwiki.

Файл журнала можно проанализировать с помощью популярного программного обеспечения для веб-аналитики или в DokuWiki с помощью плагина [[plugin:statdisplay|statdisplay]].

[[https://www.cosmocode.de/en/open-source/dokuwiki-plugins/|{{ https://www.cosmocode.de/static/img/dokuwiki/dwplugins.png?recache|A CosmoCode Plugin}}]]

===== Установка =====

Найдите и установите плагин с помощью [[plugin:extension|Extension Manager]]. Обратитесь к разделу [[wiki:Plugins|Плагины]] , чтобы узнать, как установить плагины вручную

==== Изменения ====

{{rss>https://github.com/cosmocode/dokuwiki-plugin-logstats/commits/master.atom date}}

===== Конфигурация и настройки =====

Конфигурацией этого плагина можно управлять непосредственно в DokuWiki (см. ссылку Конфигурация в интерфейсе администратора).\\  
Для других параметров отредактируйте файл ''lib/plugins/logstats/conf/dafault.php''

==== Расположение файла журнала ====

Вы можете изменить имя файла журнала, используя ''$conf['plugin']['logstats']['accesslog']'' переменную. Когда указано относительное имя файла (что по умолчанию), оно относится к ''data/meta/каталогу.''

<code php>
$conf['plugin']['logstats']['accesslog'] = "access.log";
</code>

==== Запрещенные IP-адреса ====

Вы можете запретить регистрацию некоторых IP-адресов (например, вашего собственного IP-адреса). Для этого используйте переменную, ''$conf['plugin']['logstats']['banned_ip']'' которая представляет собой строку, содержащую все запрещенные IP-адреса, разделенные запятой.

<code php>
$conf['plugin']['logstats']['banned_ip'] = "127.0.0.1,192.168.0.1,192.168.0.2";
</code>

==== Забаненные пользователи ====

Вы можете запретить некоторым пользователям (вошедшим в DokuWiki) входить в систему. Для этого используйте переменную, ''$conf['plugin']['logstats']['banned_users']'' которая представляет собой строку, содержащую всех забаненных пользователей, разделенных запятой.

<code php>
$conf['plugin']['logstats']['banned_users'] = "bob,alice,gugu";
</code>

==== Запрещенные User Agent (для ботов) ====

Вы можете забанить некоторых пользовательских агентов. Это полезно для агентов-ботов, таких как **google bot.** Для этого используйте переменную, ''$conf['plugin']['logstats']['banned_agents']'' которая представляет собой строку, содержащую все строки забаненных агентов, разделенные запятой.

<code php>
$conf['plugin']['logstats']['banned_agents'] = "Googlebot,HooWWWer";
</code>

===== Известные ограничения =====

В отличие от вашего веб-сервера, этот плагин не будет регистрировать никакие обращения к собственным файлам DokuWiki ( CSS , изображения, скрипты и т. д.). Регистрируется только контент, то есть страницы вики и медиафайлы.

Ведение журнала может оказать небольшое влияние на производительность, поскольку каждый запрос будет создавать запись на диск.

==== Проблема, когда размер файла журнала превышает 64 МБ: ====

<fc #ff0000>**Если размер файла access.log превышает 64 МБ , в журнале сервера печатается следующее сообщение и dokuwiki перестает работать:**</fc>
<code>
FastCGI: "...doku.php" aborted: incomplete headers (0 bytes) received from server after 4 sec
</code>
Мой dokuwiki размещен на strato (пакет «PowerWeb Basic»). У меня нет возможности что-либо изменить в конфигурации php. Я потратил много времени, пытаясь выяснить, в чем проблема. Было бы неплохо иметь лучшую индикацию ошибок или, что еще лучше, добавить поле ограничения файла в конфигурацию плагина и архивировать файл, как только достигается ограничение размера.

===== Предложения =====

Возможно ли запустить инструмент с годовым файлом журнала? Например.
<code php>$conf['plugin']['logstats']['accesslog'] = "access.log";</code>
может создать 2014.access.log, если текущий год 2014, 2015.access.logесли текущий год 2015

Это не обязательно, но, пожалуйста, рассмотрите возможность ссылки на [[https://www.dokuwiki.org/plugin:logstats|эту страницу]] с вашего сайта, если вам нравится этот продукт.