--- title: Telegraf Documentation description: Telegraf plugin for collecting metrics from Redfish url: https://docs.influxdata.com/telegraf/v1/input-plugins/redfish/ estimated_tokens: 3374 product: Telegraf version: v1 --- - Telegraf v1.15.0+ # Redfish Input Plugin This plugin gathers metrics and status information of server hardware with enabled [DMTF’s Redfish](https://redfish.dmtf.org/) support. **Introduced in:** Telegraf v1.15.0 **Tags:** server **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. ## Secret-store support This plugin supports secrets from secret-stores for the `username` and `password` options. See the [secret-store documentation](/telegraf/v1/configuration/#secret-store-secrets) for more details on how to use them. ## Configuration ```toml # Read CPU, Fans, Powersupply and Voltage metrics of hardware server through redfish APIs [[inputs.redfish]] ## Redfish API Base URL. address = "https://127.0.0.1:5000" ## Credentials for the Redfish API. Can also use secrets. username = "root" password = "password123456" ## System Id to collect data for in Redfish APIs. computer_system_id="System.Embedded.1" ## Metrics to collect ## The metric collects to gather. Choose from "power" and "thermal". # include_metrics = ["power", "thermal"] ## Tag sets allow you to include redfish OData link parent data ## For Example. ## Thermal data is an OData link with parent Chassis which has a link of Location. ## For more info see the Redfish Resource and Schema Guide at DMTFs website. ## Available sets are: "chassis.location" and "chassis" # include_tag_sets = ["chassis.location"] ## Workarounds ## Defines workarounds for certain hardware vendors. Choose from: ## * ilo4-thermal - Do not pass 0Data-Version header to Thermal endpoint # workarounds = [] ## Amount of time allowed to complete the HTTP request # timeout = "5s" ## Optional TLS Config # tls_ca = "/etc/telegraf/ca.pem" # tls_cert = "/etc/telegraf/cert.pem" # tls_key = "/etc/telegraf/key.pem" ## Use TLS but skip chain & host verification # insecure_skip_verify = false ``` ## Metrics - redfish\_thermal\_temperatures - tags: - source - member\_id - address - name - state - health - fields: - reading\_celsius - upper\_threshold\_critical - upper\_threshold\_fatal - lower\_threshold\_critical - lower\_threshold\_fatal - redfish\_thermal\_fans - tags: - source - member\_id - address - name - state - health - fields: - reading\_rpm (or) reading\_percent - upper\_threshold\_critical - upper\_threshold\_fatal - lower\_threshold\_critical - lower\_threshold\_fatal - redfish\_power\_powersupplies - tags: - source - member\_id - address - name - state - health - fields: - last\_power\_output\_watts - line\_input\_voltage - power\_capacity\_watts - power\_input\_watts - power\_output\_watts - redfish\_power\_voltages (available only if voltage data is found) - tags: - source - member\_id - address - name - state - health - fields: - reading\_volts - upper\_threshold\_critical - upper\_threshold\_fatal - lower\_threshold\_critical - lower\_threshold\_fatal ### Tag Sets - chassis.location - tags: - datacenter (available only if location data is found) - rack (available only if location data is found) - room (available only if location data is found) - row (available only if location data is found) - chassis - tags: - chassis\_chassistype - chassis\_manufacturer - chassis\_model - chassis\_partnumber - chassis\_powerstate - chassis\_sku - chassis\_serialnumber - chassis\_state - chassis\_health ## Example Output ```text redfish_thermal_temperatures,address=127.0.0.1,chassis_chassistype=RackMount,chassis_health=OK,chassis_manufacturer=Contoso,chassis_model=3500RX,chassis_partnumber=224071-J23,chassis_powerstate=On,chassis_serialnumber=437XR1138R2,chassis_sku=8675309,chassis_state=Enabled,health=OK,member_id=0,name=CPU1\ Temp,rack=WEB43,row=North,source=web483,state=Enabled reading_celsius=41,upper_threshold_critical=45,upper_threshold_fatal=48 1691270160000000000 redfish_thermal_temperatures,address=127.0.0.1,chassis_chassistype=RackMount,chassis_health=OK,chassis_manufacturer=Contoso,chassis_model=3500RX,chassis_partnumber=224071-J23,chassis_powerstate=On,chassis_serialnumber=437XR1138R2,chassis_sku=8675309,chassis_state=Enabled,member_id=1,name=CPU2\ Temp,rack=WEB43,row=North,source=web483,state=Disabled upper_threshold_critical=45,upper_threshold_fatal=48 1691270160000000000 redfish_thermal_temperatures,address=127.0.0.1,chassis_chassistype=RackMount,chassis_health=OK,chassis_manufacturer=Contoso,chassis_model=3500RX,chassis_partnumber=224071-J23,chassis_powerstate=On,chassis_serialnumber=437XR1138R2,chassis_sku=8675309,chassis_state=Enabled,health=OK,member_id=2,name=Chassis\ Intake\ Temp,rack=WEB43,row=North,source=web483,state=Enabled upper_threshold_critical=40,upper_threshold_fatal=50,lower_threshold_critical=5,lower_threshold_fatal=0,reading_celsius=25 1691270160000000000 redfish_thermal_fans,address=127.0.0.1,chassis_chassistype=RackMount,chassis_health=OK,chassis_manufacturer=Contoso,chassis_model=3500RX,chassis_partnumber=224071-J23,chassis_powerstate=On,chassis_serialnumber=437XR1138R2,chassis_sku=8675309,chassis_state=Enabled,health=OK,member_id=0,name=BaseBoard\ System\ Fan,rack=WEB43,row=North,source=web483,state=Enabled lower_threshold_fatal=0i,reading_rpm=2100i 1691270160000000000 redfish_thermal_fans,address=127.0.0.1,chassis_chassistype=RackMount,chassis_health=OK,chassis_manufacturer=Contoso,chassis_model=3500RX,chassis_partnumber=224071-J23,chassis_powerstate=On,chassis_serialnumber=437XR1138R2,chassis_sku=8675309,chassis_state=Enabled,health=OK,member_id=1,name=BaseBoard\ System\ Fan\ Backup,rack=WEB43,row=North,source=web483,state=Enabled lower_threshold_fatal=0i,reading_rpm=2050i 1691270160000000000 redfish_power_powersupplies,address=127.0.0.1,chassis_chassistype=RackMount,chassis_health=OK,chassis_manufacturer=Contoso,chassis_model=3500RX,chassis_partnumber=224071-J23,chassis_powerstate=On,chassis_serialnumber=437XR1138R2,chassis_sku=8675309,chassis_state=Enabled,health=Warning,member_id=0,name=Power\ Supply\ Bay,rack=WEB43,row=North,source=web483,state=Enabled line_input_voltage=120,last_power_output_watts=325,power_capacity_watts=800 1691270160000000000 redfish_power_voltages,address=127.0.0.1,chassis_chassistype=RackMount,chassis_health=OK,chassis_manufacturer=Contoso,chassis_model=3500RX,chassis_partnumber=224071-J23,chassis_powerstate=On,chassis_serialnumber=437XR1138R2,chassis_sku=8675309,chassis_state=Enabled,health=OK,member_id=0,name=VRM1\ Voltage,rack=WEB43,row=North,source=web483,state=Enabled upper_threshold_fatal=15,lower_threshold_critical=11,lower_threshold_fatal=10,reading_volts=12,upper_threshold_critical=13 1691270160000000000 redfish_power_voltages,address=127.0.0.1,chassis_chassistype=RackMount,chassis_health=OK,chassis_manufacturer=Contoso,chassis_model=3500RX,chassis_partnumber=224071-J23,chassis_powerstate=On,chassis_serialnumber=437XR1138R2,chassis_sku=8675309,chassis_state=Enabled,health=OK,member_id=1,name=VRM2\ Voltage,rack=WEB43,row=North,source=web483,state=Enabled reading_volts=5,upper_threshold_critical=7,lower_threshold_critical=4.5 1691270160000000000 redfish_thermal_temperatures,address=127.0.0.1,chassis_chassistype=RackMount,chassis_health=OK,chassis_manufacturer=Contoso,chassis_model=3500RX,chassis_partnumber=224071-J23,chassis_powerstate=On,chassis_serialnumber=437XR1138R2,chassis_sku=8675309,chassis_state=Enabled,health=OK,member_id=0,name=CPU1\ Temp,rack=WEB43,row=North,source=web483,state=Enabled upper_threshold_critical=45,upper_threshold_fatal=48,reading_celsius=41 1691270170000000000 redfish_thermal_temperatures,address=127.0.0.1,chassis_chassistype=RackMount,chassis_health=OK,chassis_manufacturer=Contoso,chassis_model=3500RX,chassis_partnumber=224071-J23,chassis_powerstate=On,chassis_serialnumber=437XR1138R2,chassis_sku=8675309,chassis_state=Enabled,member_id=1,name=CPU2\ Temp,rack=WEB43,row=North,source=web483,state=Disabled upper_threshold_critical=45,upper_threshold_fatal=48 1691270170000000000 redfish_thermal_temperatures,address=127.0.0.1,chassis_chassistype=RackMount,chassis_health=OK,chassis_manufacturer=Contoso,chassis_model=3500RX,chassis_partnumber=224071-J23,chassis_powerstate=On,chassis_serialnumber=437XR1138R2,chassis_sku=8675309,chassis_state=Enabled,health=OK,member_id=2,name=Chassis\ Intake\ Temp,rack=WEB43,row=North,source=web483,state=Enabled lower_threshold_critical=5,lower_threshold_fatal=0,reading_celsius=25,upper_threshold_critical=40,upper_threshold_fatal=50 1691270170000000000 ``` #### Related - [Configure plugins](/telegraf/v1/configure_plugins/) - [Redfish Plugin Source](https://github.com/influxdata/telegraf/tree/v1.38.4/plugins/inputs/redfish/README.md)