---
title: Telegraf Documentation
description: Telegraf plugin for collecting metrics from Netgear Switch Discovery Protocol
url: https://docs.influxdata.com/telegraf/v1/input-plugins/nsdp/
estimated_tokens: 1146
product: Telegraf
version: v1
---

-   Telegraf v1.34.0+

# Netgear Switch Discovery Protocol Input Plugin

This plugin gathers metrics from devices via the [Netgear Switch Discovery Protocol](https://en.wikipedia.org/wiki/Netgear_Switch_Discovery_Protocol) for all available switches and ports.

**Introduced in:** Telegraf v1.34.0 **Tags:** network **OS support:** all

## Global configuration options

Plugins support additional global and plugin configuration settings for tasks such as modifying metrics, tags, and fields, creating aliases, and configuring plugin ordering. See [CONFIGURATION.md](/telegraf/v1/configuration/#plugins) for more details.

## Configuration

```toml
# Gather Netgear Switch Discovery Protocol status
[[inputs.nsdp]]
  ## The target address to use for status gathering. Either Broadcast (default)
  ## or the address of a single well-known device.
  # address = "255.255.255.255:63322"

  ## The maximum number of device responses to wait for. 0 means no limit.
  ## NSDP works asynchronously. Without a limit (0) the plugin always waits
  ## the amount given in timeout for possible responses. By setting this
  ## option to the known number of devices, the plugin completes
  ## processing as soon as the last device has answered.
  # device_limit = 0

  ## The maximum duration to wait for device responses.
  # timeout = "2s"
```

## Metrics

-   `nsdp_device_port`
    -   tags
        -   `device` - The device identifier (MAC/HW address)
        -   `device_ip` - The device’s IP address
        -   `device_name` - The device’s name
        -   `device_model` - The device’s model
        -   `device_port` - The port id the fields are referring to
    -   fields
        -   `bytes_sent` (uint) - Number of bytes sent via this port
        -   `bytes_recv` (uint) - Number of bytes received via this port
        -   `packets_total` (uint) - Total number of packets processed on this port
        -   `broadcasts_total` (uint) - Total number of broadcasts processed on this port
        -   `multicasts_total` (uint) - Total number of multicasts processed on this port
        -   `errors_total` (uint) - Total number of errors encountered on this port

## Example Output

```text
nsdp_device_port,device=12:34:56:78:9a:bc,device_ip=10.1.0.4,device_model=GS108Ev3,device_name=switch2,device_port=1 broadcasts_total=0u,bytes_recv=3879427866u,bytes_sent=506548796u,errors_total=0u,multicasts_total=0u,packets_total=0u 1737152505014578000
```

#### Related

-   [Configure plugins](/telegraf/v1/configure_plugins/)
-   [Netgear Switch Discovery Protocol Plugin Source](https://github.com/influxdata/telegraf/tree/v1.38.4/plugins/inputs/nsdp/README.md)