summaryrefslogtreecommitdiff
path: root/doc/rrdtool.txt
blob: 1ad5543a20ff8ff47608bd1596978704a31149d0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
=======
rrdtool
=======

-------------------
Module: mod_rrdtool
-------------------

:Author: Jan Kneschke
:Date: $Date: 2004/08/29 09:43:49 $
:Revision: $Revision: 1.1 $

:abstract:
  mod_rrdtool is used to monitor the traffic and load on the webserver

.. meta::
  :keywords: lighttpd, skeleton

.. contents:: Table of Contents

Description
===========

RRD_ is a system to store and display time-series data (i.e. network
bandwidth, machine-room temperature, server load average).

.. _RRD: http://people.ee.ethz.ch/~oetiker/webtools/rrdtool/

Options
=======

rrdtool.binary
  path to the rrdtool binary

  e.g.: ::

    rrdtool.binary = "/usr/bin/rrdtool"

rrdtool.db-name
  filename of the rrd-database. Make sure that <rrdtool.db-name> doesn't exist
  before the first run, as lighttpd has to create the DB for you.

  e.g.: ::

    rrdtool.db-name = "/var/www/lighttpd.rrd"

Generating Graphs
=================

::

  #!/bin/sh

  RRDTOOL=/usr/bin/rrdtool
  OUTDIR=/var/www/servers/www.example.org/pages/rrd/
  INFILE=/var/www/lighttpd.rrd
  OUTPRE=lighttpd-traffic

  DISP="-v bytes --title TrafficWebserver \
          DEF:binraw=$INFILE:InOctets:AVERAGE \
          DEF:binmaxraw=$INFILE:InOctets:MAX \
          DEF:binminraw=$INFILE:InOctets:MIN \
          DEF:bout=$INFILE:OutOctets:AVERAGE \
          DEF:boutmax=$INFILE:OutOctets:MAX \
          DEF:boutmin=$INFILE:OutOctets:MIN \
          CDEF:bin=binraw,-1,* \
          CDEF:binmax=binmaxraw,-1,* \
          CDEF:binmin=binminraw,-1,* \
          CDEF:binminmax=binmaxraw,binminraw,- \
          CDEF:boutminmax=boutmax,boutmin,- \
          AREA:binmin#ffffff: \
          STACK:binmax#f00000: \
          LINE1:binmin#a0a0a0: \
          LINE1:binmax#a0a0a0: \
          LINE2:bin#a0a735:incoming \
          GPRINT:bin:MIN:%.2lf \
          GPRINT:bin:AVERAGE:%.2lf \
          GPRINT:bin:MAX:%.2lf \
          AREA:boutmin#ffffff: \
          STACK:boutminmax#00f000: \
          LINE1:boutmin#a0a0a0: \
          LINE1:boutmax#a0a0a0: \
          LINE2:bout#a0a735:outgoing \
          GPRINT:bout:MIN:%.2lf \
          GPRINT:bout:AVERAGE:%.2lf \
          GPRINT:bout:MAX:%.2lf \
          "


  $RRDTOOL graph $OUTDIR/$OUTPRE-hour.png -a PNG --start -14400 $DISP
  $RRDTOOL graph $OUTDIR/$OUTPRE-day.png -a PNG --start -86400 $DISP
  $RRDTOOL graph $OUTDIR/$OUTPRE-month.png -a PNG --start -2592000 $DISP

  OUTPRE=lighttpd-requests

  DISP="-v req --title RequestsperSecond -u 1 \
          DEF:req=$INFILE:Requests:AVERAGE \
          DEF:reqmax=$INFILE:Requests:MAX \
          DEF:reqmin=$INFILE:Requests:MIN \
          CDEF:reqminmax=reqmax,reqmin,- \
          AREA:reqmin#ffffff: \
          STACK:reqminmax#0e0e0e: \
          LINE1:reqmin#a0a0a0: \
          LINE1:reqmax#a0a0a0: \
          LINE2:req#00a735:requests"


  $RRDTOOL graph $OUTDIR/$OUTPRE-hour.png -a PNG --start -14400 $DISP
  $RRDTOOL graph $OUTDIR/$OUTPRE-day.png -a PNG --start -86400 $DISP
  $RRDTOOL graph $OUTDIR/$OUTPRE-month.png -a PNG --start -2592000 $DISP