docs-v2/content/telegraf/v1/input-plugins/synproxy/_index.md

description	menu	tags	introduced	os_support	related
Telegraf plugin for collecting metrics from Synproxy	telegraf_v1_ref parent name identifier input_plugins_reference Synproxy input-synproxy	Synproxy input-plugins configuration network	v1.13.0	linux	/telegraf/v1/configure_plugins/ https://github.com/influxdata/telegraf/tree/v1.38.0/plugins/inputs/synproxy/README.md, Synproxy Plugin Source

Synproxy Input Plugin

This plugin gathers metrics about the Linux netfilter's synproxy module used for mitigating SYN attacks.

Introduced in: Telegraf v1.13.0 Tags: network OS support: linux

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

# Get synproxy counter statistics from procfs
# This plugin ONLY supports Linux
[[inputs.synproxy]]
  # no configuration

Troubleshooting

Execute the following CLI command in Linux to test the synproxy counters:

cat /proc/net/stat/synproxy

Metrics

The following synproxy counters are gathered

• synproxy
  • fields:
    • cookie_invalid (uint32, packets, counter) - Invalid cookies
    • cookie_retrans (uint32, packets, counter) - Cookies retransmitted
    • cookie_valid (uint32, packets, counter) - Valid cookies
    • entries (uint32, packets, counter) - Entries
    • syn_received (uint32, packets, counter) - SYN received
    • conn_reopened (uint32, packets, counter) - Connections reopened

Example Output

This section shows example output in Line Protocol format.

synproxy,host=Filter-GW01,rack=filter-node1 conn_reopened=0i,cookie_invalid=235i,cookie_retrans=0i,cookie_valid=8814i,entries=0i,syn_received=8742i 1549550634000000000