X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=src%2Fcollectd.conf.pod;h=8dd53caf07ab687d9efc605d82b5de7dfe5ce20f;hb=cc5ee53dfba55d6fe7c26513618a582adf80b7fa;hp=48b75bc82f9cfa6a32e263c950dc108bbd67c915;hpb=04b395325b152a5ddf424d1a750f455a2f8229fb;p=collectd.git
diff --git a/src/collectd.conf.pod b/src/collectd.conf.pod
index 48b75bc8..8dd53caf 100644
--- a/src/collectd.conf.pod
+++ b/src/collectd.conf.pod
@@ -454,7 +454,7 @@ finance page and dispatch the value to collectd.
Regex "]*> *([0-9]*\\.[0-9]+) *"
DSType "GaugeAverage"
- # Note: `stock_value' is not a standard type.
+ # Note: `stock_value' is not a standard type.
Type "stock_value"
Instance "AMD"
@@ -606,6 +606,9 @@ like this:
use a more strict database server, you may have to select from a dummy table or
something.)
+Please note that some databases, for example B, will fail if you
+include a semicolon at the end of the statement.
+
=item B I
=item B I
@@ -959,6 +962,88 @@ Controls whether or not to recurse into subdirectories. Enabled by default.
=back
+=head2 Plugin C
+
+The I plugin received the multicast traffic sent by B, the
+statistics collection daemon of Ganglia. Mappings for the standard "metrics"
+are built-in, custom mappings may be added via B blocks, see below.
+
+Synopsis:
+
+
+ MCReceiveFrom "239.2.11.71" "8649"
+
+ Type "swap"
+ TypeInstance "total"
+ DataSource "value"
+
+
+ Type "swap"
+ TypeInstance "free"
+ DataSource "value"
+
+
+
+The following metrics are built-in:
+
+=over 4
+
+=item *
+
+load_one, load_five, load_fifteen
+
+=item *
+
+cpu_user, cpu_system, cpu_idle, cpu_nice, cpu_wio
+
+=item *
+
+mem_free, mem_shared, mem_buffers, mem_cached, mem_total
+
+=item *
+
+bytes_in, bytes_out
+
+=item *
+
+pkts_in, pkts_out
+
+=back
+
+Available configuration options:
+
+=over 4
+
+=item B I [I]
+
+Sets sets the multicast group and UDP port to which to subscribe.
+
+Default: B<239.2.11.71>E/EB<8649>
+
+=item EB IE
+
+These blocks add a new metric conversion to the internal table. I, the
+string argument to the B block, is the metric name as used by Ganglia.
+
+=over 4
+
+=item B I
+
+Type to map this metric to. Required.
+
+=item B I
+
+Type-instance to use. Optional.
+
+=item B I
+
+Data source to map this metric to. If the configured type has exactly one data
+source, this is optional. Otherwise the option is required.
+
+=back
+
+=back
+
=head2 Plugin C
To get values from B collectd connects to B (127.0.0.1),
@@ -1085,6 +1170,11 @@ and all other interrupts are collected.
=head2 Plugin C
+The I plugin makes it possible to write extensions for collectd in Java.
+This section only discusses the syntax and semantic of the configuration
+options. For more in-depth information on the I plugin, please read
+L.
+
Synopsis:
@@ -1096,7 +1186,7 @@ Synopsis:
-Available config options:
+Available configuration options:
=over 4
@@ -1106,40 +1196,32 @@ Argument that is to be passed to the I (JVM). This works
exactly the way the arguments to the I binary on the command line work.
Execute C--help> for details.
-=item B I
-
-Instantiates a new I object. The following methods of this class are
-used when available:
-
-=over 4
-
-=item *
-
-public int B (org.collectd.api.OConfigItem ci)
-
-=item *
-
-public int B ()
+Please note that B these options must appear B (i.Ee. above)
+any other options! When another option is found, the JVM will be started and
+later options will have to be ignored!
-=item *
-
-public int B ()
-
-=item *
-
-public int B (org.collectd.protocol.ValueList vl)
+=item B I
-=item *
+Instantiates a new I object. The constructor of this object very
+likely then registers one or more callback methods with the server.
-public int B ()
+See L for details.
-=back
+When the first such option is found, the virtual machine (JVM) is created. This
+means that all B options must appear before (i.Ee. above) all
+B options!
-=item B I
+=item B I
-The entrie block is passed to the Java plugin as an
+The entire block is passed to the Java plugin as an
I object.
+For this to work, the plugin has to register a configuration callback first,
+see L. This means, that the B block
+must appear after the appropriate B block. Also note, that I
+depends on the (Java) plugin registering the callback and is completely
+independent from the I argument passed to B.
+
=back
=head2 Plugin C
@@ -1797,6 +1879,13 @@ to collectd's plugin system. See L for its documentation.
=head2 Plugin C
+The I plugin starts a new thread which sends ICMP "ping" packets to the
+configured hosts periodically and measures the network latency. Whenever the
+C function of the plugin is called, it submits the average latency, the
+standard deviation and the drop rate for each host.
+
+Available configuration options:
+
=over 4
=item B I
@@ -1804,6 +1893,26 @@ to collectd's plugin system. See L for its documentation.
Host to ping periodically. This option may be repeated several times to ping
multiple hosts.
+=item B I
+
+Sets the interval in which to send ICMP echo packets to the configured hosts.
+This is B the interval in which statistics are queries from the plugin but
+the interval in which the hosts are "pinged". Therefore, the setting here
+should be smaller than or equal to the global B setting. Fractional
+times, such as "1.24" are allowed.
+
+Default: B<1.0>
+
+=item B I
+
+Time to wait for a response from the host to which an ICMP packet had been
+sent. If a reply was not received after I seconds, the host is assumed
+to be down or the packet to be dropped. This setting must be smaller than the
+B setting above for the plugin to work correctly. Fractional
+arguments are accepted.
+
+Default: B<0.9>
+
=item B I<0-255>
Sets the Time-To-Live of generated ICMP packets.
@@ -2290,6 +2399,39 @@ slashes.
=back
+=head2 Plugin C
+
+Collects a lot of information about various network protocols, such as I,
+I, I, etc.
+
+Available configuration options:
+
+=over 4
+
+=item B I
+
+Selects whether or not to select a specific value. The string being matched is
+of the form "I:I", where I will be used as the
+plugin instance and I will be used as type instance. An example of
+the string being used would be C.
+
+You can use regular expressions to match a large number of values with just one
+configuration option. To select all "extended" I values, you could use the
+following statement:
+
+ Value "/^TcpExt:/"
+
+Whether only matched values are selected or all matched values are ignored
+depends on the B. By default, only matched values are selected.
+If no value is configured at all, all values will be selected.
+
+=item B B|B
+
+If set to B, inverts the selection made by B, i.Ee. all
+matching values will be ignored.
+
+=back
+
=head2 Plugin C
The C plugin uses the RRDTool accelerator daemon, L,