README
¶
Graylog Output Plugin
This plugin writes metrics to a Graylog instance using the GELF data format.
⭐ Telegraf v1.0.0 🏷️ datastore, logging 💻 all
GELF Fields
The GELF spec spec defines a number of specific fields in a GELF payload. These fields may have specific requirements set by the spec and users of the Graylog plugin need to follow these requirements or metrics may be rejected due to invalid data.
For example, the timestamp field defined in the GELF spec, is required to be a UNIX timestamp. This output plugin will not modify or check the timestamp field if one is present and send it as-is to Graylog. If the field is absent then Telegraf will set the timestamp to the current time.
Any field not defined by the spec will have an underscore (e.g. _) prefixed to
the field name.
Global configuration options
Plugins support additional global and plugin configuration settings for tasks such as modifying metrics, tags, and fields, creating aliases, and configuring plugin ordering. See CONFIGURATION.md for more details.
Configuration
# Send telegraf metrics to graylog
[[outputs.graylog]]
## Endpoints for your graylog instances.
servers = ["udp://127.0.0.1:12201"]
## Connection timeout.
# timeout = "5s"
## The field to use as the GELF short_message, if unset the static string
## "telegraf" will be used.
## example: short_message_field = "message"
# short_message_field = ""
## According to GELF payload specification, additional fields names must be prefixed
## with an underscore. Previous versions did not prefix custom field 'name' with underscore.
## Set to true for backward compatibility.
# name_field_no_prefix = false
## Connection retry options
## Attempt to connect to the endpoints if the initial connection fails.
## If 'false', Telegraf will give up after 3 connection attempt and will
## exit with an error. If set to 'true', the plugin will retry to connect
## to the unconnected endpoints infinitely.
# connection_retry = false
## Time to wait between connection retry attempts.
# connection_retry_wait_time = "15s"
## Optional TLS Config
# tls_ca = "/etc/telegraf/ca.pem"
# tls_cert = "/etc/telegraf/cert.pem"
# tls_key = "/etc/telegraf/key.pem"
## Use TLS but skip chain & host verification
# insecure_skip_verify = false
Server endpoint may be specified without UDP or TCP scheme (eg. "127.0.0.1:12201"). In such case, UDP protocol is assumed. TLS config is ignored for UDP endpoints.
Documentation
¶
Index ¶
- func TCPServer(t *testing.T, wg *sync.WaitGroup, tlsConfig *tls.Config, errs chan error) string
- func TestWriteTCP(t *testing.T)
- func TestWriteTCPRetryStopping(t *testing.T)
- func TestWriteTCPServerDown(t *testing.T)
- func TestWriteTCPServerDownRetry(t *testing.T)
- func TestWriteTCPServerUnavailableOnWrite(t *testing.T)
- func TestWriteTCPServerUnavailableOnWriteRetry(t *testing.T)
- func TestWriteUDP(t *testing.T)
- func TestWriteUDPServerDown(t *testing.T)
- func TestWriteUDPServerDownRetry(t *testing.T)
- func TestWriteUDPServerUnavailableOnWrite(t *testing.T)
- func TestWriteUDPServerUnavailableOnWriteRetry(t *testing.T)
- func UDPServer(t *testing.T, wg *sync.WaitGroup, namefieldnoprefix bool) string
- type GelfObject
- type Graylog
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func TestWriteTCP ¶
func TestWriteTCPServerDown ¶
func TestWriteUDP ¶
func TestWriteUDPServerDown ¶
Types ¶
type GelfObject ¶
type GelfObject map[string]interface{}
type Graylog ¶
type Graylog struct {
Servers []string `toml:"servers"`
ShortMessageField string `toml:"short_message_field"`
NameFieldNoPrefix bool `toml:"name_field_noprefix"`
Timeout config.Duration `toml:"timeout"`
Reconnection bool `toml:"connection_retry"`
ReconnectionTime config.Duration `toml:"connection_retry_wait_time"`
Log telegraf.Logger `toml:"-"`
common_tls.ClientConfig
sync.Mutex
// contains filtered or unexported fields
}
Source Files