Explain how to gather diagnostic information for Red Hat products (RHEL, OpenShift, Ansible Automation Platform, Satellite) to share with Red Hat Technical Support.
78%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Passed
No findings from the security scan
Fix and improve this skill with Tessl
tessl review fix ./rh-basic/skills/red-hat-diagnostics/SKILL.mdIdentify product and deployment type. If unclear, ask. Provide specific commands and upload instructions. If product not listed, use WebFetch on Red Hat docs -- sos report covers most RHEL-based products through plugins.
None.
When the user needs to collect diagnostic data for a Red Hat support case.
None — all commands reference standard Red Hat tooling available on target systems.
dnf install sos
sos reportOutput: .tar.xz in /var/tmp/. Specific subsystems: sos report --only-plugins networking,storage
oc adm must-gather --dest-dir ./must-gather
tar cvaf must-gather.tar.gz ./must-gather*/Specific operators: oc adm must-gather --image=<component-must-gather-image> --dest-dir ./must-gather
If registry.redhat.io unavailable: oc adm inspect <resource-type>/<resource-name>
Ask deployment type if not specified -- tool differs significantly.
VM/RPM-based: sos report (includes AAP plugins automatically)
Containerized:
ansible-playbook -i <path_to_inventory> ansible.containerized_installer.log_gathering \
-e 'target_sos_directory=/tmp/aap-logs' \
-e 'case_number=<your_case_number>' \
-e 'clean=true' \
-e 'upload=true'Omit upload=true to collect locally first.
OCP-based (Operator):
# AAP 2.6
oc adm must-gather \
--image=registry.redhat.io/ansible-automation-platform-26/aap-must-gather-rhel9 \
--dest-dir ./must-gather \
-- /usr/bin/ns-gather <namespace>
# AAP 2.5
oc adm must-gather \
--image=registry.redhat.io/ansible-automation-platform-25/aap-must-gather-rhel8 \
--dest-dir ./must-gather \
-- /usr/bin/ns-gather <namespace>Then: tar cvaf aap-must-gather.tar.gz ./must-gather*/
sos report
foreman-debug -d /tmp/foreman-debugsos report includes the satellite plugin automatically. foreman-debug provides deeper Foreman/Katello data.
Important: Diagnostic archives (sos reports, must-gather bundles) collect comprehensive system data including configuration files, logs, and network details. Review the archive contents before sharing and redact any secrets or sensitive data you do not want to expose to a third party.
Attach archives at access.redhat.com/support. Large files: ftp://dropbox.redhat.com or Customer Portal file upload API.
WebFetch -> https://docs.redhat.com/en/documentation/red_hat_ansible_automation_platform/2.6/html/troubleshooting_ansible_automation_platform/diagnosing-the-problemWebFetch -> https://docs.redhat.com/en/documentation/openshift_container_platform/4.17/html/support/gathering-cluster-dataWebFetch -> https://access.redhat.com/solutions/3592RHEcosystemAppEng/agentic-plugins
df1d156
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.