System network metricset

edit

The System network metricset provides network IO metrics collected from the operating system. One event is created for each network interface.

This metricset is available on:

  • FreeBSD
  • Linux
  • macOS
  • Windows

Configuration

edit
interfaces
By default metrics are reported from all network interfaces. To select which interfaces metrics are reported from, use the interfaces configuration option. The value must be an array of interface names. For example:
metricbeat.modules:
- module: system
  metricsets: [network]
  interfaces: [eth0]

This is a default metricset. If the host module is unconfigured, this metricset is enabled by default.

Fields

edit

For a description of each field in the metricset, see the exported fields section.

Here is an example document generated by this metricset:

{
    "@timestamp": "2017-10-12T08:05:34.853Z",
    "event": {
        "dataset": "system.network",
        "duration": 115000,
        "module": "system"
    },
    "metricset": {
        "name": "network",
        "period": 10000
    },
    "service": {
        "type": "system"
    },
    "system": {
        "network": {
            "in": {
                "bytes": 0,
                "dropped": 0,
                "errors": 0,
                "packets": 0
            },
            "name": "br-18285ad7f418",
            "out": {
                "bytes": 0,
                "dropped": 0,
                "errors": 0,
                "packets": 0
            }
        }
    }
}