62 lines
2 KiB
Markdown
62 lines
2 KiB
Markdown
# Socket Writer Output Plugin
|
|
|
|
This plugin writes metrics to a network service e.g. via UDP or TCP in one of
|
|
the supported [data formats][data_formats].
|
|
|
|
⭐ Telegraf v1.3.0
|
|
🏷️ applications, network
|
|
💻 all
|
|
|
|
[data_formats]: /docs/DATA_FORMATS_OUTPUT.md
|
|
|
|
## Global configuration options <!-- @/docs/includes/plugin_config.md -->
|
|
|
|
In addition to the plugin-specific configuration settings, plugins support
|
|
additional global and plugin configuration settings. These settings are used to
|
|
modify metrics, tags, and field or create aliases and configure ordering, etc.
|
|
See the [CONFIGURATION.md][CONFIGURATION.md] for more details.
|
|
|
|
[CONFIGURATION.md]: ../../../docs/CONFIGURATION.md#plugins
|
|
|
|
## Configuration
|
|
|
|
```toml @sample.conf
|
|
# Generic socket writer capable of handling multiple socket types.
|
|
[[outputs.socket_writer]]
|
|
## URL to connect to
|
|
# address = "tcp://127.0.0.1:8094"
|
|
# address = "tcp://example.com:http"
|
|
# address = "tcp4://127.0.0.1:8094"
|
|
# address = "tcp6://127.0.0.1:8094"
|
|
# address = "tcp6://[2001:db8::1]:8094"
|
|
# address = "udp://127.0.0.1:8094"
|
|
# address = "udp4://127.0.0.1:8094"
|
|
# address = "udp6://127.0.0.1:8094"
|
|
# address = "unix:///tmp/telegraf.sock"
|
|
# address = "unixgram:///tmp/telegraf.sock"
|
|
# address = "vsock://cid:port"
|
|
|
|
## 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
|
|
|
|
## Period between keep alive probes.
|
|
## Only applies to TCP sockets.
|
|
## 0 disables keep alive probes.
|
|
## Defaults to the OS configuration.
|
|
# keep_alive_period = "5m"
|
|
|
|
## Content encoding for message payloads, can be set to "gzip" or to
|
|
## "identity" to apply no encoding.
|
|
##
|
|
# content_encoding = "identity"
|
|
|
|
## Data format to generate.
|
|
## Each data format has its own unique set of configuration options, read
|
|
## more about them here:
|
|
## https://github.com/influxdata/telegraf/blob/master/docs/DATA_FORMATS_OUTPUT.md
|
|
# data_format = "influx"
|
|
```
|