Network Interfaces Telemetry

The network Interfaces telemetry provides a live inventory of network interfaces that the Netify Agent can observe. Each interface entry includes addressing information, capture method, and role, making it easy to confirm expected interface discovery and classification.

This dataset is useful for validating deployment state and troubleshooting capture coverage. By reviewing interface role assignments alongside addresses and MAC identifiers, you can quickly detect missing interfaces, unexpected role changes, or source mismatches in downstream analytics.

Requirements

Interfaces telemetry was introduced in the Core Plugin in version 1.0.20. To begin streaming the telemetry:

Install and configure the Netify Agent
Install and configure a Sink Plugin for receiving the telemetry
Install and configure the Core Plugin and add stream-stats to types

Source: Core Plugin
Plugin Release: 1.0.20

Attributes

type

string

Telemetry record type. Always interfaces.

<interface_name>

object

Per-interface object keyed by interface name.

addr

array[string]

List of IP addresses assigned to the interface.

capture_type

string

Capture type in use for the interface.

Values

nfqueue pcap tpv3

mac

string

Interface MAC address.

role

string

Assigned network role for the interface.

Values

lan wan

Network Interfaces Attributes - Example

{
  "eno1": {
    "addr": [
      "fe80::4639:c4ff:fe8f:d92",
      "fdc0:1766:43b:0:4639:c4ff:fe8f:d92",
      "11.113.88.4"
    ],
    "capture_type": "PCAP",
    "mac": "44:39:c4:8f:0d:92",
    "role": "WAN"
  },
  "eno2": {
    "addr": [
      "192.168.4.44",
      "fe80::901:29c0:649b:7efe"
    ],
    "capture_type": "PCAP",
    "mac": "f8:e9:03:01:69:13",
    "role": "LAN"
  },
  "type": "interfaces"
}