docs-v2/content/telegraf/v1/input-plugins/xtremio/_index.md

4.9 KiB

description menu tags introduced os_support related
Telegraf plugin for collecting metrics from Dell EMC XtremIO
telegraf_v1_ref
parent name identifier
input_plugins_reference Dell EMC XtremIO input-xtremio
Dell EMC XtremIO
input-plugins
configuration
network
v1.22.0 freebsd, linux, macos, solaris, windows
/telegraf/v1/configure_plugins/
https://github.com/influxdata/telegraf/tree/v1.36.1/plugins/inputs/xtremio/README.md, Dell EMC XtremIO Plugin Source

Dell EMC XtremIO Input Plugin

This plugin gathers metrics from a Dell EMC XtremIO Storage Array instance using the v3 Rest API.

Introduced in: Telegraf v1.22.0 Tags: network OS support: all

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

 # 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

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