Skip to content

Commit 52d9da0

Browse files
committed
OBSDOCS-1527: Add missing information to the monitoring dashboards section
1 parent 662ad2d commit 52d9da0

7 files changed

+67
-44
lines changed
-62.1 KB
Loading

modules/monitoring-querying-metrics-for-all-projects-as-an-administrator.adoc

Lines changed: 22 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,8 @@ Only dedicated administrators have access to the third-party UIs provided with {
2323
====
2424
endif::openshift-dedicated,openshift-rosa[]
2525

26+
The Metrics UI includes predefined queries, for example, CPU, memory, bandwidth, or network packet for all projects. You can also run custom Prometheus Query Language (PromQL) queries.
27+
2628
.Prerequisites
2729

2830
ifndef::openshift-dedicated,openshift-rosa[]
@@ -35,58 +37,58 @@ endif::openshift-dedicated,openshift-rosa[]
3537

3638
.Procedure
3739

38-
. From the *Administrator* perspective in the {product-title} web console, select *Observe* -> *Metrics*.
40+
. In the *Administrator* perspective of the {product-title} web console, click *Observe* and go to the *Metrics* tab.
3941

40-
. To add one or more queries, do any of the following:
42+
. To add one or more queries, perform any of the following actions:
4143
+
4244
|===
4345
|Option |Description
4446

47+
|Select an existing query.
48+
|From the *Select query* drop-down list, select an existing query.
49+
4550
|Create a custom query.
4651
|Add your Prometheus Query Language (PromQL) query to the *Expression* field.
4752

4853
As you type a PromQL expression, autocomplete suggestions appear in a drop-down list. These suggestions include functions, metrics, labels, and time tokens.
49-
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.
54+
Use the keyboard arrows to select one of these suggested items and then press Enter to add the item to your expression. Move your mouse pointer over a suggested item to view a brief description of that item.
5055

51-
|Add multiple queries. |Select *Add query*.
56+
|Add multiple queries. |Click *Add query*.
5257

53-
|Duplicate an existing query. |Select the Options menu {kebab} next to the query, then choose *Duplicate query*.
58+
|Duplicate an existing query. |Click the options menu {kebab} next to the query, then choose *Duplicate query*.
5459

55-
|Disable a query from being run. |Select the Options menu {kebab} next to the query and choose *Disable query*.
60+
|Disable a query from being run. |Click the options menu {kebab} next to the query and choose *Disable query*.
5661
|===
5762

58-
. To run queries that you created, select *Run queries*. The metrics from the queries are visualized on the plot. If a query is invalid, the UI shows an error message.
63+
. 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.
5964
+
6065
[NOTE]
6166
====
62-
Queries that operate on large amounts of data might time out or overload the browser when drawing time series graphs. To avoid this, select *Hide graph* and calibrate your query using only the metrics table. Then, after finding a feasible query, enable the plot to draw the graphs.
63-
====
64-
+
65-
[NOTE]
66-
====
67-
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.
67+
* When drawing time series graphs, queries that operate on large amounts of data might time out or overload the browser. To avoid this, click *Hide graph* and calibrate your query by using only the metrics table. Then, after finding a feasible query, enable the plot to draw the graphs.
68+
69+
* By default, the query table shows an expanded view that lists every metric and its current value. Click the *˅* down arrowhead to minimize the expanded view for a query.
6870
====
6971
7072
. Optional: The page URL now contains the queries you ran. To use this set of queries again in the future, save this URL.
7173

72-
. Explore the visualized metrics. Initially, all metrics from all enabled queries are shown on the plot. You can select which metrics are shown by doing any of the following:
74+
. Explore the visualized metrics. Initially, all metrics from all enabled queries are shown on the plot. Select which metrics are shown by performing any of the following actions:
7375
+
7476
|===
7577
|Option |Description
7678

77-
|Hide all metrics from a query. |Click the Options menu {kebab} for the query and click *Hide all series*.
79+
|Hide all metrics from a query. |Click the options menu {kebab} for the query and click *Hide all series*.
7880

7981
|Hide a specific metric. |Go to the query table and click the colored square near the metric name.
8082

8183
|Zoom into the plot and change the time range.
82-
a|Either:
84+
a|Perform one of the following actions:
8385

8486
* Visually select the time range by clicking and dragging on the plot horizontally.
85-
* Use the menu in the left upper corner to select the time range.
87+
* Use the menu to select the time range.
8688
87-
|Reset the time range. |Select *Reset zoom*.
89+
|Reset the time range. |Click *Reset zoom*.
8890

89-
|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.
91+
|Display outputs for all queries at a specific point in time. |Hover over the plot at the point you are interested in. The query outputs appear in a pop-up box.
9092

91-
|Hide the plot. |Select *Hide graph*.
93+
|Hide the plot. |Click *Hide graph*.
9294
|===

modules/monitoring-querying-metrics-for-user-defined-projects-as-a-developer.adoc

Lines changed: 40 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99

1010
You can access metrics for a user-defined project as a developer or as a user with view permissions for the project.
1111

12-
In the *Developer* perspective, the Metrics UI includes some predefined CPU, memory, bandwidth, and network packet queries for the selected project. You can also run custom Prometheus Query Language (PromQL) queries for CPU, memory, bandwidth, network packet and application metrics for the project.
12+
The Metrics UI includes predefined queries, for example, CPU, memory, bandwidth, or network packet. These queries are restricted to the selected project. You can also run custom Prometheus Query Language (PromQL) queries for the project.
1313

1414
[NOTE]
1515
====
@@ -28,29 +28,60 @@ endif::openshift-dedicated,openshift-rosa[]
2828
2929
.Procedure
3030

31-
. From the *Developer* perspective in the {product-title} web console, select *Observe* -> *Metrics*.
31+
. In the *Developer* perspective of the {product-title} web console, click *Observe* and go to the *Metrics* tab.
3232

3333
. Select the project that you want to view metrics for in the *Project:* list.
3434

35-
. Select a query from the *Select query* list, or create a custom PromQL query based on the selected query by selecting *Show PromQL*. The metrics from the queries are visualized on the plot.
35+
. To add one or more queries, perform any of the following actions:
36+
+
37+
|===
38+
|Option |Description
39+
40+
|Select an existing query.
41+
|From the *Select query* drop-down list, select an existing query.
42+
43+
|Create a custom query.
44+
|Add your Prometheus Query Language (PromQL) query to the *Expression* field.
45+
46+
As you type a PromQL expression, autocomplete suggestions appear in a drop-down list. These suggestions include functions, metrics, labels, and time tokens.
47+
Use the keyboard arrows to select one of these suggested items and then press Enter to add the item to your expression. Move your mouse pointer over a suggested item to view a brief description of that item.
48+
49+
|Add multiple queries. |Click *Add query*.
50+
51+
|Duplicate an existing query. |Click the options menu {kebab} next to the query, then choose *Duplicate query*.
52+
53+
|Disable a query from being run. |Click the options menu {kebab} next to the query and choose *Disable query*.
54+
|===
55+
56+
. 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.
3657
+
3758
[NOTE]
3859
====
39-
In the Developer perspective, you can only run one query at a time.
60+
* When drawing time series graphs, queries that operate on large amounts of data might time out or overload the browser. To avoid this, click *Hide graph* and calibrate your query by using only the metrics table. Then, after finding a feasible query, enable the plot to draw the graphs.
61+
62+
* By default, the query table shows an expanded view that lists every metric and its current value. Click the *˅* down arrowhead to minimize the expanded view for a query.
4063
====
4164
42-
. Explore the visualized metrics by doing any of the following:
65+
. Optional: The page URL now contains the queries you ran. To use this set of queries again in the future, save this URL.
66+
67+
. Explore the visualized metrics. Initially, all metrics from all enabled queries are shown on the plot. Select which metrics are shown by performing any of the following actions:
4368
+
4469
|===
4570
|Option |Description
4671

72+
|Hide all metrics from a query. |Click the options menu {kebab} for the query and click *Hide all series*.
73+
74+
|Hide a specific metric. |Go to the query table and click the colored square near the metric name.
75+
4776
|Zoom into the plot and change the time range.
48-
a|Either:
77+
a|Perform one of the following actions:
4978

5079
* Visually select the time range by clicking and dragging on the plot horizontally.
51-
* Use the menu in the left upper corner to select the time range.
80+
* Use the menu to select the time range.
81+
82+
|Reset the time range. |Click *Reset zoom*.
5283

53-
|Reset the time range. |Select *Reset zoom*.
84+
|Display outputs for all queries at a specific point in time. |Hover over the plot at the point you are interested in. The query outputs appear in a pop-up box.
5485

55-
|Display outputs for all queries at a specific point in time. |Hold the mouse cursor on the plot at that point. The query outputs appear in a pop-up box.
86+
|Hide the plot. |Click *Hide graph*.
5687
|===

modules/monitoring-reviewing-monitoring-dashboards-admin.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ endif::openshift-dedicated,openshift-rosa[]
1919

2020
.Procedure
2121

22-
. In the *Administrator* perspective in the {product-title} web console, navigate to *Observe* -> *Dashboards*.
22+
. In the *Administrator* perspective of the {product-title} web console, go to *Observe* -> *Dashboards*.
2323

2424
. Choose a dashboard in the *Dashboard* list. Some dashboards, such as *etcd* and *Prometheus* dashboards, produce additional sub-menus when selected.
2525

modules/monitoring-reviewing-monitoring-dashboards-developer.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ In the *Developer* perspective, you can view dashboards relating to a selected p
1515
1616
.Procedure
1717

18-
. In the Developer perspective in the {product-title} web console, navigate to *Observe* -> *Dashboard*.
18+
. In the Developer perspective in the {product-title} web console, click *Observe* and go to the *Dashboards* tab.
1919

2020
. Select a project from the *Project:* drop-down list.
2121

modules/sd-monitoring-troubleshooting-issues.adoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,9 +12,9 @@ If metrics are not displaying when monitoring user-defined projects, follow thes
1212
.Procedure
1313

1414
. Query the metric name and verify that the project is correct:
15-
.. From the *Developer* perspective in the web console, select *Observe* -> *Metrics*.
15+
.. In the *Developer* perspective of the web console, click *Observe* and go to the *Metrics* tab.
1616
.. Select the project that you want to view metrics for in the *Project:* list.
17-
.. Choose a query from the *Select query* list, or run a custom PromQL query by selecting *Show PromQL*.
17+
.. Select an existing query from the *Select query* list, or run a custom query by adding a PromQL query to the *Expression* field.
1818
+
1919
The metrics are displayed in a chart.
2020
+

observability/monitoring/reviewing-monitoring-dashboards.adoc

Lines changed: 1 addition & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -26,21 +26,11 @@ Use the *Administrator* perspective to access dashboards for the core {product-t
2626
.Example dashboard in the Administrator perspective
2727
image::monitoring-dashboard-administrator.png[]
2828

29-
Use the *Developer* perspective to access Kubernetes compute resources dashboards that provide the following application metrics for a selected project:
30-
31-
* CPU usage
32-
* Memory usage
33-
* Bandwidth information
34-
* Packet rate information
29+
In the *Developer* perspective, you can access only the Kubernetes compute resources dashboards:
3530

3631
.Example dashboard in the Developer perspective
3732
image::observe-dashboard-developer.png[]
3833

39-
[NOTE]
40-
====
41-
In the *Developer* perspective, you can view dashboards for only one project at a time.
42-
====
43-
4434
// Reviewing monitoring dashboards as a cluster administrator
4535
include::modules/monitoring-reviewing-monitoring-dashboards-admin.adoc[leveloffset=+1]
4636

0 commit comments

Comments
 (0)