Wireless Input Plugin

This plugin gathers metrics about wireless link quality by reading the /proc/net/wireless file.

Introduced in: Telegraf v1.9.0 Tags: network OS support: linux

Global configuration options

In addition to the plugin-specific configuration settings, plugins support additional global and plugin configuration settings. These settings are used to modify metrics, tags, and field or create aliases and configure ordering, etc. See the CONFIGURATION.md for more details.

Configuration

# Monitor wifi signal strength and quality
# This plugin ONLY supports Linux
[[inputs.wireless]]
  ## Sets 'proc' directory path
  ## If not specified, then default is /proc
  # host_proc = "/proc"

Metrics

• metric
  • tags:
    • interface (wireless interface)
  • fields:
    • status (int64, gauge) - Its current state. This is a device dependent information
    • link (int64, percentage, gauge) - general quality of the reception
    • level (int64, dBm, gauge) - signal strength at the receiver
    • noise (int64, dBm, gauge) - silence level (no packet) at the receiver
    • nwid (int64, packets, counter) - number of discarded packets due to invalid network id
    • crypt (int64, packets, counter) - number of packet unable to decrypt
    • frag (int64, packets, counter) - fragmented packets
    • retry (int64, packets, counter) - cumulative retry counts
    • misc (int64, packets, counter) - dropped for un-specified reason
    • missed_beacon (int64, packets, counter) - missed beacon packets

Example Output

This section shows example output in Line Protocol format.

wireless,host=example.localdomain,interface=wlan0 misc=0i,frag=0i,link=60i,level=-50i,noise=-256i,nwid=0i,crypt=0i,retry=1525i,missed_beacon=0i,status=0i 1519843022000000000