---
title: Telegraf Documentation
description: Telegraf plugin for collecting metrics from Dell EMC XtremIO
url: https://docs.influxdata.com/telegraf/v1/input-plugins/xtremio/
estimated_tokens: 1706
product: Telegraf
version: v1
---

-   Telegraf v1.22.0+

# Dell EMC XtremIO Input Plugin

This plugin gathers metrics from a [Dell EMC XtremIO Storage Array](https://www.delltechnologies.com/asset/en-sa/products/storage/industry-market/h16444-introduction-xtremio-x2-storage-array-wp.pdf) instance using the [v3 Rest API](https://dl.dell.com/content/docu96624_xtremio-storage-array-x1-and-x2-cluster-types-with-xms-6-3-0-to-6-3-3-and-xios-4-0-15-to-4-0-31-and-6-0-0-to-6-3-3-restful-api-3-x-guide.pdf).

**Introduced in:** Telegraf v1.22.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
 # Gathers Metrics From a Dell EMC XtremIO Storage Array's V3 API
[[inputs.xtremio]]
  ## XtremIO User Interface Endpoint
  url = "https://xtremio.example.com/" # required

  ## Credentials
  username = "user1"
  password = "pass123"

  ## Metrics to collect from the XtremIO
  # collectors = ["bbus","clusters","ssds","volumes","xms"]

  ## Optional TLS Config
  # tls_ca = "/etc/telegraf/ca.pem"
  # tls_cert = "/etc/telegraf/cert.pem"
  # tls_key = "/etc/telegraf/key.pem"
  ## Use SSL but skip chain & host verification
  # insecure_skip_verify = false
```

## Metrics

-   bbus
    
    -   tags:
        -   serial\_number
        -   guid
        -   power\_feed
        -   name
        -   model\_name
    -   fields:
        -   bbus\_power
        -   bbus\_average\_daily\_temp
        -   bbus\_enabled
        -   bbus\_ups\_need\_battery\_replacement
        -   bbus\_ups\_low\_battery\_no\_input
-   clusters
    
    -   tags:
        -   hardware\_platform
        -   license\_id
        -   guid
        -   name
        -   sys\_psnt\_serial\_number
    -   fields:
        -   clusters\_compression\_factor
        -   clusters\_percent\_memory\_in\_use
        -   clusters\_read\_iops
        -   clusters\_write\_iops
        -   clusters\_number\_of\_volumes
        -   clusters\_free\_ssd\_space\_in\_percent
        -   clusters\_ssd\_num
        -   clusters\_data\_reduction\_ratio
-   ssds
    
    -   tags:
        -   model\_name
        -   firmware\_version
        -   ssd\_uid
        -   guid
        -   sys\_name
        -   serial\_number
    -   fields:
        -   ssds\_ssd\_size
        -   ssds\_ssd\_space\_in\_use
        -   ssds\_write\_iops
        -   ssds\_read\_iops
        -   ssds\_write\_bandwidth
        -   ssds\_read\_bandwidth
        -   ssds\_num\_bad\_sectors
-   volumes
    
    -   tags:
        -   guid
        -   sys\_name
        -   name
    -   fields:
        -   volumes\_read\_iops
        -   volumes\_write\_iops
        -   volumes\_read\_latency
        -   volumes\_write\_latency
        -   volumes\_data\_reduction\_ratio
        -   volumes\_provisioned\_space
        -   volumes\_used\_space
-   xms
    
    -   tags:
        -   guid
        -   name
        -   version
        -   xms\_ip
    -   fields:
        -   xms\_write\_iops
        -   xms\_read\_iops
        -   xms\_overall\_efficiency\_ratio
        -   xms\_ssd\_space\_in\_use
        -   xms\_ram\_in\_use
        -   xms\_ram\_total
        -   xms\_cpu\_usage\_total
        -   xms\_write\_latency
        -   xms\_read\_latency
        -   xms\_user\_accounts\_count

## Example Output

```text
xio,guid=abcdefghifklmnopqrstuvwxyz111111,host=HOSTNAME,model_name=Eaton\ 5P\ 1550,name=X2-BBU,power_feed=PWR-B,serial_number=SER1234567890 bbus_average_daily_temp=22i,bbus_enabled=1i,bbus_power=286i,bbus_ups_low_battery_no_input=0i,bbus_ups_need_battery_replacement=0i 1638295340000000000
xio,guid=abcdefghifklmnopqrstuvwxyz222222,host=HOSTNAME,model_name=Eaton\ 5P\ 1550,name=X1-BBU,power_feed=PWR-A,serial_number=SER1234567891 bbus_average_daily_temp=22i,bbus_enabled=1i,bbus_power=246i,bbus_ups_low_battery_no_input=0i,bbus_ups_need_battery_replacement=0i 1638295340000000000
xio,guid=abcdefghifklmnopqrstuvwxyz333333,hardware_platform=X1,host=HOSTNAME,license_id=LIC123456789,name=SERVER01,sys_psnt_serial_number=FNM01234567890 clusters_compression_factor=1.5160012465000001,clusters_data_reduction_ratio=2.1613617899,clusters_free_ssd_space_in_percent=34i,clusters_number_of_volumes=36i,clusters_percent_memory_in_use=29i,clusters_read_iops=331i,clusters_ssd_num=50i,clusters_write_iops=4649i 1638295341000000000
```

#### Related

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