Skip to content

sos-4.3

Compare
Choose a tag to compare
@TurboTurtle TurboTurtle released this 15 Feb 04:23
· 834 commits to main since this release

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 into ceph_common, ceph_mds, ceph_mgr, ceph_mon, ceph_osd, and ceph_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 newer virsh commands requiring a TTY.
  • When using --all-logs, and/or for collections where sizelimit=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() to add_container_logs() which should be used to copy a container's stdout logs to a report archive.
  • add_cmd_output() now supports a container 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 a container parameter to allow specified files to be copied from container(s).
    • Note that this currently does not function for crio managed containers, as crio does not support this functionality.

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, alongside hostname 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. While ssh 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.
  • 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.