Prometheus monitor

LoadRunner Professional's integration with Prometheus fetches data collected by Prometheus and displays it in Controller and Analysis.

This monitor is available from LoadRunner Professional 2022 R1.

Prometheus monitor overview

Prometheus is a systems monitoring and alerting application that records real-time metrics in a time series database. LoadRunner Professional's Prometheus monitor fetches measurements from the Prometheus server and displays them during the scenario run in Controller's online Prometheus graph. For example, if you use Prometheus to monitor your load generator machine, you can select Prometheus measurements related to the load generator to display in LoadRunner Professional.

We recommend using the latest stable version of Prometheus when working with LoadRunner Professional's Prometheus integration.

Back to top

Set up the Prometheus monitor

Set up the Prometheus monitor to collect data from the Prometheus server.

To set up the Prometheus monitor:

  1. In Controller, in the Run tab, select Graphs > Prometheus Graphs > Prometheus.

    The Prometheus graph opens in the display area.

  2. In the Prometheus graph display box, click Add measurements.

  3. In the displayed Prometheus dialog box, in the Monitored Server Machines area, click Add.

  4. In the displayed Host Selection dialog box, enter the host URL and port number to connect to the Prometheus server, and click Connect. When you have successfully connected, the Resource Measurements area of the Prometheus dialog box becomes active.

  5. In the Resource Measurements area, click Add.

  6. In the displayed Add Measurements dialog box, select the measurements to display in the graph. You can select measurements from the Available measurements list. In addition, you can add custom measurements by creating a custom Prometheus query that adds measurements based on parameters you define.

    To add custom measurements:

    1. Select a measurement from the Available measurements list to serve as the basis for your custom query. Make sure that only one measurement is selected.

    2. Click Custom.

    3. In the Customize query dialog box, enter your custom query. The query must be based on the selected measurement and must be written in PromQL, Prometheus's functional query language. For more information, refer to the Querying Prometheus information in the Prometheus product documentation.

    4. Click OK. All measurements that match the custom query are added to the Selected measurements list.

    Example: The following custom query is based on the go_gc_heap_allocs_by_size_bytes_total_bucket measurement. Two parameters are added to the query. The first parameter restricts the query to the instance localhost:9090, and the second parameter instructs the query to find measurements in which le matches the regular expression ".*".

    go_gc_heap_allocs_by_size_bytes_total_bucket{instance="localhost:9090", le=~".*"}

    When the above custom query is entered into the Customize query dialog box, all measurements that match the query are added to the Selected measurements list:

  7. When done, click OK in the Add Measurements dialog box. The measurements are displayed in the Resource Measurements pane of the Prometheus dialog box.

  8. Click OK in the Prometheus dialog box. When you run the scenario, the selected measurements are displayed in the graph.

Back to top

See also: