History

Joshua Powers 49ac03fa80 docs: add global configuration header (#12107 )		2022-10-26 14:58:36 -05:00
..
README.md	docs: add global configuration header (#12107 )	2022-10-26 14:58:36 -05:00
netstat.go	docs: Remove warning not to remove go:embed (#11797 )	2022-09-13 12:47:58 -05:00
sample.conf	chore(inputs_m-z): migrate sample configs into separate files (#11133 )	2022-05-18 11:31:34 -05:00

README.md

Netstat Input Plugin

This plugin collects TCP connections state and UDP socket counts by using lsof.

Global configuration options

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 for more details.

Configuration

# Read TCP metrics such as established, time wait and sockets counts.
[[inputs.netstat]]
  # no configuration

Metrics

Supported TCP Connection states are follows.

established
syn_sent
syn_recv
fin_wait1
fin_wait2
time_wait
close
close_wait
last_ack
listen
closing
none

TCP Connection State measurements

Meta:

units: counts

Measurement names:

tcp_established
tcp_syn_sent
tcp_syn_recv
tcp_fin_wait1
tcp_fin_wait2
tcp_time_wait
tcp_close
tcp_close_wait
tcp_last_ack
tcp_listen
tcp_closing
tcp_none

If there are no connection on the state, the metric is not counted.

UDP socket counts measurements

Meta:

units: counts

Measurement names:

udp_socket