Code

collectd.conf(5): Add documentation for the write_riemann plugin.
authorFlorian Forster <octo@collectd.org>
Thu, 17 Jan 2013 13:07:12 +0000 (14:07 +0100)
committerFlorian Forster <octo@collectd.org>
Thu, 17 Jan 2013 13:07:12 +0000 (14:07 +0100)
src/collectd.conf.in
src/collectd.conf.pod
src/write_riemann.c

index 0b5323cc9d1ee2123ed574b6cd4ae09e67ad959b..d2cf950ba95e12a96c22bdd74b9b5ab9f9a18c68 100644 (file)
 #      <Node "example">
 #              Host "localhost">
 #              Port 5555
-#              StoreRates false
-#              Delay 2
+#              StoreRates true
+#              Delay 1
 #      </Node>
 #      Tag "foobar"
 #</Plugin>
index b9f9549d223c1a0548609db6fd3dbac2a1067985..904f18624f8834eece0597f61fa165fa2523a2d2 100644 (file)
@@ -5511,6 +5511,69 @@ number.
 
 =back
 
+=head2 Plugin C<write_riemann>
+
+The I<write_riemann plugin> will send values to I<Riemann>, a powerfull stream
+aggregation and monitoring system. The plugin sends I<Protobuf> encoded data to
+I<Riemann> using UDP packets.
+
+Synopsis:
+
+ <Plugin "write_riemann">
+   <Node "example">
+     Host "localhost"
+     Port "5555"
+     StoreRates false
+     Delay 10
+   </Node>
+   Tag "foobar"
+ </Plugin>
+
+The following options are understood by the I<write_riemann plugin>:
+
+=over 4
+
+=item E<lt>B<Node> I<Name>E<gt>
+
+The plugin's configuration consists of one or more B<Node> blocks. Each block
+is given a unique I<Name> and specifies one connection to an instance of
+I<Riemann>. Indise the B<Node> block, the following per-connection options are
+understood:
+
+=over 4
+
+=item B<Host> I<Address>
+
+Hostname or address to connect to. Defaults to C<localhost>.
+
+=item B<Port> I<Service>
+
+Service name or port number to connect to. Defaults to C<5555>.
+
+=item B<Delay> I<Seconds>
+
+Time (in seconds) that is added to each I<data set's> interval when calculating
+the I<time to live> (TTL) of the metric to be sent to I<Riemann>. Defaults to
+B<1>.
+
+=item B<StoreRates> B<false>|B<true>
+
+If set to B<true> (the default), convert counter values to rates. If set to
+B<false> counter values are stored as is, i.e. as an increasing integer number.
+
+This will be reflected in the C<ds_type> tag: If B<StoreRates> is enabled,
+converted values will have "rate" appended to the data source type, e.g.
+C<ds_type:derive:rate>.
+
+=back
+
+=item B<Tag> I<String>
+
+Add the given string as an additional tag to the metric being sent to
+I<Riemann>.
+
+=back
+
 =head1 THRESHOLD CONFIGURATION
 
 Starting with version C<4.3.0> collectd has support for B<monitoring>. By that
index 1f48f74763fdf4ebc660e0dd4b98d8831d4e4117..d2d54c9189964e6445d48eff0e792f8d6ca684c8 100644 (file)
@@ -554,6 +554,7 @@ riemann_config_node(oconfig_item_t *ci)
        host->node = NULL;
        host->service = NULL;
        host->delay = RIEMANN_DELAY;
+       host->store_rates = 1;
 
        status = cf_util_get_string (ci, &host->name);
        if (status != 0) {