must-gather a debugging výpadkov
Ako zozbierať dáta pre Red Hat support case.
`oc adm must-gather` je primárny nástroj pre zber diagnostických dát z OpenShift klastra. Spustí špeciálny pod, ktorý zbiera logy, cluster resource state, node info, kubelet journal, events a stav všetkých cluster operátorov. Výstup je tar.gz do lokálneho adresára.
Základné použitie: `oc adm must-gather --dest-dir=./gather`. Default image je verzia matching cluster – ak riešiš problém so špecifickým komponentom, existujú custom must-gather images: `registry.redhat.io/openshift-service-mesh/istio-must-gather-rhel8:2.6` pre Service Mesh, `registry.redhat.io/odf4/ocs-must-gather-rhel9:v4.15` pre ODF, atď.
Pre špecifické situácie pridaj `-- /usr/bin/gather_<something>` – napríklad `oc adm must-gather -- /usr/bin/gather_audit_logs` pre API audit logy alebo `gather_network_logs` pre networking. Zoznam gatherov je v `/usr/bin/` v must-gather image, môžeš si ich pozrieť cez `oc debug`.
Ako čítať výstup: začni súborom `event-filter.html` (grafický pohľad na events), potom `namespaces/<ns>/pods/<pod>/logs/` pre konkrétny pod, `cluster-scoped-resources/config.openshift.io/clusterversions/version.yaml` pre upgrade state. Adresár `quay-io-openshift-release-dev-ocp-release-*` obsahuje inspection cluster operátorov – tam nájdeš, prečo je Degraded.
Support case workflow: (1) reproduce problém, ak sa dá; (2) spusti must-gather okamžite po výskyte (staré logy sa točia v journalct); (3) attach tar.gz na case cez access.redhat.com; (4) pre performance issues doplň `sos report` z nodov cez `oc adm node-logs`. Nikdy neposielaj len screenshot z konzoly – Red Hat support ho vráti so žiadosťou o must-gather.