plugin:rrdgraph
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
plugin:rrdgraph [2016-08-28 13:54] – [Prerequisites]: added link to tips section LarsDW223 | plugin:rrdgraph [2023-04-26 20:07] (current) – screenshot Aleksandr | ||
---|---|---|---|
Line 6: | Line 6: | ||
email : developer@flashsystems.de | email : developer@flashsystems.de | ||
type : syntax, action, helper, render | type : syntax, action, helper, render | ||
- | lastupdate : 2016-08-28 | + | lastupdate : 2019-01-12 |
- | compatible : Ponder Stibbons, Hrun, Detritus, Elenor Of Tsort+ | + | compatible : Detritus, Elenor Of Tsort, Frusterick Manners, Greebo |
- | screenshot_img : http:// | + | tags : images, |
- | tags : | + | |
- | downloadurl: | + | downloadurl: |
- | bugtracker : https:// | + | bugtracker : |
sourcerepo : https:// | sourcerepo : https:// | ||
+ | |||
+ | screenshot_img : https:// | ||
---- | ---- | ||
+ | |||
+ | :!: **This Plugin is no longer maintained. If you want to take over maintaining it go ahead and contact me.** :!: | ||
===== Installation ===== | ===== Installation ===== | ||
- | :!: **Important Warning:** The RRDgraph plugin uses the cache to store the generated images and the recipes. Please make sure you have a [[https:// | ||
- | Install the plugin | + | :!: **Important Warning:** The RRDgraph |
+ | |||
+ | Search | ||
==== Prerequisites ==== | ==== Prerequisites ==== | ||
+ | |||
To use this plugin your PHP installation must have been compiled with __GD support__ and the __rrd extension__ must be installed and activated. Regarding GD support also see [[tips: | To use this plugin your PHP installation must have been compiled with __GD support__ and the __rrd extension__ must be installed and activated. Regarding GD support also see [[tips: | ||
Line 27: | Line 32: | ||
===== Introduction ===== | ===== Introduction ===== | ||
+ | |||
The RRDtool website says " | The RRDtool website says " | ||
==== Ahead of time generation ==== | ==== Ahead of time generation ==== | ||
+ | |||
This is the classical way to embed RRD graphs into DokuWiki pages. The graphs are generated by a cron job and stored as image files. These images are embedded into wiki pages. | This is the classical way to embed RRD graphs into DokuWiki pages. The graphs are generated by a cron job and stored as image files. These images are embedded into wiki pages. | ||
Line 45: | Line 52: | ||
==== Just in time generation ==== | ==== Just in time generation ==== | ||
+ | |||
The instructions and options for generating the RRD graphs are stored withing the DokuWiki documents. The graphs are generated on the fly by a plugin. | The instructions and options for generating the RRD graphs are stored withing the DokuWiki documents. The graphs are generated on the fly by a plugin. | ||
Line 59: | Line 67: | ||
===== Examples/ | ===== Examples/ | ||
+ | |||
The RRDgraph DokuWiki plugin supplies the necessary infrastructure to implement just in time generation of RRD graphs on DokuWiki pages. | The RRDgraph DokuWiki plugin supplies the necessary infrastructure to implement just in time generation of RRD graphs on DokuWiki pages. | ||
==== Generating graphs ==== | ==== Generating graphs ==== | ||
+ | |||
RRDtool gets its drawing instructions via the command line. There are [[http:// | RRDtool gets its drawing instructions via the command line. There are [[http:// | ||
Line 69: | Line 79: | ||
==== Syntax ==== | ==== Syntax ==== | ||
+ | |||
The RRDgraph plugin provides the ''< | The RRDgraph plugin provides the ''< | ||
Line 79: | Line 90: | ||
OPT:h=100 | OPT:h=100 | ||
LINE: | LINE: | ||
- | </ttd> | + | </rrd> |
</ | </ | ||
Line 91: | Line 102: | ||
=== RRDgraph commands === | === RRDgraph commands === | ||
+ | |||
RRDgraph extends the RRDtool command set to allow for a consistent syntax. | RRDgraph extends the RRDtool command set to allow for a consistent syntax. | ||
== OPT == | == OPT == | ||
+ | |||
This command defines a command line option. There are two flavours of the '' | This command defines a command line option. There are two flavours of the '' | ||
Line 118: | Line 131: | ||
| | ||
== RANGE == | == RANGE == | ||
+ | |||
RRDtool needs a time range to draw graphs for. You can define one or more time ranges via the '' | RRDtool needs a time range to draw graphs for. You can define one or more time ranges via the '' | ||
Line 129: | Line 143: | ||
== INCLUDE == | == INCLUDE == | ||
+ | |||
The '' | The '' | ||
Line 135: | Line 150: | ||
=== Using templates === | === Using templates === | ||
+ | |||
The RRDgraph '' | The RRDgraph '' | ||
Line 151: | Line 167: | ||
=== Ganging === | === Ganging === | ||
+ | |||
Sometimes you have to RRD graphs that show different aspects of a data set. Like CPU load and clock frequency. Wouldn' | Sometimes you have to RRD graphs that show different aspects of a data set. Like CPU load and clock frequency. Wouldn' | ||
Line 160: | Line 177: | ||
=== Conditions === | === Conditions === | ||
+ | |||
Sometimes you want to hide some lines in longer time ranges because they clutter up the graph. Or you want to show additional information if the graph is clicked and displayed full screen. Conditions can be used to accomplish this. You can prefix any command with a question mark and add a condition. The commands are automatically ignored if the condition is false. A simple RPN parser is available for more complex setups. | Sometimes you want to hide some lines in longer time ranges because they clutter up the graph. Or you want to show additional information if the graph is clicked and displayed full screen. Conditions can be used to accomplish this. You can prefix any command with a question mark and add a condition. The commands are automatically ignored if the condition is false. A simple RPN parser is available for more complex setups. | ||
Line 194: | Line 212: | ||
=== Changing the border color === | === Changing the border color === | ||
+ | |||
RRDgraph sets the color of the graph border to a nice shade of gray. If you want to override this you have to override the options '' | RRDgraph sets the color of the graph border to a nice shade of gray. If you want to override this you have to override the options '' | ||
< | < | ||
Line 207: | Line 226: | ||
==== SVG binding mode ==== | ==== SVG binding mode ==== | ||
+ | |||
Sometimes you want a more prominent appearance of your RRD data than just lines on a graph. Maybe the current network utilization should be shown on a real network map or the current temperature outside the building should be displayed in big letters. This can be achieved via the SVG binding mode. It takes a SVG image from the media library and processes it to insert values from the RRD. | Sometimes you want a more prominent appearance of your RRD data than just lines on a graph. Maybe the current network utilization should be shown on a real network map or the current temperature outside the building should be displayed in big letters. This can be achieved via the SVG binding mode. It takes a SVG image from the media library and processes it to insert values from the RRD. | ||
=== Preparing the SVG file === | === Preparing the SVG file === | ||
+ | |||
SVG files are XML documents. They contain XML tags specifying what the web-browser should draw on the screen. One tool to easily create SVG files is [[https:// | SVG files are XML documents. They contain XML tags specifying what the web-browser should draw on the screen. One tool to easily create SVG files is [[https:// | ||
Line 235: | Line 256: | ||
=== Binding the data === | === Binding the data === | ||
+ | |||
Recipes for binding RRD data look almost the same as normal recipes for RRD graphs. The SVG binding mode is enabled by specifying the '' | Recipes for binding RRD data look almost the same as normal recipes for RRD graphs. The SVG binding mode is enabled by specifying the '' | ||
Line 274: | Line 296: | ||
==== Configuration options ==== | ==== Configuration options ==== | ||
+ | |||
This plugin has two configuration options. | This plugin has two configuration options. | ||
=== RRD image cache timeout === | === RRD image cache timeout === | ||
+ | |||
The timeout of the internal cache. As long as this time has not elapsed the graph is not generated again and the image from the cache is used. This value is set in seconds. | The timeout of the internal cache. As long as this time has not elapsed the graph is not generated again and the image from the cache is used. This value is set in seconds. | ||
=== Check ACL for included RRD templates === | === Check ACL for included RRD templates === | ||
+ | |||
If a template is included by using the '' | If a template is included by using the '' | ||
Line 287: | Line 312: | ||
=== Virtual namespace for RRD graphs === | === Virtual namespace for RRD graphs === | ||
+ | |||
This sets up the virtual namespace that is used for the generated graphs. This media namespace is not visible within the media manager. | This sets up the virtual namespace that is used for the generated graphs. This media namespace is not visible within the media manager. | ||
Line 294: | Line 320: | ||
===== Change Log ===== | ===== Change Log ===== | ||
+ | |||
* **2014-12-10** Release 1 | * **2014-12-10** Release 1 | ||
* Initial Release | * Initial Release | ||
Line 307: | Line 334: | ||
* Using a configurable media namespace for image rendering. This solves problems with initializing DokuWiki from within graph.php on some installations. | * Using a configurable media namespace for image rendering. This solves problems with initializing DokuWiki from within graph.php on some installations. | ||
* Show a nice error message if GD or rrdgraph are missing. | * Show a nice error message if GD or rrdgraph are missing. | ||
- | + | * **2017-06-21** Release 6 | |
+ | * Litte bug-fix to make rrdgraph compatible with PHP 7 (again). | ||
+ | * **2017-06-21** Release 7 | ||
+ | * Minor bug-fix: If the drop down menu is used for range switching instead of the tabs (on small screens) this only works one time and then goes completely haywire. | ||
+ | * **2019-01-12** Release 8 | ||
+ | * Minor bug-fix: Missing quotes on string constant. | ||
+ | * Converted all line endings to LF. | ||
+ | |||
+ | | ||
===== FAQ ===== | ===== FAQ ===== | ||
+ | |||
No FAQ yet. | No FAQ yet. |
plugin/rrdgraph.1472385251.txt.gz · Last modified: 2016-08-28 13:54 by LarsDW223