Chapter 8. Querying metrics

Procedure

1. From the Administrator perspective of the OpenShift Container Platform web console, go to Observe Metrics.

2. To add one or more queries, perform any of the following actions:

   Option	Description
   Create a custom query.	Add your Prometheus Query Language (PromQL) query to the Expression field. As you type a PromQL expression, autocomplete suggestions are displayed in a list. These suggestions include functions, metrics, labels, and time tokens. You can use the keyboard arrows to select one of these suggested items and then press Enter to add the item to your expression. You can also move your mouse pointer over a suggested item to view a brief description of that item.
   Add multiple queries.	Click Add query.
   Duplicate an existing query.	Click the Options menu next to the query and select Duplicate query.
   Delete a query.	Click the Options menu next to the query and select Delete query.
   Disable a query from being run.	Click the Options menu next to the query and select Disable query.

3. To run queries that you created, click Run queries. The metrics from the queries are visualized on the plot. If a query is invalid, the UI shows an error message.

   Note

   Queries that operate on large amounts of data might time out or overload the browser when drawing time series graphs. To avoid this, click Hide graph and calibrate your query by using the metrics table. After finding a feasible query, enable the plot to draw the graphs.

4. Optional: The page URL now contains the queries you ran. To use this set of queries again in the future, save this URL.

Procedure

1. Select the Developer perspective in the OpenShift Container Platform web console.
2. Select Observe Metrics.
3. Select the project that you want to view metrics for in the Project: list.
4. Select a query from the Select query list, or create a custom PromQL query based on the selected query by selecting Show PromQL.

5. Optional: Select Custom query from the Select query list to enter a new query. As you type, autocomplete suggestions appear in a drop-down list. These suggestions include functions and metrics. Click a suggested item to select it.

   Note

   In the Developer perspective, you can only run one query at a time.

1. Initially, all metrics from all enabled queries are shown on the plot. You can select which metrics are shown.

   Note

   By default, the query table shows an expanded view that lists every metric and its current value. You can select ˅ to minimize the expanded view for a query.

   • To hide all metrics from a query, click for the query and click Hide all series.
   • To hide a specific metric, go to the query table and click the colored square near the metric name.

2. To zoom into the plot and change the time range, do one of the following:

   • Visually select the time range by clicking and dragging on the plot horizontally.
   • Use the menu in the left upper corner to select the time range.
3. To reset the time range, select Reset zoom.
4. To display outputs for all queries at a specific point in time, hold the mouse cursor on the plot at that point. The query outputs will appear in a pop-up box.
5. To hide the plot, select Hide graph.

1. To zoom into the plot and change the time range, do one of the following:

   • Visually select the time range by clicking and dragging on the plot horizontally.
   • Use the menu in the left upper corner to select the time range.
2. To reset the time range, select Reset zoom.
3. To display outputs for all queries at a specific point in time, hold the mouse cursor on the plot at that point. The query outputs will appear in a pop-up box.