Skip to main content

Network statistics

Plugin: proc.plugin Module: /proc/net/netstat

Overview​

Monitor host-wide IP, TCP, UDP, ICMP, broadcast, multicast, fragmentation, and ECN activity from Linux kernel protocol counters.

This collector is only supported on the following platforms:

  • linux

This collector only supports collecting metrics from a single instance of this integration.

Default Behavior​

Auto-Detection​

No instance discovery is required. The module runs by default, and its chart-family options default to auto, creating the applicable charts when their proc sources are available without waiting for a non-zero sample.

Limits​

The default configuration for this integration does not impose any limits on data collection.

Performance Impact​

The default configuration for this integration is not expected to impose a significant performance impact on the system.

Setup​

Prerequisites​

No action required.

Configuration​

Options​

Use the [plugin:proc:/proc/net/netstat], [plugin:proc:/proc/net/snmp], and [plugin:proc:/proc/net/snmp6] sections to configure these sources. Each section supports filename to monitor; the sections also provide auto, yes, or no switches for their chart families.

via File​

The configuration file name for this integration is netdata.conf.

The file format is a modified INI syntax. The general structure is:

[section1]
    option1 = some value
    option2 = some other value

[section2]
    option3 = some third value

You can edit the configuration file using the edit-config script from the Netdata config directory.

cd /etc/netdata 2>/dev/null || cd /opt/netdata/etc/netdata
sudo ./edit-config netdata.conf
Examples​

There are no configuration examples.

Alerts​

The following alerts are available:

Alert nameOn metricDescription
1m_tcp_syn_queue_drops ip.tcp_syn_queueaverage number of SYN requests was dropped due to the full TCP SYN queue over the last minute (SYN cookies were not enabled)
1m_tcp_syn_queue_cookies ip.tcp_syn_queueaverage number of sent SYN cookies due to the full TCP SYN queue over the last minute
1m_tcp_accept_queue_overflows ip.tcp_accept_queueaverage number of overflows in the TCP accept queue over the last minute
1m_tcp_accept_queue_drops ip.tcp_accept_queueaverage number of dropped packets in the TCP accept queue over the last minute
tcp_connections ip.tcpsockTCP connections utilization
1m_ip_tcp_resets_sent ip.tcphandshakeaverage number of sent TCP RESETS over the last minute
10s_ip_tcp_resets_sent ip.tcphandshakeaverage number of sent TCP RESETS over the last 10 seconds. This can indicate a port scan, or that a service running on this host has crashed. Netdata will not send a clear notification for this alarm.
1m_ip_tcp_resets_received ip.tcphandshakeaverage number of received TCP RESETS over the last minute
10s_ip_tcp_resets_received ip.tcphandshakeaverage number of received TCP RESETS over the last 10 seconds. This can be an indication that a service this host needs has crashed. Netdata will not send a clear notification for this alarm.
1m_ipv4_udp_receive_buffer_errors ipv4.udperrorsaverage number of UDP receive buffer errors over the last minute
1m_ipv4_udp_send_buffer_errors ipv4.udperrorsaverage number of UDP send buffer errors over the last minute

Metrics​

Metrics grouped by scope.

The scope defines the instance that the metric belongs to. An instance is uniquely identified by a set of labels.

Host-wide protocol metrics from /proc/net/netstat, /proc/net/snmp, and /proc/net/snmp6. These complement per-interface traffic, error, drop, and link-state metrics. See Monitoring Network Statistics for explanations of the key metric groups.

Per Network statistics instance​

This scope has no labels.

Metrics:

MetricDescriptionDimensionsUnit
system.ipIPv4 Bandwidthreceived, sentkilobits/s
ip.tcpmemorypressuresTCP Memory Pressurespressuresevents/s
ip.tcpconnabortsTCP Connection Abortsbaddata, userclosed, nomemory, timeout, linger, failedconnections/s
ip.tcpreordersTCP Reordered Packets by Detection Methodtimestamp, sack, fack, renopackets/s
ip.tcpofoTCP Out-Of-Order Queueinqueue, dropped, merged, prunedpackets/s
ip.tcpsyncookiesTCP SYN Cookiesreceived, sent, failedpackets/s
ip.tcp_syn_queueTCP SYN Queue Issuesdrops, cookiespackets/s
ip.tcp_accept_queueTCP Accept Queue Issuesoverflows, dropspackets/s
ip.tcpsockTCP Connectionsconnectionsactive connections
ip.tcppacketsIPv4 TCP Packetsreceived, sentpackets/s
ip.tcperrorsIPv4 TCP ErrorsInErrs, InCsumErrors, RetransSegspackets/s
ip.tcpopensIPv4 TCP Opensactive, passiveconnections/s
ip.tcphandshakeIPv4 TCP Handshake IssuesEstabResets, OutRsts, AttemptFails, SynRetransevents/s
ipv4.packetsIPv4 Packetsreceived, sent, forwarded, deliveredpackets/s
ipv4.errorsIPv4 ErrorsInDiscards, OutDiscards, InNoRoutes, OutNoRoutes, InHdrErrors, InAddrErrors, InUnknownProtos, InTruncatedPkts, InCsumErrorspackets/s
ipv4.bcastIPv4 Broadcast Bandwidthreceived, sentkilobits/s
ipv4.bcastpktsIPv4 Broadcast Packetsreceived, sentpackets/s
ipv4.mcastIP Multicast Bandwidthreceived, sentkilobits/s
ipv4.mcastpktsIPv4 Multicast Packetsreceived, sentpackets/s
ipv4.icmpIPv4 ICMP Packetsreceived, sentpackets/s
ipv4.icmpmsgIPv4 ICMP MessagesInEchoReps, OutEchoReps, InDestUnreachs, OutDestUnreachs, InRedirects, OutRedirects, InEchos, OutEchos, InRouterAdvert, OutRouterAdvert, InRouterSelect, OutRouterSelect, InTimeExcds, OutTimeExcds, InParmProbs, OutParmProbs, InTimestamps, OutTimestamps, InTimestampReps, OutTimestampRepspackets/s
ipv4.icmp_errorsIPv4 ICMP ErrorsInErrors, OutErrors, InCsumErrorspackets/s
ipv4.udppacketsIPv4 UDP Packetsreceived, sentpackets/s
ipv4.udperrorsIPv4 UDP ErrorsRcvbufErrors, SndbufErrors, InErrors, NoPorts, InCsumErrors, IgnoredMultievents/s
ipv4.udpliteIPv4 UDPLite Packetsreceived, sentpackets/s
ipv4.udplite_errorsIPv4 UDPLite ErrorsRcvbufErrors, SndbufErrors, InErrors, NoPorts, InCsumErrors, IgnoredMultipackets/s
ipv4.ecnpktsIPv4 ECN StatisticsCEP, NoECTP, ECTP0, ECTP1packets/s
ipv4.fragsinIPv4 Fragments Reassemblyok, failed, allpackets/s
ipv4.fragsoutIPv4 Fragments Sentok, failed, createdpackets/s
system.ipv6IPv6 Bandwidthreceived, sentkilobits/s
ipv6.packetsIPv6 Packetsreceived, sent, forwarded, deliveredpackets/s
ipv6.errorsIPv6 ErrorsInDiscards, OutDiscards, InHdrErrors, InAddrErrors, InUnknownProtos, InTooBigErrors, InTruncatedPkts, InNoRoutes, OutNoRoutespackets/s
ipv6.bcastIPv6 Broadcast Bandwidthreceived, sentkilobits/s
ipv6.mcastIPv6 Multicast Bandwidthreceived, sentkilobits/s
ipv6.mcastpktsIPv6 Multicast Packetsreceived, sentpackets/s
ipv6.udppacketsIPv6 UDP Packetsreceived, sentpackets/s
ipv6.udperrorsIPv6 UDP ErrorsRcvbufErrors, SndbufErrors, InErrors, NoPorts, InCsumErrors, IgnoredMultievents/s
ipv6.udplitepacketsIPv6 UDPlite Packetsreceived, sentpackets/s
ipv6.udpliteerrorsIPv6 UDP Lite ErrorsRcvbufErrors, SndbufErrors, InErrors, NoPorts, InCsumErrorsevents/s
ipv6.icmpIPv6 ICMP Messagesreceived, sentmessages/s
ipv6.icmpredirIPv6 ICMP Redirectsreceived, sentredirects/s
ipv6.icmperrorsIPv6 ICMP ErrorsInErrors, OutErrors, InCsumErrors, InDestUnreachs, InPktTooBigs, InTimeExcds, InParmProblems, OutDestUnreachs, OutPktTooBigs, OutTimeExcds, OutParmProblemserrors/s
ipv6.icmpechosIPv6 ICMP EchoInEchos, OutEchos, InEchoReplies, OutEchoRepliesmessages/s
ipv6.groupmembIPv6 ICMP Group MembershipInQueries, OutQueries, InResponses, OutResponses, InReductions, OutReductionsmessages/s
ipv6.icmprouterIPv6 Router MessagesInSolicits, OutSolicits, InAdvertisements, OutAdvertisementsmessages/s
ipv6.icmpneighborIPv6 Neighbor MessagesInSolicits, OutSolicits, InAdvertisements, OutAdvertisementsmessages/s
ipv6.icmpmldv2IPv6 ICMP MLDv2 Reportsreceived, sentreports/s
ipv6.icmptypesIPv6 ICMP TypesInType1, InType128, InType129, InType136, OutType1, OutType128, OutType129, OutType133, OutType135, OutType143messages/s
ipv6.ectIPv6 ECT PacketsInNoECTPkts, InECT1Pkts, InECT0Pkts, InCEPktspackets/s
ipv6.fragsinIPv6 Fragments Reassemblyok, failed, timeout, allpackets/s
ipv6.fragsoutIPv6 Fragments Sentok, failed, allpackets/s
Last updated on

Do you have any feedback for this page? If so, you can open a new issue on our netdata/learn repository.