---
title: Telegraf Documentation
description: Telegraf plugin for collecting metrics from InfiniBand
url: https://docs.influxdata.com/telegraf/v1/input-plugins/infiniband/
estimated_tokens: 1579
product: Telegraf
version: v1
---

-   Telegraf v1.14.0+

# InfiniBand Input Plugin

This plugin gathers statistics for all InfiniBand devices and ports on the system. These are the counters that can be found in `/sys/class/infiniband/<dev>/port/<port>/counters/` and RDMA counters can be found in `/sys/class/infiniband/<dev>/ports/<port>/hw_counters/`

**Introduced in:** Telegraf v1.14.0 **Tags:** network **OS support:** linux

## 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
# Gets counters from all InfiniBand cards and ports installed
# This plugin ONLY supports Linux
[[inputs.infiniband]]
  # no configuration

  ## Collect RDMA counters
  # gather_rdma = false
```

## Metrics

Actual metrics depend on the InfiniBand devices, the plugin uses a simple mapping from counter -> counter value.

[Information about the counters](https://enterprise-support.nvidia.com/s/article/understanding-mlx5-linux-counters-and-status-parameters) collected is provided by Nvidia.

The following fields are emitted by the plugin when selecting `counters`:

-   infiniband
    -   tags:
        
        -   device
        -   port
    -   fields:
        
        ### Infiniband Counters
        
        -   excessive\_buffer\_overrun\_errors (integer)
        -   link\_downed (integer)
        -   link\_error\_recovery (integer)
        -   local\_link\_integrity\_errors (integer)
        -   multicast\_rcv\_packets (integer)
        -   multicast\_xmit\_packets (integer)
        -   port\_rcv\_constraint\_errors (integer)
        -   port\_rcv\_data (integer)
        -   port\_rcv\_errors (integer)
        -   port\_rcv\_packets (integer)
        -   port\_rcv\_remote\_physical\_errors (integer)
        -   port\_rcv\_switch\_relay\_errors (integer)
        -   port\_xmit\_constraint\_errors (integer)
        -   port\_xmit\_data (integer)
        -   port\_xmit\_discards (integer)
        -   port\_xmit\_packets (integer)
        -   port\_xmit\_wait (integer)
        -   symbol\_error (integer)
        -   unicast\_rcv\_packets (integer)
        -   unicast\_xmit\_packets (integer)
        -   VL15\_dropped (integer)
        
        ### Infiniband RDMA counters
        
        -   duplicate\_request (integer)
        -   implied\_nak\_seq\_err (integer)
        -   lifespan (integer)
        -   local\_ack\_timeout\_err (integer)
        -   np\_cnp\_sent (integer)
        -   np\_ecn\_marked\_roce\_packets (integer)
        -   out\_of\_buffer (integer)
        -   out\_of\_sequence (integer)
        -   packet\_seq\_err (integer)
        -   req\_cqe\_error (integer)
        -   req\_cqe\_flush\_error (integer)
        -   req\_remote\_access\_errors (integer)
        -   req\_remote\_invalid\_request (integer)
        -   resp\_cqe\_error (integer)
        -   resp\_cqe\_flush\_error (integer)
        -   resp\_local\_length\_error (integer)
        -   resp\_remote\_access\_errors (integer)
        -   rnr\_nak\_retry\_err (integer)
        -   roce\_adp\_retrans (integer)
        -   roce\_adp\_retrans\_to (integer)
        -   roce\_slow\_restart (integer)
        -   roce\_slow\_restart\_cnps (integer)
        -   roce\_slow\_restart\_trans (integer)
        -   rp\_cnp\_handled (integer)
        -   rp\_cnp\_ignored (integer)
        -   rx\_atomic\_requests (integer)
        -   rx\_icrc\_encapsulated (integer)
        -   rx\_read\_requests (integer)
        -   rx\_write\_requests (integer)

## Example Output

```text
infiniband,device=mlx5_bond_0,host=hop-r640-12,port=1 port_xmit_data=85378896588i,VL15_dropped=0i,port_rcv_packets=34914071i,port_rcv_data=34600185253i,port_xmit_discards=0i,link_downed=0i,local_link_integrity_errors=0i,symbol_error=0i,link_error_recovery=0i,multicast_rcv_packets=0i,multicast_xmit_packets=0i,unicast_xmit_packets=82002535i,excessive_buffer_overrun_errors=0i,port_rcv_switch_relay_errors=0i,unicast_rcv_packets=34914071i,port_xmit_constraint_errors=0i,port_rcv_errors=0i,port_xmit_wait=0i,port_rcv_remote_physical_errors=0i,port_rcv_constraint_errors=0i,port_xmit_packets=82002535i 1737652060000000000
infiniband,device=mlx5_bond_0,host=hop-r640-12,port=1 local_ack_timeout_err=0i,lifespan=10i,out_of_buffer=0i,resp_remote_access_errors=0i,resp_local_length_error=0i,np_cnp_sent=0i,roce_slow_restart=0i,rx_read_requests=6000i,duplicate_request=0i,resp_cqe_error=0i,rx_write_requests=19000i,roce_slow_restart_cnps=0i,rx_icrc_encapsulated=0i,rnr_nak_retry_err=0i,roce_adp_retrans=0i,out_of_sequence=0i,req_remote_access_errors=0i,roce_slow_restart_trans=0i,req_remote_invalid_request=0i,req_cqe_error=0i,resp_cqe_flush_error=0i,packet_seq_err=0i,roce_adp_retrans_to=0i,np_ecn_marked_roce_packets=0i,rp_cnp_handled=0i,implied_nak_seq_err=0i,rp_cnp_ignored=0i,req_cqe_flush_error=0i,rx_atomic_requests=0i 1737652060000000000
```

#### Related

-   [Configure plugins](/telegraf/v1/configure_plugins/)
-   [InfiniBand Plugin Source](https://github.com/influxdata/telegraf/tree/v1.38.4/plugins/inputs/infiniband/README.md)