plugin:statdisplay
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
plugin:statdisplay [2018-10-07 09:35] – shintak | plugin:statdisplay [2024-01-08 16:13] (current) – Aleksandr | ||
---|---|---|---|
Line 5: | Line 5: | ||
author | author | ||
email : gohr@cosmocode.de | email : gohr@cosmocode.de | ||
- | type : syntax | + | type : syntax, CLI |
- | lastupdate : 2016-08-29 | + | lastupdate : 2022-12-12 |
- | compatible : Elenor of Tsort, | + | compatible : Greebo, Hogfather, Igor |
- | depends | + | depends |
conflicts | conflicts | ||
similar | similar | ||
Line 18: | Line 18: | ||
---- | ---- | ||
- | [[http:// | + | [[https:// |
The statdisplay plugin displays various statistics computed using a log file (NCSA combined i.e. like Apache) of all access to DokuWiki pages. The logfile can be read from an Apache log file, or if not available, generated using the [[logstats]] plugin. | The statdisplay plugin displays various statistics computed using a log file (NCSA combined i.e. like Apache) of all access to DokuWiki pages. The logfile can be read from an Apache log file, or if not available, generated using the [[logstats]] plugin. | ||
Line 32: | Line 32: | ||
===== Log Analysis ===== | ===== Log Analysis ===== | ||
- | Once installed and configured through the Configuration Manager, it will automatically start to analyze the log file. To limit the time and memory consumption of the log analysis, this is done in chunks of a maximum number of lines per run. The log file analysis is triggered through DokuWiki' | + | Once installed and configured through the Configuration Manager, it will automatically start to analyze the log file. To limit the time and memory consumption of the log analysis, this is done in chunks of a maximum number of lines per run. The log file analysis is triggered through DokuWiki' |
Note: it is important to adjust the number of lines to analyze in the config through the lines parameter. If your wiki has many accesses, the default of 500 may be too low to effectively analyze your logs. | Note: it is important to adjust the number of lines to analyze in the config through the lines parameter. If your wiki has many accesses, the default of 500 may be too low to effectively analyze your logs. | ||
+ | |||
+ | ==== Command Line Interface ==== | ||
+ | |||
+ | The command line interface allows you to quickly catch up with an existing log file. Run it like this in your DokuWiki directory: | ||
+ | |||
+ | $> ./ | ||
+ | |||
+ | Increasing the number of lines analysed at once can increase the effectiveness when running from command line. When the parameter is not given the one from the config is used. | ||
+ | |||
+ | You can also use the CLI to completely reindex your log file (this throws away all previously analyzed data). | ||
+ | |||
+ | $> ./ | ||
+ | |||
===== Limitations ===== | ===== Limitations ===== | ||
+ | |||
The plugin tries to limit it's memory usage as far as possible. The log file is only read line-by-line. However all aggregated data is held inside a single memory structure. If you have a lot of accesses, or are running the plugin over a very long period of time, you may need to increase the memory size limit in your php.ini file. | The plugin tries to limit it's memory usage as far as possible. The log file is only read line-by-line. However all aggregated data is held inside a single memory structure. If you have a lot of accesses, or are running the plugin over a very long period of time, you may need to increase the memory size limit in your php.ini file. | ||
Line 42: | Line 56: | ||
The chunksize that is read is determined by the number in the configuration. This also determinates that the plugin waits for about this number of accesses before another chunk is read. You may want to raise this number for wikis with many active users or lower it for wikis with few active users. | The chunksize that is read is determined by the number in the configuration. This also determinates that the plugin waits for about this number of accesses before another chunk is read. You may want to raise this number for wikis with many active users or lower it for wikis with few active users. | ||
+ | |||
===== Syntax ===== | ===== Syntax ===== | ||
Line 55: | Line 70: | ||
{{statdisplay> | {{statdisplay> | ||
+ | |||
==== Access Summary ==== | ==== Access Summary ==== | ||
plugin/statdisplay.1538897707.txt.gz · Last modified: 2018-10-07 09:35 by shintak