sos-4.3
The sos team is pleased to announce the release of sos-4.3. This release includes a number of quality-of-life changes to both end user experience and for contributors dealing with the plugin API. A subset of the changes in this release are highlighted below.
Global Changes
- Failed CI test logs will now be uploaded to GCP and available for review via the CirrusCI test page for the test that failed.
- sos is now available as a snap.
Policy Changes
- Added a policy for OpenEuler.
- Added a policy for RockyLinux.
- Sysroot determination and usage is now determined once during policy initialization, and sysroot usage is now fully consistent across sos components.
- Added a container runtime abstraction for
crio
.
Report Changes
- Added 6 new plugins:
dellrac
,gcloud
,openshift_ovn
,perccli
,udisk
,unbound
- The
ceph
plugin has been spit intoceph_common
,ceph_mds
,ceph_mgr
,ceph_mon
,ceph_osd
, andceph_rgw
. - A new
--estimate-only
option is available that will attempt to estimate the amount of disk space used by sos for a given set of options. - Fixed a bug where host services would not be inspected properly if sos was run from a container.
- The
runc
plugin has been removed as it was redundant with other container plugins. - The
openvswitch
plugin has been expanded to collect OpenFlow protocols. - Fixed a bug in the
unpackaged
plugin that could cause the plugin to hang on recursive syminks. - The
networking
plugin is now better organized when collecting from network namespaces. - Fixed a bug in the
virsh
plugin that would cause no information to be collected, due to newervirsh
commands requiring a TTY. - When using
--all-logs
, and/or for collections wheresizelimit=0
, sos will now write that output directly to disk, rather than storing it in memory.
Plugin API
- Plugin options are now defined via the
PluginOpt
class, rather than as tuples.- More information for contributors is available in the wiki
- SCL plugin commands will no longer overwrite PATH.
- Renamed
get_container_logs()
toadd_container_logs()
which should be used to copy a container's stdout logs to a report archive. add_cmd_output()
now supports acontainer
parameter which, if set, will cause the specified commands to be executed inside the specified container(s), provided those container(s) exist.add_copy_spec()
also now supports acontainer
parameter to allow specified files to be copied from container(s).- Note that this currently does not function for
crio
managed containers, ascrio
does not support this functionality.
- Note that this currently does not function for
Clean|Mask Changes
sos clean
can now also obfuscate insights archives, as well as "plain" directories or tar archives./etc/hosts
is now sourced for domains to obfuscate, alongsidehostname
output.- Improved username sourcing.
- The username and keyword parsers are now much more efficient when handling large lists of items to obfuscate.
- Domain and subdomain matching has been simplified.
- Improved per-parser file and keyword skipping to provide for more reliable and useful obfuscations.
- Reduced false positive matches for hostnames, domains, and mac address.
- Domain and sub-domain matching with the hostname parser should now be more reliable.
Collect Changes
- Node connections have been abstracted away from
ssh
directly as the remote transport. Whilessh
is still the default, other mechanisms may be used for remote connections.- This may be controlled via the
--transport
option. - Added a new
oc
transport for use in OCP environments. Using this transport will cause sos to create a temporary project within the OCP environment being collected from.
- This may be controlled via the
- The
--master
option has been fully removed and replaced with--primary
, or the aliases--controller
, or--manager
. - Cluster cleanup is now more consistently called regardless of if collect was successful or not.
Help (new!)
sos help
is a new sub-command for sos with this release. Using sos help $topic
will provide users with more information on specific aspects or sos, such as more detailed plugin information, than is available via normal --help
output or man pages.
To see what kind of information is available, try sos help
or sos help report
to get started.
For full information on the changes contained in this release, please refer to the Git commit logs. Further release information and tarballs are available at:
https://github.com/sosreport/sos/releases/tag/4.3
Please report any problems to the sos-devel mailing list, or the GitHub issue tracker:
https://github.com/sosreport/sos/issues/
The team would like to thank everyone who contributed fixes, new features, testing, and feedback for this release.