Code

Merged branch 'experimental' into debmon-squeeze.
[pkg-collectd.git] / debian / collectd.conf
index 2efd8eb4dfb74b7dcaf44a265fe58fbc7045a5f3..43a76fa819dbd56f3885345cdef99d95ef5bebb6 100644 (file)
@@ -6,15 +6,38 @@
 # You should also read /usr/share/doc/collectd-core/README.Debian.plugins
 # before enabling any more plugins.
 
+##############################################################################
+# Global                                                                     #
+#----------------------------------------------------------------------------#
+# Global settings for the daemon.                                            #
+##############################################################################
+
 #Hostname "localhost"
 FQDNLookup true
 #BaseDir "/var/lib/collectd"
 #PluginDir "/usr/lib/collectd"
 #TypesDB "/usr/share/collectd/types.db" "/etc/collectd/my_types.db"
+
+#----------------------------------------------------------------------------#
+# Interval at which to query values. This may be overwritten on a per-plugin #
+# base by using the 'Interval' option of the LoadPlugin block:               #
+#   <LoadPlugin foo>                                                         #
+#       Interval 60                                                          #
+#   </LoadPlugin>                                                            #
+#----------------------------------------------------------------------------#
 #Interval 10
+
 #Timeout 2
 #ReadThreads 5
 
+##############################################################################
+# Logging                                                                    #
+#----------------------------------------------------------------------------#
+# Plugins which provide logging functions should be loaded first, so log     #
+# messages generated when loading or configuring other plugins can be        #
+# accessed.                                                                  #
+##############################################################################
+
 #LoadPlugin logfile
 LoadPlugin syslog
 
@@ -29,6 +52,13 @@ LoadPlugin syslog
        LogLevel info
 </Plugin>
 
+##############################################################################
+# LoadPlugin section                                                         #
+#----------------------------------------------------------------------------#
+# Specify what features to activate.                                         #
+##############################################################################
+
+#LoadPlugin aggregation
 #LoadPlugin apache
 #LoadPlugin apcups
 #LoadPlugin ascent
@@ -118,6 +148,33 @@ LoadPlugin users
 #LoadPlugin write_http
 #LoadPlugin write_mongodb
 
+##############################################################################
+# Plugin configuration                                                       #
+#----------------------------------------------------------------------------#
+# In this section configuration stubs for each plugin are provided. A desc-  #
+# ription of those options is available in the collectd.conf(5) manual page. #
+##############################################################################
+
+#<Plugin "aggregation">
+#      <Aggregation>
+#              #Host "unspecified"
+#              Plugin "cpu"
+#              #PluginInstance "unspecified"
+#              Type "cpu"
+#              #TypeInstance "unspecified"
+#
+#              GroupBy "Host"
+#              GroupBy "TypeInstance"
+#
+#              CalculateNum false
+#              CalculateSum false
+#              CalculateAverage true
+#              CalculateMinimum false
+#              CalculateMaximum false
+#              CalculateStddev false
+#      </Aggregation>
+#</Plugin>
+
 #<Plugin apache>
 #      <Instance "foo">
 #              URL "http://localhost/server-status?auto"
@@ -270,16 +327,29 @@ LoadPlugin users
 #      </Database>
 #</Plugin>
 
-#<Plugin df>
+<Plugin df>
 #      Device "/dev/sda1"
 #      Device "192.168.0.2:/mnt/nfs"
 #      MountPoint "/home"
 #      FSType "ext3"
-#      IgnoreSelected false
+
+       # ignore rootfs; else, the root file-system would appear twice, causing
+       # one of the updates to fail and spam the log
+       FSType rootfs
+       # ignore the usual virtual / temporary file-systems
+       FSType sysfs
+       FSType proc
+       FSType devtmpfs
+       FSType devpts
+       FSType tmpfs
+       FSType fusectl
+       FSType cgroup
+       IgnoreSelected true
+
 #      ReportByDevice false
 #      ReportReserved false
 #      ReportInodes false
-#</Plugin>
+</Plugin>
 
 #<Plugin disk>
 #      Disk "hda"
@@ -428,10 +498,12 @@ LoadPlugin users
 #</Plugin>
 
 #<Plugin memcached>
-#      Socket "/var/run/memcached.sock"
+#      <Instance "local">
+#              Socket "/var/run/memcached.sock"
 # or:
-#      Host "127.0.0.1"
-#      Port "11211"
+#              Host "127.0.0.1"
+#              Port "11211"
+#      </Instance>
 #</Plugin>
 
 #<Plugin mysql>
@@ -523,6 +595,7 @@ LoadPlugin users
 #      Host "localhost"
 #      Port 123
 #      ReverseLookups false
+#      IncludeUnitID true
 #</Plugin>
 
 #<Plugin nut>
@@ -607,6 +680,12 @@ LoadPlugin users
 #              </Result>
 #      </Query>
 #
+#      <Writer sqlstore>
+#              # See /usr/share/doc/collectd-core/examples/postgresql/collectd_insert.sql for details
+#              Statement "SELECT collectd_insert($1, $2, $3, $4, $5, $6, $7, $8, $9);"
+#              StoreRates true
+#      </Writer>
+#
 #      <Database foo>
 #              Host "hostname"
 #              Port 5432
@@ -626,6 +705,13 @@ LoadPlugin users
 #              Query backend # predefined
 #              Query rt36_tickets
 #      </Database>
+#
+#      <Database qux>
+#              Service "collectd_store"
+#              Writer sqlstore
+#              # see collectd.conf(5) for details
+#              CommitInterval 30
+#      </Database>
 #</Plugin>
 
 #<Plugin powerdns>
@@ -668,6 +754,14 @@ LoadPlugin users
 #      DataDir "/var/lib/rrdcached/db/collectd"
 #      CreateFiles true
 #      CollectStatistics true
+#
+# The following settings are rather advanced
+# and should usually not be touched:
+#      StepSize 10
+#      HeartBeat 20
+#      RRARows 1200
+#      RRATimespan 158112000
+#      XFF 0.1
 #</Plugin>
 
 <Plugin rrdtool>
@@ -743,6 +837,7 @@ LoadPlugin users
 
 #<Plugin swap>
 #      ReportByDevice false
+#      ReportBytes true
 #</Plugin>
 
 #<Plugin table>