Skip to content

Exporter for Prometheus using the Redfish protocol for server monitoring

License

Notifications You must be signed in to change notification settings

sapcc/redfish-exporter

Folders and files

NameName
Last commit message
Last commit date
Nov 11, 2024
Oct 23, 2023
Jul 17, 2024
Jun 4, 2020
Oct 13, 2023
Dec 10, 2024
Oct 17, 2023
May 8, 2024
Nov 6, 2024
Nov 6, 2024
Jun 4, 2020
Apr 22, 2022
Nov 24, 2023

Repository files navigation

Redfish-Exporter

This is a Prometheus Exporter for extracting metrics from a server using the Redfish API. The hostname of the server has to be passed as target parameter in the http call.

It has been tested with the following server models:

Cisco UCS C480M5, working properly since BMC FW 4.1(1d)
Cisco UCS C240M4
Cisco UCS C240M5
Cisco UCS C220M4
Cisco UCS C220M5

Cisco BMC FW below 4.x has its flaws regarding redfish API. Hence, I recommend updating at least to 4.0(1c).

Dell PowerEdge R640
Dell PowerEdge R730
Dell PowerEdge R740
Dell PowerEdge R640
Dell PowerEdge R840

Lenovo ThinkSystem SR950

HPE DL360 Gen10
HPE DL560 Gen10

Example Call

If you are logged into the POD running the exporter, you can call

curl http://localhost:9200/redfish?target=server1.example.com&job=redfish-myjob

Prerequisites and Installation

The exporter was written for Python 3.6 or newer. To install all modules needed you have to run the following command:

pip3 install --no-cache-dir -r requirements.txt

There is also a docker file available to create a docker container to run the exporter.

Parameters

-l <logfile> - all output is written to a logfile.

-d - switches on debugging mode

-c <config file> - you can specify the path to the config file, default is config.yml.

The config.yml file

  • The listen_port is providing the port on which the exporter is waiting to receive calls. It is overwritten by the environment variable LISTEN_PORT.

  • The credentials for login to the switches can either be added to the config.yaml file or passed via environment variables. The environment variables are taking precedence over the entries in config.yaml file.

    The mapping of job names to environment variables follows a schema: REDFISH_JOB1_USERNAME and REDFISH_JOB1_PASSWORD would be the variables for example of the first job called redfish/job1. A slash gets replaced by underscore and everything gets converted to uppercase.

  • The timeout parameter specifies the amount of time to wait for an answer from the server. Again this can alos be provided via TIMEOUT environment variable.

  • The job parameter specifies the Prometheus job that will be passed as label if no job was handed over during the API call.

Example of a config file

listen_port: 9200
username: <your username>
password: <your password>
timeout: 40
job: 'redfish-myjob'

Exported Metrics

All metrics returned by the redfish exporter are gauge metrics.

redfish_up

Indicating if the redfish API was giving useful data back (== 1) or not (== 0).

redfish_health

Show the health information of the hardware parts like processor, memory, storage controllers, disks, fans, power and chassis if available.

redfish_memory_correctable

redfish_memory_uncorrectable

Showing the count of errors per dimm.

Cisco servers do not seem to provide this kind of information via redfish. Dell PowerEdge servers only with certain DIMM manufacturers (Samsung not, Micron Technology and Hynix Semiconductor do).

redfish_powerstate

Showing the powerstate of the server

redfish_response_duration_seconds

The duration of the first response of the server to a call to /redfish/v1

redfish_up

Metric indicating if there was a valid redfish response while calling /redfish/v1

redfish_scrape_duration_seconds

Total duration of scarping all data from the server

redfish_firmware

A collection of firmware version data stored in the labels. The value is always 1.

About

Exporter for Prometheus using the Redfish protocol for server monitoring

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published