Supported OS:
The network check collects TCP/IP stats from the host operating system.
The network check is included in the Datadog Agent package, so you don’t need to install anything else on your server.
The Agent enables the network check by default, but if you want to configure the check yourself, edit file network.d/conf.yaml, in the conf.d/ folder at the root of your Agent’s configuration directory.
See the sample network.d/conf.yaml for all available configuration options:
init_config:
instances:
# Network check only supports one configured instance
- collect_connection_state: false # set to true to collect TCP connection state metrics, e.g. SYN_SENT, ESTABLISHED
excluded_interfaces: # the check will collect metrics on all other interfaces
- lo
- lo0
# ignore any network interface matching the given regex:
# excluded_interface_re: eth1.*Restart the Agent to effect any configuration changes.
Run the Agent’s status subcommand and look for network under the Checks section.
|
system.net.bytes_rcvd (gauge) |
The number of bytes received on a device per second. shown as byte |
|
system.net.bytes_sent (gauge) |
The number of bytes sent from a device per second. shown as byte |
|
system.net.packets_in.count (gauge) |
The number of packets of data received by the interface. shown as packet |
|
system.net.packets_in.error (gauge) |
The number of packet receive errors detected by the device driver. shown as error |
|
system.net.packets_out.count (gauge) |
The number of packets of data transmitted by the interface. shown as packet |
|
system.net.packets_out.error (gauge) |
The number of packet transmit errors detected by the device driver. shown as error |
|
system.net.tcp.in_segs (gauge) |
The number of TCP segments received (Linux or Solaris only). shown as segment |
|
system.net.tcp.in_segs.count (count) |
Total number of received TCP segments (Linux or Solaris only). shown as segment |
|
system.net.tcp.out_segs (gauge) |
The number of TCP segments transmitted (Linux or Solaris only). shown as segment |
|
system.net.tcp.out_segs.count (count) |
Total number of transmitted TCP segments (Linux or Solaris only). shown as segment |
|
system.net.tcp.rcv_packs (gauge) |
The number of TCP packets received (BSD only). shown as packet |
|
system.net.tcp.retrans_packs (gauge) |
The number of TCP packets retransmitted (BSD only). shown as packet |
|
system.net.tcp.retrans_segs (gauge) |
The number of TCP segments retransmitted (Linux or Solaris only). shown as segment |
|
system.net.tcp.retrans_segs.count (count) |
Total number of retransmitted TCP segments (Linux or Solaris only). shown as segment |
|
system.net.tcp.sent_packs (gauge) |
The number of TCP packets transmitted (BSD only). shown as packet |
|
system.net.tcp.listen_overflows (gauge) |
The number of times connections have overflowed the accept buffer (Linux only). Available since Agent v5.14.0. |
|
system.net.tcp.listen_overflows.count (count) |
Total number of times connections have overflowed the accept buffer (Linux only). |
|
system.net.tcp.listen_drops (gauge) |
The number of times connections have dropped out of listen (Linux only). Available since Agent v5.14.0. |
|
system.net.tcp.listen_drops.count (count) |
Total number of times connections have dropped out of listen (Linux only). |
|
system.net.tcp.backlog_drops (gauge) |
The number of packets dropped because there wasn't room in the TCP backlog (Linux only). Available since Agent v5.14.0. shown as packet |
|
system.net.tcp.backlog_drops.count (count) |
Total number of packets dropped because there wasn't room in the TCP backlog (Linux only). shown as packet |
|
system.net.tcp.failed_retransmits.count (count) |
Total number of packets that failed to be retransmitted (Linux only). shown as packet |
|
system.net.tcp4.closing (gauge) |
The number of TCP IPv4 closing connections. shown as connection |
|
system.net.tcp4.established (gauge) |
The number of TCP IPv4 established connections. shown as connection |
|
system.net.tcp4.listening (gauge) |
The number of TCP IPv4 listening connections. shown as connection |
|
system.net.tcp4.opening (gauge) |
The number of TCP IPv4 opening connections. shown as connection |
|
system.net.tcp6.closing (gauge) |
The number of TCP IPv6 closing connections. shown as connection |
|
system.net.tcp6.established (gauge) |
The number of TCP IPv6 established connections. shown as connection |
|
system.net.tcp6.listening (gauge) |
The number of TCP IPv6 listening connections. shown as connection |
|
system.net.tcp6.opening (gauge) |
The number of TCP IPv6 opening connections. shown as connection |
|
system.net.udp.in_datagrams (gauge) |
The rate of UDP datagrams delivered to UDP users (Linux only). shown as datagram |
|
system.net.udp.in_datagrams.count (count) |
Total number of UDP datagrams delivered to UDP users (Linux only). shown as datagram |
|
system.net.udp.in_errors (gauge) |
The rate of received UDP datagrams that could not be delivered for reasons other than the lack of an application at the destination port (Linux only). shown as datagram |
|
system.net.udp.in_errors.count (count) |
Total number of received UDP datagrams that could not be delivered for reasons other than the lack of an application at the destination port (Linux only). shown as datagram |
|
system.net.udp.no_ports (gauge) |
The rate of received UDP datagrams for which there was no application at the destination port (Linux only). shown as datagram |
|
system.net.udp.no_ports.count (count) |
Total number of received UDP datagrams for which there was no application at the destination port (Linux only). shown as datagram |
|
system.net.udp.out_datagrams (gauge) |
The rate of UDP datagrams sent from this entity (Linux only). shown as datagram |
|
system.net.udp.out_datagrams.count (count) |
Total number of UDP datagrams sent from this entity (Linux only). shown as datagram |
|
system.net.udp.rcv_buf_errors (gauge) |
The rate of UDP datagrams lost because there was no room in the receive buffer (Linux only). shown as error |
|
system.net.udp.rcv_buf_errors.count (count) |
Total number of UDP datagrams lost because there was no room in the receive buffer (Linux only). shown as error |
|
system.net.udp.snd_buf_errors (gauge) |
The rate of UDP datagrams lost because there was no room in the send buffer (Linux only). shown as error |
|
system.net.udp.snd_buf_errors.count (count) |
Total number of UDP datagrams lost because there was no room in the send buffer (Linux only). shown as error |
|
system.net.udp.in_csum_errors.count (count) |
Total number of UDP datagrams that failed checksum verification (Linux only). shown as error |
The Network check does not include any events at this time.
The Network check does not include any service checks at this time.
Mistake in the docs? Feel free to contribute!