Recopilación de información de depuración con sos

El comando sos recopila información sobre un sistema, como la configuración de hardware, la configuración de software y el estado operativo. También puede utilizar el comando sos report para activar las funciones analíticas y de diagnóstico en el sistema actual.

Archivos de configuración del sistema
Información de Hardware
Ejecución de procesos y servicios
Detalles de núcleo
Archivos Log
Salida de comandos específicos del sistema

El informe generado es útil en los casos en los que los Servicios de Soporte Oracle le ayudan a solucionar un problema en el sistema. El representante de soporte puede utilizar el informe para obtener una imagen exacta del sistema, sus recursos y todas las aplicaciones y procesos que existen en el sistema, así como todos los demás datos que pueden ayudar a encontrar las causas de los problemas que está experimentando.

La utilidad sos requiere la instalación del paquete sos. En las imágenes de la plataforma Oracle Linux, la utilidad sos está instalada de manera predeterminada.

Si utiliza otra imagen de Linux, compruebe si la utilidad sos está instalada.

Compruebe si la utilidad sos está instalada:
```
rpm -q sos
```
Si la utilidad sos está instalada, el comando devuelve la versión instalada:
```
sos-4.7.2-2.0.2.el8_10.noarch
```
Si no tiene la utilidad sos, instale el paquete ejecutando:
```
sudo dnf install sos
```

Referencia de comando sos

Esta tabla proporciona información sobre el comando sos.


Acción	Comando	Descripción
Cree el informe `sos`.	`sos report`	Recopila toda la información de diagnóstico y configuración del sistema y de las aplicaciones instaladas.
Oculte la información confidencial del informe `sos`.	`sos clean`	Oculta información en un informe existente antes de que se proporcione a los Servicios de Soporte Oracle.

Para obtener una lista de opciones y argumentos que puede utilizar con la utilidad sos, ejecute el siguiente comando:

sos report -h

optional arguments:
  -h, --help            show this help message and exit
                
Global Options:
  --batch               Do not prompt interactively
  --config-file CONFIG_FILE
                        specify alternate configuration file
...

Nota

Para obtener más información, escriba man sos o consulte la documentación del usuario de SOS.

Creación del Informe sos

Para recopilar información de diagnóstico y configuración del sistema y sus aplicaciones instaladas, genere un informe ejecutando el comando sos report como raíz. Si está generando el informe como relacionado con un caso de solución de problemas específico, pulse Intro para continuar e introduzca el ID de caso.

sudo sos report

sos report (version 4.8.1)

This command will collect diagnostic and configuration information from
this Oracle Linux system and installed applications.

An archive containing the collected information will be generated in
/var/tmp/sos.s4zah5s1 and may be provided to a Oracle America support
representative.

Any information provided to Oracle America will be treated in accordance
with the published support policies at:

        Distribution Website : https://support.oracle.com/
        Commercial Support   : https://support.oracle.com/

The generated archive may contain data considered sensitive and its
content should be reviewed by the originating organization before being
passed to any third party.
No changes will be made to system configuration.
Press ENTER to continue, or CTRL-C to quit.
Optionally, please enter the case id that you are generating this report for []:

El informe se genera como un archivo tar comprimido en xa en el directorio /var/tmp. En el nombre de archivo del informe, la utilidad crea ID de forma dinámica.

Importante

Al ponerse en contacto con los Servicios de Soporte Oracle para diagnosticar y solucionar los problemas que ha observado en el sistema, tenga en cuenta que el informe contiene información confidencial específica de la compañía. Asegúrese de revisar el contenido del informe e identificar la información confidencial antes de enviar el informe a cualquier tercero. Consulte Ocultación de información confidencial en un informe sos.

Según los paquetes instalados y la carga del sistema, el informe puede tardar mucho tiempo en completarse.

Si el sistema tiene muchos paquetes instalados, use el siguiente comando para desactivar la verificación de la base de datos rpm:
```
sos report -k rpm.rpmva=off
```
Si el sistema está muy cargado, utilice el siguiente comando para desactivar la opción kernel.sysrq:
```
sos report -k kernel.sysrq=off
```

Una vez que haya proporcionado la información según se le solicite, el comando continúa con la generación del informe, que puede tardar bastante en completarse. Al final del proceso, la pantalla muestra un mensaje similar al siguiente:

Your sosreport has been generated and saved in:
/var/tmp/sosreport-hostname-case#-datestamp-ID.tar.xz

 Size   20.62MiB
 Owner  root
 sha256 428f7b4118acd2d349bb022946877d853aa0eefbb4d340af3839810dc634b8b7

Please send this file to your support representative.
...
Running plugins. Please wait ...
  Finishing plugins              [Running: unpackaged]
  Finished running plugins
Creating compressed archive...
Your sosreport has been generated and saved in:
        /var/tmp/sosreport-<user_name>-<os>-<date>.tar.xz

 Size   15.72MiB
 Owner  root
 sha256 0fcfef63887d76ebd5b831be5d93d7953b0b9a431d81c9665459fbc8ce4a5f16

Please send this file to your support representative.

Usos adicionales del comando sos

Personalice la salida de los informes sos mediante opciones adicionales del comando sos.

El comando sos report también se puede utilizar con otras opciones. Por ejemplo, para mostrar solo los plugins y las opciones de plugin disponibles en el informe. También puede obtener solo información específica de un área problemática y especificar opciones para adaptar el informe que se genera.

Para mostrar solo los plugins y las opciones de plugin disponibles en el informe:
```
sudo sos report -l
```
Los plugins que muestra el comando se agrupan según las siguientes secciones:
- Todos los plugins activados
- Todos los plugins desactivados
- Opciones disponibles para todos los plugins
- Opciones de plugin disponibles
Consulte la documentación del usuario de SOS sobre cómo activar o desactivar plugins y cómo definir valores para las opciones de plugin.
Para registrar solo información sobre Apache y Tomcat y recopilar todos los logs de Apache:
```
sudo sos report -o apache,tomcat -k apache.log=on
```
Para activar todas las opciones booleanas para todos los plugins cargados (excluyendo el plugin rpm.rpmva) y verificar todos los paquetes:
```
sudo sos report -a -k rpm.rpmva=off
```

Ocultación de información confidencial en un informe sos

Oculte la información en un informe sos antes de proporcionarla a los Servicios de Soporte Oracle.

Para proteger la información confidencial antes de enviar el informe externamente, puede utilizar la funcionalidad clean de la utilidad sos. Esta funcionalidad intenta ocultar cualquier información del informe que se considere confidencial, como la siguiente:

Direcciones y redes IPv4 (se conservan las topologías de red)
Direcciones MAC
Nombres de host
Nombres de usuario
Cualquier palabra o frase que especifique con la opción --keyword

Para utilizar la utilidad sos clean en un informe generado, escriba el siguiente comando y siga las indicaciones que se muestran:

sudo sos clean /var/tmp/sosreport-hostname-case#-datestamp-ID.tar.xz

...
Users should review any resulting data and/or archives generated or processed by
this utility for remaining sensitive content before being passed to a third
party.

Press ENTER to continue, or CTRL-C to quit.

Al final del proceso, la pantalla muestra un mensaje similar al siguiente:

Successfully obfuscated 1 report(s)

A mapping of obfuscated elements is available at
	/var/tmp/sosreport-<host0-2022-08-08-qxbegcn>-private_map

The obfuscated archive is available at
	/var/tmp/sosreport-<host0-2022-08-08-qxbegcn-obfuscated>.tar.xz

	Size	3.62MiB
	Owner	root

Please send the obfuscated archive to your support representative and keep the mapping file private

El informe resultante que se ha eliminado de la información confidencial también se almacena en /var/tmp. Sin embargo, se revisa el nombre de archivo en sí. El nombre de host es genérico y, lo que es más importante, obfuscated se agrega al nombre de archivo para que pueda identificar la versión limpia del informe.

Atención

Tenga en cuenta lo siguiente sobre la utilidad sos clean:

La funcionalidad clean es un método de mejor esfuerzo para identificar y, a continuación, enmascarar información confidencial. Sin embargo, sos clean no garantiza que la cobertura del proceso de enmascaramiento esté completa en un sistema específico.
Los informes que se procesan con el comando sos clean ocultan determinados detalles que un tercero, como un representante de soporte, puede necesitar para proporcionar una mejor ayuda al resolver problemas.
Siempre debe auditar los archivos e informes que genera la utilidad sos antes de enviar cualquiera de estos archivos externamente.

Para limpiar automáticamente cualquier informe sos que cree, utilice la siguiente sintaxis de comando al generar un informe:

sudo sos report --clean

Para obtener más información, escriba man sos o consulte la documentación del usuario de iOS.

Revisión de resultados de sosreport

Configurar y revisar la recopilación de información de depuración en Oracle Linux.

El comando sos se configura automáticamente para recopilar información de hardware, archivos de configuración del sistema y datos de log. Puede activar y desactivar módulos para que coincidan con los requisitos de protección de datos.

Nota

La información del módulo que se proporciona en esta tabla está relacionada con sos 3.9. Para verificar los módulos que ha instalado, ejecute el comando sos report. La salida incluye la versión de la utilidad sos que está ejecutando.

La desactivación de módulos impide que el comando sos recopile determinados detalles que podrían ser necesarios para la resolución avanzada de problemas, como la información de red.


Módulo	Tipo de información	Archivos Incluidos
`anaconda`	Archivos log de instalación	`/root/install.log` `/root/install.log.syslog` `/var/log/anaconda` `/var/log/anaconda.*`
`auditd`	Archivos log de auditoría	`/etc/audit/auditd.conf` `/etc/audit/audit.rules` `/var/log/audit/*`
`boot`	Detalles del proceso de inicio del sistema	`/etc/milo.conf` `/etc/silo.conf` `/boot/efi/efi/redhat/elilo.conf` `/etc/yaboot.conf` `/boot/yaboot.conf`
`cron`	Comandos `cron` del usuario raíz	`/etc/cron*` `/etc/crontab` `/var/log/cron` `/var/spool/cron`
`cups`	Archivos log de impresora	`/etc/cups/.conf` `/etc/cups/.types` `/etc/cups/lpoptions` `/etc/cups/ppd/.ppd` `/var/log/cups/`
`date`	Datos de Contexto	`/etc/localtime`
`devicemapper`	Detalles de Hardware
`filesys`	Lista de todos los archivos en uso	`/proc/fs/` `/proc/mounts` `/proc/filesystems` `/proc/self/mounts` `/proc/self/mountinfo` `/proc/self/mountstats` `/proc/[0-9]/mountinfo` `/etc/mtab` `/etc/fstab`
`grub2`	Configuración de inicio de núcleo y sistema	`/boot/efi/EFI//grub.cfg` `/boot/grub2/grub.cfg` `/boot/grub2/grubenv` `/boot/grub/grub.cfg` `/boot/loader/entries` `/etc/default/grub` `/etc/grub2.cfg` `/etc/grub.d/`
`hardware`	Detalles de Hardware	`/proc/interrupts` `/proc/irq` `/proc/dma` `/proc/devices` `/proc/rtc` `/var/log/mcelog` `/sys/class/dmi/id/` `/sys/class/drm//edid`
`host`	Identificación del host	`/etc/sos.conf` `/etc/hostid`
`kernel`	Archivos log del sistema	`/etc/conf.modules` `/etc/modules.conf` `/etc/modprobe.conf` `/etc/modprobe.d` `/etc/sysctl.conf` `/etc/sysctl.d` `/lib/modules//modules.dep` `/lib/sysctl.d` `/proc/cmdline` `/proc/driver` `/proc/kallsyms` `/proc/lock` `/proc/buddyinfo` `/proc/misc` `/proc/modules` `/proc/slabinfo` `/proc/softirqs` `/proc/sys/kernel/random/boot_id` `/proc/sys/kernel/tainted` `/proc/timer` `/proc/zoneinfo` `/sys/firmware/acpi/` `/sys/kernel/debug/tracing/` `/sys/kernel/livepatch/` `/sys/module//parameters` `/sys/module//initstate` `/sys/module//refcnt` `/sys/module//taint` `/sys/module//version` `/sys/devices/system/clocksource//available_clocksource` `/sys/devices/system/clocksource/*/current_clocksource` `/sys/fs/pstore` `/var/log/dmesg`
`libraries`	Lista de bibliotecas compartidas	`/etc/ld.so.conf` `/etc/ld.so.conf.d/*`
`logs`	Archivos log del sistema	`/etc/syslog.conf` `/etc/rsyslog.conf` `/etc/rsyslog.d` `/run/log/journal/` `/var/log/auth.log` `/var/log/auth.log.1` `/var/log/auth.log.2` `/var/log/boot.log` `/var/log/dist-upgrade` `/var/log/installer` `/var/log/journal/` `/var/log/kern.log` `/var/log/kern.log.1` `/var/log/kern.log.2` `/var/log/messages` `/var/log/secure` `/var/log/syslog` `/var/log/syslog.1` `/var/log/syslog.2*` `/var/log/udev` `/var/log/unattended-upgrades`
`lvm2`	Detalles de Hardware
`memory`	Detalles de Hardware	`/proc/pci` `/proc/meminfo` `/proc/vmstat` `/proc/swaps` `/proc/slabinfo` `/proc/pagetypeinfo` `/proc/vmallocinfo` `/sys/kernel/mm/ksm` `/sys/kernel/mm/transparent_hugepage/enabled`
`networking`	Identificación de red	`/etc/dnsmasq` `/etc/host` `/etc/inetd.conf` `/etc/iproute2` `/etc/network` `/etc/nftables` `/etc/nftables.conf` `/etc/nsswitch.conf` `/etc/resolv.conf` `/etc/sysconfig/nftables.conf` `/etc/xinetd.conf` `/etc/xinetd.d` `/etc/yp.conf` `/proc/net/` `/sys/class/net//device/numa_node` `/sys/class/net//flags` `/sys/class/net//statistics/`
`pam`	Configuraciones de seguridad de inicio de sesión	`/etc/pam.d/*` `/etc/security`
`pci`	Detalles de Hardware	`/proc/bus/pci` `/proc/iomem` `/proc/ioports`
`process`	Lista de todos los procesos en ejecución y detalles del proceso	`/proc/sched_debug` `/proc/stat` `/proc/[0-9]*/smaps`
`processor`	Detalles de Hardware	`/proc/cpuinfo` `/sys/class/cpuid` `/sys/devices/system/cpu`
`rpm`	Paquetes de software instalados	`/var/lib/rpm/*` `/var/log/rpmpkgs`
`sar`	Datos de recursos y uso	`/var/log/sa/*`
`selinux`	Configuración	`/etc/sestatus.conf` `/etc/selinux` `/var/lib/selinux`
`services`	Todos los servicios del sistema definidos	`/etc/inittab` `/etc/rc.d/*` `/etc/rc.local`
`ssh`	Configuración de SSH	`/etc/ssh/ssh_config` `/etc/ssh/sshd_config`
`x11`	Logs de GUI para el sistema de ventanas X	`/etc/X11/` `/var/log/Xorg..log` `/var/log/Xorg..log.old` `/var/log/XFree86..log` `/var/log/XFree86.*.log.old`
`yum`	Paquetes de software instalados	`/etc/pki/consumer/cert.pem` `/etc/pki/entitlement/.pem` `/etc/pki/product/.pem` `/etc/yum/` `/etc/yum.repos.d/` `/etc/yum/pluginconf.d/*` `/var/log/dnf.log`