Back to the list of connectors

Linux - Network (ip)

Description

This connector provides the monitoring of active network cards on all Linux systems using ip command.

Connector ID: LinuxIPNetwork

This connector is superseded by:

This connector supersedes:

Target

Typical platform: Any system

Operating system: Linux

Prerequisites

Leverages: Linux system commands (ip)

Technology and protocols: System Commands

This connector requires advanced privileges on the managed host for the command below:

  • ethtool

This connector therefore needs to run as root or you need to configure a privilege-escalation mechanism like sudo on the managed host to allow the monitoring account to run the command listed above.

Sample of /etc/sudoers to allow the above command to be run as root by the hwsagent account:

hwsagent ALL=(root) NOPASSWD: ethtool

Examples

CLI

hws HOSTNAME -t linux -f LinuxIPNetwork --ssh -u USER --sudo-command-list ethtool

hws-config.yaml

hosts:
- host:
    hostname: <HOSTNAME> # Change with actual host name
    type: linux
  selectedConnectors: [ LinuxIPNetwork ] # Optional, to load only this connector
  ssh:
    username: <USERNAME> # Change with actual credentials
    password: <PASSWORD> # Encrypted using hws-encrypt
    useSudo: true
    useSudoCommands: [ "ethtool" ]

Connector Activation Criteria

The Linux - Network (ip) connector will be automatically activated, and its status will be reported as OK if all the below criteria are met:

  • Operating System is Linux
  • The command below succeeds on the monitored host
    • Command: /sbin/ip a
    • Output contains: LOOPBACK (regex)

Metrics

Type Collected Metrics Specific Attributes (Labels)
Network Card, FC Port
  • hw.errors{hw.type="network"}
  • hw.network.bandwidth.limit
  • hw.network.bandwidth.utilization
  • hw.network.full_duplex
  • hw.network.io{direction="receive"}
  • hw.network.io{direction="transmit"}
  • hw.network.packets{direction="receive"}
  • hw.network.packets{direction="transmit"}
  • hw.network.up
  • hw.status{hw.type="network",state="present"}
  • logical_address
  • physical_address
No results.