Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 6 additions & 12 deletions modules/about-must-gather.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -23,18 +23,15 @@ Alternatively, you can collect specific information by running the command with

* To collect data related to one or more specific features, use the `--image` argument with an image, as listed in a following section.
+
For example:
+
.Example command
[source,terminal,subs="attributes+"]
----
$ oc adm must-gather \
--image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel9:v{HCOVersion}
$ oc adm must-gather --image=registry.redhat.io/openshift-gitops-1/must-gather-rhel8:v1.10.0
----

* To collect the audit logs, use the `-- /usr/bin/gather_audit_logs` argument, as described in a following section.
+
For example:
+
.Example command
[source,terminal]
----
$ oc adm must-gather -- /usr/bin/gather_audit_logs
Expand All @@ -47,8 +44,7 @@ Audit logs are not collected as part of the default set of information to reduce

When you run `oc adm must-gather`, a new pod with a random name is created in a new project on the cluster. The data is collected on that pod and saved in a new directory that starts with `must-gather.local`. This directory is created in the current working directory.

For example:

.Example pod
[source,terminal]
----
NAMESPACE NAME READY STATUS RESTARTS AGE
Expand All @@ -60,10 +56,8 @@ openshift-must-gather-5drcj must-gather-s8sdh 2/2 Running 0
// todo: table or ref module listing available images?
Optionally, you can run the `oc adm must-gather` command in a specific namespace by using the `--run-namespace` option.

For example:

.Example command
[source,terminal,subs="attributes+"]
----
$ oc adm must-gather --run-namespace <namespace> \
--image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel9:v{HCOVersion}
$ oc adm must-gather --image=registry.redhat.io/openshift-gitops-1/must-gather-rhel8:v1.10.0
----