README
¶
Redfish Input Plugin
The redfish
plugin gathers metrics and status information about CPU temperature, fanspeed, Powersupply, voltage, hostname and Location details (datacenter, placement, rack and room) of hardware servers for which DMTF's Redfish is enabled.
Telegraf minimum version: Telegraf 1.15.0
Configuration
[[inputs.redfish]]
## Redfish API Base URL.
address = "https://127.0.0.1:5000"
## Credentials for the Redfish API.
username = "root"
password = "password123456"
## System Id to collect data for in Redfish APIs.
computer_system_id="System.Embedded.1"
## 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
- address
- name
- 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)
- state
- health
- fields:
- reading_celsius
- upper_threshold_critical
- upper_threshold_fatal
- lower_threshold_critical
- lower_threshold_fatal
- tags:
- redfish_thermal_fans
- tags:
- source
- address
- name
- 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)
- state
- health
- fields:
- reading_rpm (or) reading_percent
- upper_threshold_critical
- upper_threshold_fatal
- lower_threshold_critical
- lower_threshold_fatal
- tags:
-
redfish_power_powersupplies
- tags:
- source
- address
- name
- 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)
- state
- health
- fields:
- last_power_output_watts
- line_input_voltage
- power_capacity_watts
- power_input_watts
- power_output_watts
- tags:
-
redfish_power_voltages (available only if voltage data is found)
- tags:
- source
- address
- name
- 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)
- state
- health
- fields:
- reading_volts
- upper_threshold_critical
- upper_threshold_fatal
- lower_threshold_critical
- lower_threshold_fatal
- tags:
Example Output
redfish_thermal_temperatures,source=test-hostname,name=CPU1,address=http://190.0.0.1,datacenter="Tampa",health="OK",rack="12",room="tbc",row="3",state="Enabled" reading_celsius=41,upper_threshold_critical=59,upper_threshold_fatal=64 1582114112000000000
redfish_thermal_temperatures,source=test-hostname,name=CPU2,address=http://190.0.0.1,datacenter="Tampa",health="OK",rack="12",room="tbc",row="3",state="Enabled" reading_celsius=51,upper_threshold_critical=59,upper_threshold_fatal=64 1582114112000000000
redfish_thermal_temperatures,source=test-hostname,name=SystemBoardInlet,address=http://190.0.0.1,datacenter="Tampa",health="OK",rack="12",room="tbc",row="3",state="Enabled" reading_celsius=23,upper_threshold_critical=59,upper_threshold_fatal=64 1582114112000000000
redfish_thermal_temperatures,source=test-hostname,name=SystemBoardExhaust,address=http://190.0.0.1,datacenter="Tampa",health="OK",rack="12",room="tbc",row="3",state="Enabled" reading_celsius=33,upper_threshold_critical=59,upper_threshold_fatal=64 1582114112000000000
redfish_thermal_fans,source=test-hostname,name=SystemBoardFan1A,address=http://190.0.0.1,datacenter="Tampa",health="OK",rack="12",room="tbc",row="3",state="Enabled" reading_rpm=17720,upper_threshold_critical=59,upper_threshold_fatal=64 1582114112000000000
redfish_thermal_fans,source=test-hostname,name=SystemBoardFan1B,address=http://190.0.0.1,datacenter="Tampa",health="OK",rack="12",room="tbc",row="3",state="Enabled" reading_rpm=17760,upper_threshold_critical=59,upper_threshold_fatal=64 1582114112000000000
redfish_thermal_fans,source=test-hostname,name=SystemBoardFan2A,address=http://190.0.0.1,datacenter="Tampa",health="OK",rack="12",room="tbc",row="3",state="Enabled" reading_rpm=17880,upper_threshold_critical=59,upper_threshold_fatal=64 1582114112000000000
redfish_power_powersupplies,source=test-hostname,name=PS1Status,address=http://190.0.0.1,datacenter="Tampa",health="OK",rack="12",room="tbc",row="3",state="Enabled" power_capacity_watts=750,power_input_watts=900,power_output_watts=208,last_power_output_watts=98,line_input_reading_volts=204 1582114112000000000
redfish_power_powersupplies,source=test-hostname,name=PS2Status,address=http://190.0.0.1,datacenter="Tampa",health="OK",rack="12",room="tbc",row="3",state="Enabled" power_capacity_watts=750,power_input_watts=900,power_output_watts=194,last_power_output_watts=98,line_input_reading_volts=204 1582114112000000000
redfish_power_voltages,source=test-hostname,name=CPU1MEM345,address=http://190.0.0.1,datacenter="Tampa",health="OK",rack="12",room="tbc",row="3",state="Enabled" reading_volts=1,upper_threshold_critical=59,upper_threshold_fatal=64 1582114112000000000
redfish_power_voltages,source=test-hostname,name=CPU1MEM345,address=http://190.0.0.1,datacenter="Tampa",health="OK",rack="12",room="tbc",row="3",state="Enabled" reading_volts=1,upper_threshold_critical=59,upper_threshold_fatal=64 1582114112000000000
redfish_power_voltages,source=test-hostname,name=CPU1MEM347,address=http://190.0.0.1,datacenter="Tampa",health="OK",rack="12",room="tbc",row="3",state="Enabled" reading_volts=1,upper_threshold_critical=59,upper_threshold_fatal=64 1582114112000000000
redfish_power_voltages,source=test-hostname,name=PS1voltage1,address=http://190.0.0.1,datacenter="Tampa",health="OK",rack="12",room="tbc",row="3",state="Enabled" reading_volts=208,upper_threshold_critical=59,upper_threshold_fatal=64 1582114112000000000
Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Power ¶
type Power struct { PowerSupplies []struct { Name string PowerInputWatts *float64 PowerCapacityWatts *float64 PowerOutputWatts *float64 LastPowerOutputWatts *float64 Status Status LineInputVoltage *float64 } Voltages []struct { Name string ReadingVolts *float64 UpperThresholdCritical *float64 UpperThresholdFatal *float64 LowerThresholdCritical *float64 LowerThresholdFatal *float64 Status Status } }
type Redfish ¶
type Redfish struct { Address string `toml:"address"` Username string `toml:"username"` Password string `toml:"password"` ComputerSystemId string `toml:"computer_system_id"` Timeout config.Duration `toml:"timeout"` tls.ClientConfig // contains filtered or unexported fields }
func (*Redfish) Description ¶
func (*Redfish) SampleConfig ¶
type Thermal ¶
type Thermal struct { Fans []struct { Name string Reading *int64 ReadingUnits *string UpperThresholdCritical *int64 UpperThresholdFatal *int64 LowerThresholdCritical *int64 LowerThresholdFatal *int64 Status Status } Temperatures []struct { Name string ReadingCelsius *float64 UpperThresholdCritical *float64 UpperThresholdFatal *float64 LowerThresholdCritical *float64 LowerThresholdFatal *float64 Status Status } }
Click to show internal directories.
Click to hide internal directories.