@@ -28,8 +28,11 @@ endif::[]
28
28
29
29
* You must be logged in to the {product-title} cluster as a user with the `cluster-admin` role.
30
30
* You must have the OpenShift CLI (`oc` ) installed.
31
+
32
+ ifdef::oadp-troubleshooting[]
31
33
* You must use {op-system-base-full} 8.x with OADP 1.2.
32
34
* You must use {op-system-base-full} {op-system-version} with OADP 1.3.
35
+ endif::[]
33
36
34
37
.Procedure
35
38
@@ -38,27 +41,40 @@ endif::[]
38
41
39
42
ifdef::troubleshooting-3-4,troubleshooting-mtc[]
40
43
* To collect data for the past hour:
44
+ +
45
+ [source,terminal]
46
+ ----
47
+ $ oc adm must-gather -- image=registry.redhat.io/rhmtc/openshift-migration-must-gather-rhel8:v1.8
48
+ ----
49
+ +
50
+ The data is saved as `must-gather/must-gather.tar.gz` . You can upload this file to a support case on the link:https://access.redhat.com/[Red Hat Customer Portal].
51
+ * To collect data for the past 24 hours:
52
+ +
53
+ [source,terminal]
54
+ ----
55
+ $ oc adm must-gather -- image=registry.redhat.io/rhmtc/openshift-migration-must-gather-rhel8:v1.8 -- /usr/bin/gather_metrics_dump
56
+ ----
57
+ +
58
+ This operation can take a long time. The data is saved as `must-gather/metrics/prom_data.tar.gz` .
41
59
endif::[]
42
60
ifdef::oadp-troubleshooting[]
43
61
* Full `must-gather` data collection, including Prometheus metrics:
44
- endif::[]
45
62
.. For OADP 1.2, use the following command:
46
63
+
47
64
[source,terminal]
48
65
----
49
- oc adm must-gather -- image=registry.redhat.io/oadp/oadp-mustgather-rhel8:v1.2
66
+ $ oc adm must-gather -- image=registry.redhat.io/oadp/oadp-mustgather-rhel8:v1.2
50
67
----
51
68
+
52
69
.. For OADP 1.3, use the following command:
53
70
+
54
71
[source,terminal]
55
72
----
56
- oc adm must-gather --image=registry.redhat.io/oadp/oadp-mustgather-rhel9:v1.3
73
+ $ oc adm must-gather --image=registry.redhat.io/oadp/oadp-mustgather-rhel9:v1.3
57
74
----
58
75
+
59
76
The data is saved as `must-gather/must-gather.tar.gz` . You can upload this file to a support case on the link:https://access.redhat.com/[Red Hat Customer Portal].
60
77
61
- ifdef::oadp-troubleshooting[]
62
78
* Essential `must-gather` data collection, without Prometheus metrics, for a specific time duration:
63
79
+
64
80
[source,terminal,subs="attributes+"]
@@ -76,24 +92,20 @@ $ oc adm must-gather --image={must-gather} \
76
92
-- /usr/bin/gather_with_timeout <timeout> <1>
77
93
----
78
94
<1> Specify a timeout value in seconds.
79
- endif::[]
80
- ifdef::troubleshooting-3-4,troubleshooting-mtc[]
81
- * To collect data for the past 24 hours:
82
- endif::[]
83
- ifdef::oadp-troubleshooting[]
95
+
84
96
* Prometheus metrics data dump:
85
- endif::[]
97
+
86
98
.. For OADP 1.2, use the following command:
87
99
+
88
100
[source,terminal]
89
101
----
90
- oc adm must-gather --image=registry.redhat.io/oadp/oadp-mustgather-rhel8:v1.2 -- /usr/bin/gather_metrics_dump
102
+ $ oc adm must-gather --image=registry.redhat.io/oadp/oadp-mustgather-rhel8:v1.2 -- /usr/bin/gather_metrics_dump
91
103
----
92
104
.. For OADP 1.3, use the following command:
93
105
+
94
106
[source,terminal]
95
107
----
96
- oc adm must-gather --image=registry.redhat.io/oadp/oadp-mustgather-rhel9:v1.3 -- /usr/bin/gather_metrics_dump
108
+ $ oc adm must-gather --image=registry.redhat.io/oadp/oadp-mustgather-rhel9:v1.3 -- /usr/bin/gather_metrics_dump
97
109
----
98
110
This operation can take a long time. The data is saved as `must-gather/metrics/prom_data.tar.gz`.
99
-
111
+ endif::[]
0 commit comments