---
title: Collectd codec plugin v3.1.0
description: Plugin version: v3.1.0, Released on: 2021-08-04, Changelog. For other versions, see the overview list. To learn more about Logstash, see the Logstash...
url: https://www.elastic.co/docs/reference/logstash/versioned-plugins/v3-1-0-plugins-codecs-collectd
products:
- Logstash
applies_to:
- Elastic Stack: Generally available
---
# Collectd codec plugin v3.1.0
- Plugin version: v3.1.0
- Released on: 2021-08-04
- [Changelog](https://github.com/logstash-plugins/logstash-codec-collectd/blob/v3.1.0/CHANGELOG.md)
For other versions, see the [overview list](https://www.elastic.co/docs/reference/logstash/versioned-plugins/codec-collectd-index).
To learn more about Logstash, see the [Logstash Reference](https://www.elastic.co/guide/en/logstash/current/index.html).
## Getting help
For questions about the plugin, open a topic in the [Discuss](http://discuss.elastic.co) forums. For bugs or feature requests, open an issue in [Github](https://github.com/logstash-plugins/logstash-codec-collectd). For the list of Elastic supported plugins, please consult the [Elastic Support Matrix](https://www.elastic.co/support/matrix#matrix_logstash_plugins).
## Description
Read events from the collectd binary protocol over the network via udp. See
Configuration in your Logstash configuration file can be as simple as:
```
input {
udp {
port => 25826
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
Interface "eth0"
IgnoreSelected false
Server "10.0.0.1" "25826"
```
Be sure to replace `10.0.0.1` with the IP of your Logstash instance.
## Collectd Codec configuration options
| Setting | Input type | Required |
|----------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------|----------|
| [`authfile`](#v3.1.0-plugins-codecs-collectd-authfile) | [string](/docs/reference/logstash/plugins/value-types#string) | No |
| [`nan_handling`](#v3.1.0-plugins-codecs-collectd-nan_handling) | [string](/docs/reference/logstash/plugins/value-types#string), one of `["change_value", "warn", "drop"]` | No |
| [`nan_tag`](#v3.1.0-plugins-codecs-collectd-nan_tag) | [string](/docs/reference/logstash/plugins/value-types#string) | No |
| [`nan_value`](#v3.1.0-plugins-codecs-collectd-nan_value) | [number](/docs/reference/logstash/plugins/value-types#number) | No |
| [`prune_intervals`](#v3.1.0-plugins-codecs-collectd-prune_intervals) | [boolean](/docs/reference/logstash/plugins/value-types#boolean) | No |
| [`security_level`](#v3.1.0-plugins-codecs-collectd-security_level) | [string](/docs/reference/logstash/plugins/value-types#string), one of `["None", "Sign", "Encrypt"]` | No |
| [`target`](#v3.1.0-plugins-codecs-collectd-target) | [string](/docs/reference/logstash/plugins/value-types#string) | No |
| [`typesdb`](#v3.1.0-plugins-codecs-collectd-typesdb) | [array](/docs/reference/logstash/plugins/value-types#array) | No |
### `authfile`
- Value type is [string](/docs/reference/logstash/plugins/value-types#string)
- There is no default value for this setting.
Path to the authentication file. This file should have the same format as the [AuthFile](http://collectd.org/documentation/manpages/collectd.conf.5.shtml#authfile_filename) in collectd. You only need to set this option if the `security_level` is set to `Sign` or `Encrypt`
### `nan_handling`
- 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 add `nan_tag` as a tag
- warn: Change the `NaN` to the value of the nan_value option, print a warning to the log and add `nan_tag` as a tag
- drop: Drop the event containing the `NaN` (this only drops the single event, not the whole packet)
### `nan_tag`
- Value type is [string](/docs/reference/logstash/plugins/value-types#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
### `nan_value`
- Value type is [number](/docs/reference/logstash/plugins/value-types#number)
- Default value is `0`
Only relevant when `nan_handeling` is set to `change_value` Change NaN to this configured value
### `prune_intervals`
- Value type is [boolean](/docs/reference/logstash/plugins/value-types#boolean)
- Default value is `true`
Prune interval records. Defaults to `true`.
### `security_level`
- 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](https://collectd.org/wiki/index.php/Plugin:Network)
### `target`
- Value type is [string](/docs/reference/logstash/plugins/value-types#string)
- There is no default value for this setting.
Define the target field for placing the decoded values. If this setting is not set, data will be stored at the root (top level) of the event.
For example, if you want data to be put under the `document` field:
```
input {
udp {
port => 12345
codec => collectd {
target => "[document]"
}
}
}
```
### `typesdb`
- Value type is [array](/docs/reference/logstash/plugins/value-types#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).