summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/Makefile.am4
-rw-r--r--doc/traffic-example.conf44
2 files changed, 47 insertions, 1 deletions
diff --git a/doc/Makefile.am b/doc/Makefile.am
index 2cb19ea..f9ceec0 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -9,4 +9,6 @@ html:
perl man2html.pl rrdbot-get.1 > rrdbot-get.1.html
EXTRA_DIST = $(man_MANS) \
- man2html.pl
+ man2html.pl \
+ traffic-example.conf
+
diff --git a/doc/traffic-example.conf b/doc/traffic-example.conf
new file mode 100644
index 0000000..aea1b0d
--- /dev/null
+++ b/doc/traffic-example.conf
@@ -0,0 +1,44 @@
+
+# Monitors traffic on a gateway or router
+# This is a sample rrdbotd configuration file. See:
+# man rrdbot.conf
+
+[general]
+rrd: /var/db/rrds/traffic.rrd
+
+
+# These settings are used by rrdbotd --------------------------------------
+[poll]
+
+# The two fields to store in the RRD: 'in' and 'out'. The
+# interface number (at the end of the OID) may vary from
+# router to router. In this example the SNMP community is
+# 'public'
+in.source: snmp://public@router.example.com/ifInOctets.2
+out.source: snmp://public@router.example.com/ifOutOctets.2
+
+# Poll every 10 seconds
+interval: 10
+
+
+
+# These settings are used by rrdbot-create --------------------------------
+[create]
+
+# Counters are values that continually increase
+in.type: COUNTER
+in.min: 0
+out.type: COUNTER
+out.min: 0
+
+# The consolidation function for the RRD
+cf: AVERAGE
+
+# Archives sets of values to keep.
+# 6 per minute for 2 days
+# 30 per hour for 1 month
+# 2 per hour for 1 year
+archive: 6/minute * 2 days,
+ 30/hour * 1 month,
+ 2/hour * 1 year
+