Read events from the collectd binary protocol over the network via udp. See https://collectd.org/wiki/index.php/Binary_protocol
Configuration in your Logstash configuration file can be as simple as:
input { udp { port => 28526 buffer_size => 1452 codec => collectd { } } }
A sample collectd.conf
to send to Logstash might be:
Hostname "host.example.com" LoadPlugin interface LoadPlugin load LoadPlugin memory LoadPlugin network <Plugin interface> Interface "eth0" IgnoreSelected false </Plugin> <Plugin network> <Server "10.0.0.1" "25826"> </Server> </Plugin>
Be sure to replace 10.0.0.1
with the IP of your Logstash instance.
This plugin supports the following configuration options:
Required configuration options:
collectd { }
Available configuration options:
- Value type is string
- There is no default value for this setting.
Path to the authentication file. This file should have the same format as
the AuthFile
in collectd. You only need to set this option if the security_level
is set to
Sign
or Encrypt
-
Value can be any of:
change_value
,warn
,drop
-
Default value is
"change_value"
What to do when a value in the event is NaN
(Not a Number)
-
change_value (default): Change the
NaN
to the value of the nan_value option and addnan_tag
as a tag -
warn: Change the
NaN
to the value of the nan_value option, print a warning to the log and addnan_tag
as a tag -
drop: Drop the event containing the
NaN
(this only drops the single event, not the whole packet)
- Value type is string
-
Default value is
"_collectdNaN"
The tag to add to the event if a ‘NaN` value was found Set this to an empty string (’') if you don’t want to tag
- Value type is number
-
Default value is
0
Only relevant when nan_handeling
is set to change_value
Change NaN to this configured value
- Value type is boolean
-
Default value is
true
Prune interval records. Defaults to true
.
-
Value can be any of:
None
,Sign
,Encrypt
-
Default value is
"None"
Security Level. Default is None
. This setting mirrors the setting from the
collectd Network plugin
- Value type is array
- There is no default value for this setting.
File path(s) to collectd types.db
to use.
The last matching pattern wins if you have identical pattern names in multiple files.
If no types.db is provided the included types.db
will be used (currently 5.4.0).