<!--startmeta
custom_edit_url: "https://github.com/netdata/netdata/edit/master/src/go/plugin/go.d/collector/snmp/npm-catalog/integrations/nvidia_cumulus_linux_switch.md"
meta_yaml: "https://github.com/netdata/netdata/edit/master/src/go/plugin/go.d/collector/snmp/npm-catalog/metadata.yaml"
sidebar_label: "Nvidia Cumulus Linux Switch"
learn_status: "Published"
learn_rel_path: "Network Performance Monitoring/Device Metrics/Integrations"
keywords: ['nvidia', 'cumulus', 'linux', 'switch', 'snmp', 'switch', 'npm']
message: "DO NOT EDIT THIS FILE DIRECTLY, IT IS GENERATED BY THE NPM CATALOG metadata.yaml FILE"
endmeta-->

<!-- markdownlint-disable-file -->

# Nvidia Cumulus Linux Switch


<img src="https://netdata.cloud/img/nvidia.svg" width="150"/>


Plugin: go.d.plugin
Module: snmp

<img src="https://img.shields.io/badge/maintained%20by-Netdata-%2300ab44" />

## Overview

Monitor Nvidia Cumulus Linux Switch (switch) with Netdata over SNMP. Netdata recognizes the device automatically by its `sysObjectID` (recognized across 1 device identifiers) and collects the metrics this profile declares — on top of the generic SNMP baseline — with no manual OID configuration.

Netdata's SNMP collector matches the device to the **nvidia-cumulus-linux-switch.yaml** profile via `sysObjectID`/`sysDescr`, then polls the OIDs it declares.

This integration is supported on all platforms.

This integration supports multiple instances configured side-by-side.


### Default Behavior

#### Auto-Detection

Auto-detected as Nvidia Cumulus Linux Switch via sysObjectID/sysDescr.

#### Limits

The default configuration for this integration does not impose any limits.

#### Performance Impact

The default configuration for this integration is not expected to impose a significant performance impact on the system.

## Setup


You can configure the **snmp** collector in two ways:

| Method                | Best for                                                                                 | How to                                                                                                                                 |
|-----------------------|------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
| [**UI**](#via-ui)     | Fast setup without editing files                                                         | Go to **Nodes → Configure this node → Collectors → Jobs**, search for **snmp**, then click **+** to add a job. |
| [**File**](#via-file) | If you prefer configuring via file, or need to automate deployments (e.g., with Ansible) | Edit `go.d/snmp.conf` and add a job.                                                                        |

:::important

UI configuration requires paid Netdata Cloud plan.

:::


### Prerequisites

#### SNMP access

SNMP must be enabled on the device and reachable from the Netdata Agent acting as the site's SNMP hub.


### Configuration

#### Options

Configure the SNMP collector with the device hostname and SNMP credentials. See the SNMP collector reference for all options.


#### via UI

Configure the **snmp** collector from the Netdata web interface:

1. Go to **Nodes**.
2. Select the node **where you want the snmp data-collection job to run** and click the :gear: (**Configure this node**). That node will run the data collection.
3. The **Collectors → Jobs** view opens by default.
4. In the Search box, type _snmp_ (or scroll the list) to locate the **snmp** collector.
5. Click the **+** next to the **snmp** collector to add a new job.
6. Fill in the job fields, then click **Test** to verify the configuration and **Submit** to save.
    - **Test** runs the job with the provided settings and shows whether data can be collected.
    - If it fails, an error message appears with details (for example, connection refused, timeout, or command execution errors), so you can adjust and retest.


#### via File

The configuration file name for this integration is `go.d/snmp.conf`.

The file format is YAML. Generally, the structure is:

```yaml
update_every: 1
autodetection_retry: 0
jobs:
  - name: some_name1
  - name: some_name2
```
You can edit the configuration file using the [`edit-config`](https://github.com/netdata/netdata/blob/master/docs/netdata-agent/configuration/README.md#edit-configuration-files) script from the
Netdata [config directory](https://github.com/netdata/netdata/blob/master/docs/netdata-agent/configuration/README.md#locate-your-config-directory).

```bash
cd /etc/netdata 2>/dev/null || cd /opt/netdata/etc/netdata
sudo ./edit-config go.d/snmp.conf
```

##### Examples
There are no configuration examples.



## Alerts

There are no alerts configured by default for this integration.



## Metrics

On top of the **generic SNMP baseline** (the *Generic SNMP Device* integration — interfaces, system, IP/TCP/UDP, host resources), this Nvidia Cumulus Linux Switch profile adds the metrics below. Each is collected **only where the device exposes the matching OID** — inclusion means the profile requests it; availability depends on the device model and software.

**101 metrics** in 12 groups; each row is a chart context usable in alerts.

| Group | Metrics |
|---|---|
| Hardware / PoE | 4 |
| Hardware / Sensor | 2 |
| Network / ACL | 16 |
| Network / Interface | 35 |
| Network / L2 | 2 |
| Network / Routing | 8 |
| System / Activity | 2 |
| System / CPU | 3 |
| System / Disk | 15 |
| System / Memory | 11 |
| System / Uptime | 1 |
| Uncategorized | 2 |

### Hardware / PoE

| Metric (chart context) | Unit | Scope | Description |
|---|---|---|---|
| `snmp.device_prof_cumulus_poeLastUpdateTime` | `s` | device | The system uptime timestamp when the objects in this MIB were last updated |
| `snmp.device_prof_cumulus_poeTotalAvailablePower` | `mW` | device | The total UNUSED and available power for the system in the common pool for new devices |
| `snmp.device_prof_cumulus_poeTotalSystemPower` | `mW` | device | The total power available to the system |
| `snmp.device_prof_cumulus_poeTotalUsedPower` | `mW` | device | The total power USED by ports in the system |

### Hardware / Sensor

| Metric (chart context) | Unit | Scope | Description |
|---|---|---|---|
| `snmp.device_prof_entPhySensorOperStatus` | `{status}` | per sensor_index, rm:sensor_type, rm:sensor_scale, rm:sensor_precision | Operational status of the sensor |
| `snmp.device_prof_entPhySensorValue` | `1` | per sensor_index, rm:sensor_type, rm:sensor_scale, rm:sensor_precision | Most recent measurement obtained by the agent for this sensor |

### Network / ACL

| Metric (chart context) | Unit | Scope | Description |
|---|---|---|---|
| `snmp.device_prof_cumulus_egressAclCurrentCounters` | `{counter}` | device | The current number of Egress counters in the Network Access Control List table |
| `snmp.device_prof_cumulus_egressAclCurrentEntries` | `{entry}` | device | The current number of Egress entries in the Network Access Control List table |
| `snmp.device_prof_cumulus_egressAclCurrentMeters` | `{meter}` | device | The current number of Egress meters in the Network Access Control List table |
| `snmp.device_prof_cumulus_egressAclCurrentSlices` | `{slice}` | device | The current number of Egress slices in the Network Access Control List table |
| `snmp.device_prof_cumulus_egressAclMaxCounters` | `{counter}` | device | The maximum possible Egress counters in the Network Access Control table |
| `snmp.device_prof_cumulus_egressAclMaxEntries` | `{entry}` | device | The maximum possible Egress entries in the Network Access Control table |
| `snmp.device_prof_cumulus_egressAclMaxMeters` | `{meter}` | device | The maximum possible Egress meters in the Network Access Control table |
| `snmp.device_prof_cumulus_egressAclMaxSlices` | `{slice}` | device | The maximum possible Egress slices in the Network Access Control table |
| `snmp.device_prof_cumulus_ingressAclCurrentCounters` | `{counter}` | device | The current number of Ingress counters in the Network Access Control List table |
| `snmp.device_prof_cumulus_ingressAclCurrentEntries` | `{entry}` | device | The current number of Ingress entries in the Network Access Control List table |
| `snmp.device_prof_cumulus_ingressAclCurrentMeters` | `{meter}` | device | The current number of Ingress meters in the Network Access Control List table |
| `snmp.device_prof_cumulus_ingressAclCurrentSlices` | `{slice}` | device | The current number of Ingress slices in the Network Access Control List table |
| `snmp.device_prof_cumulus_ingressAclMaxCounters` | `{counter}` | device | The maximum possible Ingress counters in the Network Access Control table |
| `snmp.device_prof_cumulus_ingressAclMaxEntries` | `{entry}` | device | The maximum possible Ingress entries in the Network Access Control table |
| `snmp.device_prof_cumulus_ingressAclMaxMeters` | `{meter}` | device | The maximum possible Ingress meters in the Network Access Control table |
| `snmp.device_prof_cumulus_ingressAclMaxSlices` | `{slice}` | device | The maximum possible Ingress slices in the Network Access Control table |

### Network / Interface

| Metric (chart context) | Unit | Scope | Description |
|---|---|---|---|
| `snmp.device_prof_cumulus_clBufferOverflowDiscards` | `{packet}/s` | per cumulus_cl_port_index, cumulus_cl_port_name | Number of inbound packets discarded due to ingress buffer overflow. |
| `snmp.device_prof_cumulus_clEgressNonQDiscards` | `{packet}/s` | per cumulus_cl_port_index, cumulus_cl_port_name | Total number of packets discarded on egress due to reasons reasons other than queue overflow. |
| `snmp.device_prof_cumulus_clEgressQOverflowDiscards` | `{packet}/s` | per cumulus_cl_port_index, cumulus_cl_port_name | Number of packets discarded due to egress queue overflow. |
| `snmp.device_prof_cumulus_clIntInBcastPkts` | `{packet}/s` | per cumulus_cl_int_index, cumulus_cl_int_port_name | The number of input broadcast packets on the interface |
| `snmp.device_prof_cumulus_clIntInMcastPkts` | `{packet}/s` | per cumulus_cl_int_index, cumulus_cl_int_port_name | The number of input multicast packets on the interface |
| `snmp.device_prof_cumulus_clIntInOctets` | `bit/s` | per cumulus_cl_int_index, cumulus_cl_int_port_name | The number of input octets on the interface |
| `snmp.device_prof_cumulus_clIntInPausePkt` | `{packet}/s` | per cumulus_cl_int_pfc_index, cumulus_cl_int_pfc_port_name | The number of ethernet flow control pause packets received on the interface |
| `snmp.device_prof_cumulus_clIntInPfc0Pkt` | `{packet}/s` | per cumulus_cl_int_pfc_index, cumulus_cl_int_pfc_port_name | The number of ethernet priority flow control traffic class 0 packets received on the interface |
| `snmp.device_prof_cumulus_clIntInPfc1Pkt` | `{packet}/s` | per cumulus_cl_int_pfc_index, cumulus_cl_int_pfc_port_name | The number of ethernet priority flow control traffic class 1 packets received on the interface |
| `snmp.device_prof_cumulus_clIntInPfc2Pkt` | `{packet}/s` | per cumulus_cl_int_pfc_index, cumulus_cl_int_pfc_port_name | The number of ethernet priority flow control traffic class 2 packets received on the interface |
| `snmp.device_prof_cumulus_clIntInPfc3Pkt` | `{packet}/s` | per cumulus_cl_int_pfc_index, cumulus_cl_int_pfc_port_name | The number of ethernet priority flow control traffic class 3 packets received on the interface |
| `snmp.device_prof_cumulus_clIntInPfc4Pkt` | `{packet}/s` | per cumulus_cl_int_pfc_index, cumulus_cl_int_pfc_port_name | The number of ethernet priority flow control traffic class 4 packets received on the interface |
| `snmp.device_prof_cumulus_clIntInPfc5Pkt` | `{packet}/s` | per cumulus_cl_int_pfc_index, cumulus_cl_int_pfc_port_name | The number of ethernet priority flow control traffic class 5 packets received on the interface |
| `snmp.device_prof_cumulus_clIntInPfc6Pkt` | `{packet}/s` | per cumulus_cl_int_pfc_index, cumulus_cl_int_pfc_port_name | The number of ethernet priority flow control traffic class 6 packets received on the interface |
| `snmp.device_prof_cumulus_clIntInPfc7Pkt` | `{packet}/s` | per cumulus_cl_int_pfc_index, cumulus_cl_int_pfc_port_name | The number of ethernet priority flow control traffic class 7 packets received on the interface |
| `snmp.device_prof_cumulus_clIntInUcastPkts` | `{packet}/s` | per cumulus_cl_int_index, cumulus_cl_int_port_name | The number of input unicast packets on the interface |
| `snmp.device_prof_cumulus_clIntOutBcastPkts` | `{packet}/s` | per cumulus_cl_int_index, cumulus_cl_int_port_name | The number of output broadcast packets on the interface |
| `snmp.device_prof_cumulus_clIntOutMcastPkts` | `{packet}/s` | per cumulus_cl_int_index, cumulus_cl_int_port_name | The number of output multicast packets on the interface |
| `snmp.device_prof_cumulus_clIntOutOctets` | `bit/s` | per cumulus_cl_int_index, cumulus_cl_int_port_name | The number of output octets on the interface |
| `snmp.device_prof_cumulus_clIntOutPausePkt` | `{packet}/s` | per cumulus_cl_int_pfc_index, cumulus_cl_int_pfc_port_name | The number of ethernet flow control pause packets transmitted on the interface |
| `snmp.device_prof_cumulus_clIntOutPfc0Pkt` | `{packet}/s` | per cumulus_cl_int_pfc_index, cumulus_cl_int_pfc_port_name | The number of ethernet priority flow control traffic class 0 packets transmitted on the interface |
| `snmp.device_prof_cumulus_clIntOutPfc1Pkt` | `{packet}/s` | per cumulus_cl_int_pfc_index, cumulus_cl_int_pfc_port_name | The number of ethernet priority flow control traffic class 1 packets transmitted on the interface |
| `snmp.device_prof_cumulus_clIntOutPfc2Pkt` | `{packet}/s` | per cumulus_cl_int_pfc_index, cumulus_cl_int_pfc_port_name | The number of ethernet priority flow control traffic class 2 packets transmitted on the interface |
| `snmp.device_prof_cumulus_clIntOutPfc3Pkt` | `{packet}/s` | per cumulus_cl_int_pfc_index, cumulus_cl_int_pfc_port_name | The number of ethernet priority flow control traffic class 3 packets transmitted on the interface |
| `snmp.device_prof_cumulus_clIntOutPfc4Pkt` | `{packet}/s` | per cumulus_cl_int_pfc_index, cumulus_cl_int_pfc_port_name | The number of ethernet priority flow control traffic class 4 packets transmitted on the interface |
| `snmp.device_prof_cumulus_clIntOutPfc5Pkt` | `{packet}/s` | per cumulus_cl_int_pfc_index, cumulus_cl_int_pfc_port_name | The number of ethernet priority flow control traffic class 5 packets transmitted on the interface |
| `snmp.device_prof_cumulus_clIntOutPfc6Pkt` | `{packet}/s` | per cumulus_cl_int_pfc_index, cumulus_cl_int_pfc_port_name | The number of ethernet priority flow control traffic class 6 packets transmitted on the interface |
| `snmp.device_prof_cumulus_clIntOutPfc7Pkt` | `{packet}/s` | per cumulus_cl_int_pfc_index, cumulus_cl_int_pfc_port_name | The number of ethernet priority flow control traffic class 7 packets transmitted on the interface |
| `snmp.device_prof_cumulus_clIntOutUcastPkts` | `{packet}/s` | per cumulus_cl_int_index, cumulus_cl_int_port_name | The number of output unicast packets on the interface |
| `snmp.device_prof_cumulus_clL3AclDiscards` | `{packet}/s` | per cumulus_cl_port_index, cumulus_cl_port_name | Number of inbound IPv4 packets discarded due to ingress ACL table. |
| `snmp.device_prof_cumulus_clL3v4InDiscards` | `{packet}/s` | per cumulus_cl_port_index, cumulus_cl_port_name | Number of inbound IPv4 packets discarded by the routing engine. |
| `snmp.device_prof_ifAdminStatus` | `{status}` | per interface, interface | Current administrative state of the interface |
| `snmp.device_prof_ifHighSpeed` | `bit/s` | per interface, interface | Estimate of the interface's current bandwidth |
| `snmp.device_prof_ifNumber` | `{interface}` | device | Number of network interfaces regardless of their current state present on this system |
| `snmp.device_prof_ifOperStatus` | `{status}` | per interface, interface | Current operational state of the interface |

### Network / L2

| Metric (chart context) | Unit | Scope | Description |
|---|---|---|---|
| `snmp.device_prof_cumulus_l2MacTableCurrentEntries` | `{entry}` | device | The number of L2 Mac table entries currently in use |
| `snmp.device_prof_cumulus_l2MacTableMaxEntries` | `{entry}` | device | The maximum possible entries in the L2 Mac table |

### Network / Routing

| Metric (chart context) | Unit | Scope | Description |
|---|---|---|---|
| `snmp.device_prof_cumulus_l3EcmpNextHopTableCurrentEntries` | `{entry}` | device | The number of ECMP Next Hop table entries currently in use |
| `snmp.device_prof_cumulus_l3EcmpNextHopTableMaxEntries` | `{entry}` | device | The maximum possible entries in the ECMP Next Hop table |
| `snmp.device_prof_cumulus_l3HostTableCurrentEntries` | `{entry}` | device | The number of L3 Host table entries currently in use |
| `snmp.device_prof_cumulus_l3HostTableMaxEntries` | `{entry}` | device | The maximum possible entries in the L3 Host table |
| `snmp.device_prof_cumulus_l3NextHopTableCurrentEntries` | `{entry}` | device | The number of L3 Next Hop table entries currently in use |
| `snmp.device_prof_cumulus_l3NextHopTableMaxEntries` | `{entry}` | device | The maximum possible entries in the L3 Next Hop table |
| `snmp.device_prof_cumulus_l3RoutingTableCurrentEntries` | `{entry}` | device | The number of L3 Routing table entries currently in use |
| `snmp.device_prof_cumulus_l3RoutingTableMaxEntries` | `{entry}` | device | The maximum possible entries in the L3 Routing table |

### System / Activity

| Metric (chart context) | Unit | Scope | Description |
|---|---|---|---|
| `snmp.device_prof_hrSystemNumUsers` | `{session}` | device | The number of user sessions for which this host is storing state information. A session is a collection of processes requiring a s… |
| `snmp.device_prof_hrSystemProcesses` | `{process}` | device | The number of process contexts currently loaded or running on this system. |

### System / CPU

| Metric (chart context) | Unit | Scope | Description |
|---|---|---|---|
| `snmp.device_prof_cpu_usage` | `%` | per cpu_index | The current CPU utilization |
| `snmp.device_prof_ucd_ssRawContexts` | `{switch}/s` | device | Number of context switches |
| `snmp.device_prof_ucd_ssRawInterrupts` | `{interrupt}/s` | device | Number of interrupts processed |

### System / Disk

| Metric (chart context) | Unit | Scope | Description |
|---|---|---|---|
| `snmp.device_prof_ucd_diskIOLA1` | `%` | per ucd_disk_io_device | The 1 minute average load of disk (%) |
| `snmp.device_prof_ucd_diskIOLA15` | `%` | per ucd_disk_io_device | The 15 minute average load of disk (%) |
| `snmp.device_prof_ucd_diskIOLA5` | `%` | per ucd_disk_io_device | The 5 minute average load of disk (%) |
| `snmp.device_prof_ucd_diskIONReadX` | `By/s` | per ucd_disk_io_device | The number of bytes read from this device since boot |
| `snmp.device_prof_ucd_diskIONWrittenX` | `By/s` | per ucd_disk_io_device | The number of bytes written to this device since boot |
| `snmp.device_prof_ucd_diskIOReads` | `{read}/s` | per ucd_disk_io_device | The number of read accesses from this device since boot |
| `snmp.device_prof_ucd_diskIOWrites` | `{write}/s` | per ucd_disk_io_device | The number of write accesses to this device since boot |
| `snmp.device_prof_ucd_dskAvail` | `By` | per ucd_dsk_path, ucd_dsk_device | Available space on the disk |
| `snmp.device_prof_ucd_dskErrorFlag` | `{status}` | per ucd_dsk_path, ucd_dsk_device | Flag signaling that the disk or partition is under the minimum required space configured for it |
| `snmp.device_prof_ucd_dskPercent` | `%` | per ucd_dsk_path, ucd_dsk_device | Percentage of space used on disk |
| `snmp.device_prof_ucd_dskPercentNode` | `%` | per ucd_dsk_path, ucd_dsk_device | Percentage of inodes used on disk |
| `snmp.device_prof_ucd_dskTotal` | `By` | per ucd_dsk_path, ucd_dsk_device | Total size of the disk/partition |
| `snmp.device_prof_ucd_dskUsed` | `By` | per ucd_dsk_path, ucd_dsk_device | Used space on the disk |
| `snmp.device_prof_ucd_ssIORawReceived` | `By/s` | device | Amount of data read from disk or other block device |
| `snmp.device_prof_ucd_ssIORawSent` | `By/s` | device | Amount of data written to disk or other block device |

### System / Memory

| Metric (chart context) | Unit | Scope | Description |
|---|---|---|---|
| `snmp.device_prof_memory_free` | `By` | device | The amount of real/physical memory currently unused or available |
| `snmp.device_prof_ucd_memAvailSwap` | `By` | device | The amount of swap space currently unused or available |
| `snmp.device_prof_ucd_memBuffer` | `By` | device | The total amount of real or virtual memory currently allocated for use as memory buffers |
| `snmp.device_prof_ucd_memCached` | `By` | device | The total amount of real or virtual memory currently allocated for use as cached memory |
| `snmp.device_prof_ucd_memMinimumSwap` | `By` | device | The minimum amount of swap space expected to be kept free or available during normal operation of this host |
| `snmp.device_prof_ucd_memShared` | `By` | device | The total amount of real or virtual memory currently allocated for use as shared memory |
| `snmp.device_prof_ucd_memTotalFree` | `By` | device | The total amount of memory free or available for use on this host |
| `snmp.device_prof_ucd_memTotalSwap` | `By` | device | The total amount of swap space configured for this host |
| `snmp.device_prof_ucd_memoryTotal` | `By` | device | The total amount of real/physical memory installed on this host |
| `snmp.device_prof_ucd_ssRawSwapIn` | `By/s` | device | Amount of memory swapped in from disk |
| `snmp.device_prof_ucd_ssRawSwapOut` | `By/s` | device | Amount of memory swapped out to disk |

### System / Uptime

| Metric (chart context) | Unit | Scope | Description |
|---|---|---|---|
| `snmp.device_prof_systemUptime` | `s` | device | Time since the system was last rebooted or powered on. |

### Uncategorized

| Metric (chart context) | Unit | Scope | Description |
|---|---|---|---|
| `snmp.device_prof_hrStorageSize` | `By` | per storage_index, rm:storage_type, rm:storage_alloc_unit |  |
| `snmp.device_prof_hrStorageUsed` | `By` | per storage_index, rm:storage_type, rm:storage_alloc_unit |  |
