sos-4.9.0

The sos team is pleased to announce the release of sos-4.9.0. This release represents the first of our two bi-annual releases for 2025, with the next Y-version release bump expected in August. Note that the following release notes are relative to the previous 4.8.2, for full comparison with the 4.8.0 release from August 2024, see the previous release notes for versions 4.8.1, and 4.8.2.

Global

• There has been significant ongoing work with the downstream Debian release for sos, thank you to @arif-ali for all his work on this front.
• The legacy redirectors for sosreport and sos-collector have been dropped as of this release. The only executable going forward is sos.

Policy

• Added duke release for Debian support.

Report

• No changes made directly to the SosReport() component in this release.

Plugins

• New plugins: aap_containerized, and oratab.
• The foreman_installer plugin now collects satellite_metrics.yml.
• The python plugin will now collect verbose output via pip.
• Journal collection speed has been improved via a combination of a python implementation of tac, and calling non-sizelimited journal collections with --reverse.
  • Users and automation that relies on static file naming is reminded that sos_reports/manifest.json should be referenced and the use of tags to find collections within an archive is recommended so that command string changes do not break parsing automation.
• Plugins that collect stackdumps from processes by first sending a signal to those processes have been standardized on a new Plugin.signal_process_usr1() method.
• The crio plugin now supports a stackdump plugin option to collect a stackdump from the main crio process.

Collect

• The saltstack transport will now execute commands using cmd.exec_code sh, instead of cmd.shell.

Clean

• The IPv6 MAC address parser has been updated to reduce false positive matches, including reduce matching again on previously obfuscated strings from other parsers.

Upload

• A new sos upload component has been added, moving the upload code from Policy() and allowing end-users to upload files to vendor locations from systems that may not match the vendor's products/distributions (e.g. when a report archive cannot be uploaded directly from the generating system, and must instead be uploaded from a workstation).

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.9.0

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.

sos-4.8.2

The sos team is pleased to announce the release of sos-4.8.2. This is a minor update compared to 4.8.1, changes relative to it are below.

Report Changes

• Plugins' postprocessing times are newly collected by sos manifest

Plugin Changes

• New plugins: perccli2 and Instructlab
• Password obfuscation of various listed plugins has been improved: heat, placement, mysql, microk8s, sunbeam, foreman and subscription_manager
• The docker, podman and containerd plugins newly collect container image layers
• The juju plugin newly collects commands from juju agents and state reporting
• The foreman plugin newly limits size of collected production.log and ssl los to 500MB only
• The coredump plugin was refactored to collect less dumps
• The ansible plugin stops collecting /etc/ansible/files
• The system plugin newly collects names of environmental variables
• The kubernetes plugin was enhanced (k8s snap, kubelogs option)
• The NetworkManager plugin newly collects system-connections files from all locations

Collect changes

• Fixed an exception when calling collect with --batch and --password options
• Collect can newly inherit config file

Cleaner changes

• Hostname obfuscation was improved to match whole strings

Generic changes

• Ubuntu images were updated for testing

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.8.2

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.

sos-4.8.1

The sos team is pleased to announce the release of sos-4.8.1. This is a minor update compared to 4.8.0, changes relative to it are below.

Report Changes

• Obfuscate upload password in get_upload_url_string()
• Apply --skip-files also to destination of symlinks
• Policy check is consolidated across all Policy objects
• http URL credentials are obfuscated

Plugin Changes

• New plugins: kea, bird, bootc
• The network plugin collects more devlink commands outputs
• The sudo plugin captures more log files
• The leapp plugin plugin enablement is improved
• The block plugin captures LUKS clevis binding
• The nvidia plugin newly collects data from nvidia container toolkit
• The ceph plugin commands collection is updated
• The vdo plugin captures vdo volumes
• The cgroups plugin collects information per processes

Generic changes

• Various fixes for pylint compliance
• Specify licence GPL v2 only

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.8.1

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.

sos-4.8.0

The sos team is pleased to announce the release of sos-4.8.0. There are several project-wide changes in this release, which will be the last minor version release for 2024. The next minor release (4.9.0) is scheduled for February 2025, though users may expect maintenance releases on top of 4.8.0 between now and then.

Global

• Major shoutout to @pponnuvel for the significant effort put into addressing linting reports and refactors across the project
• Project naming patterns have been further clarified as "sos (space) $component", e.g. sos report instead of sosreport.
• Deprecation notice: the old-style command redirectors such as sosreport are deprecated and will be removed in the next minor version (sos-4.9).
• License Clarification: it was brought up that there was ambiguity in our licensing, namely "GPLv2 only" vs "GPLv2 or later". The sos project has always intended to be "GPLv2 only" and has clarified this stance across the repository.
  • See discussion #3705 for more details.
• The automated snap build of sos has been updated to use core24.
• This release is the last release that will have a minimum python version of python-3.6. Subsequent releases will have a minimum python version of python-3.8.

Report

• Fixed a bug where all-logs may not have captured output if the command being collected was installed via snap packaging.

  Plugin

  • New plugins: fail2ban, microcloud
  • A new add_dir_listing() method has been added to standardize collections of directory listings in plugins.
    • The tree parameter can be specified to collect tree output instead of ls output
  • A new is_snap_installed() method has been added to standardize checking if a package is installed as a snap.
  • The container_log plugin has been updated to collect rotated logs.
  • The sunbeam_hypervisor plugin will now properly obfuscate ceilometer and hooks.log.
  • The networking plugin will now capture nmstatectl output.
  • The maas plugin has been significantly refactored.

Policy

• Added a new policy for CloudLinux installations.
• rpm-ostree distributions will fallback to /lib/modules/*/config if /boot/config-$release doesn't exist.

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.8.0

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.

sos-4.7.2

The sos team is pleased to announce the release of sos-4.7.2. This is just a minor update compared to 4.7.1.

General Changes

• A new policy for Alma Linux was added
• Various formatting and styling improvements for CodeQL and pylint

Report Changes

• A new preset for AAP Controller was added
• All strings in report plugins were converted to f-strings
• All journal collections respect --since option
• PluginOpt changes standardized to use dashes only, which means no underscores in plugin options
• Add an option to run commands as a user

Plugin Changes

• New plugins: aap_gateway, aap_receptor, charmed_postgresql, curtin, kafka, microovn, sunbeam and sunbeam_hypervisor
• kdump plugin is newly collected on Azure
• kubernetes plugin stopped collecting data from unsupported versions

Cleaner Changes

• Cleaner run on an already existing sosreport tarball does obfuscate data again

Tests Changes

• Support testing via tox.ini
• Tests run on latest daily Ubuntu builds
• Avocado framework updated to 103.X TLS
• All strings were converted to f-strings
• New tests for apt, juju, netplan and networking

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.7.2

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.

sos-4.7.1

The sos team is pleased to announce the release of sos-4.7.1. This is just a minor update compared to 4.7.0.

General Changes

• .format() calls are replaced by f-string equivalents as a step to modernize on f-strings
• many PYLint, PEP8 and flake8 improvements done

Report Changes

• Hardware devices have new section for fstype

Plugin Changes

• New plugins: proxmox, aap_hub, aap_controller, telegraf
• SCLPlugin class has been dropped
• nfs plugin captures various mountstats
• ceph* plugins newly respect --all-logs option
• openstack_keystone properly obfuscates OIDC client secret

Collector Changes

• ocp cluster has a new option to specify API URL

Cleaner Changes

• A new option --skip-cleaning-files / --skip-masking-files implemented
• Stripping raw MAC address has been improved

Tests Changes

• Workaround of puppet bug puppet-agent-7.29.0*) in foreman installer applied

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.7.1

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.

sos-4.7.0

The sos team is pleased to announce the release of sos-4.7.0. This release marks the first six-month release in 2024, with another scheduled to follow in late August.

Global Changes

• Added support for S3 uploads.

Policy Changes

• Fixed dist_version() for Ubuntu.
• Dropped the RedHatAtomic policy.
• Changed the authentication for RHEL uploads to use device auth instead of username/password.

Report Changes

• Added a new preset for app_eda (Ansible Automation Platform Event Drive Ansible).

Plugin Changes

• New plugins: aide, app_eda, coredump', infinidat, vectordev.
• The networking plugin now uses a predicate for ss commands on Ubuntu.
• Enabled the kubernetes plugin for Debian.
• Dropped the atomic plugin.
• Fixed an issue with the command predicate for the lxd plugin when enabled via a snap.
• The nvme plugin now collects additional files per nvme drive on the host.

Collect Changes

• Added a transport for Saltstack.

Cleaner Changes

• clean will no longer try to obfuscate words that are 3 characters or less in length.
• clean will now properly obfuscate the upload password (if provided) in our own logs.

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.7.0

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.

sos-4.6.1

The sos team is pleased to announce the release of sos-4.6.1

Global Change

• Fixed code warnings for file not always closed and for mixing implicit and explicit returns.
• `packaging.version' is now preferred for package version parsing.
• Packaging and testing on deb packages has been started.
• Copr builds for centos stream are newly configured.

Report Changes

• Flatpak package manager is added.

Plugin Changes

• More ovn and ovnkube logs collected.
• New MAAS 3.5 data collected.
• Added two new plugins for OpenStack Masakari.
• New Greenboot plugin separated from Microshift plugin.
• Several improvements have been made to the Microshift plugin.
• Dynaconf and auth passwords are properly obfuscated in both Pulp plugins.
• Microceph plugin now collects mgr data and ceph daemon commands in OSD node.
• Salt plugin collects more data about services, grains or pillars.

Collector Changes

• get_pty functionality has been refactored.

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.6.1

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.

sos-4.6.0

The sos team is pleased to announce the release of sos-4.6.0. While this is a minor update compared to 4.5.6, users and environments will notice a large amount of changes over sos-4.5.0 - see the previous release notes for 4.5.0+. Changes relative to sos-4.5.6 are below.

Report Changes

• sos report will no longer use a non / sysroot for network device enumeration

Plugin Changes

• New plugins: slurm
• The containerd plugin now enables off the containerd.io package
• The ceph_common plugin will no longer enable automatically on cinder nodes
• The discovery plugin will now be enabled by the presence of relevant containers
• The ubuntu plugin will no longer collect ua_tools_status output if the tls module is not loaded
• The firewall_tables plugin will now always capture the nat table, where previously it could be erroneously missed
• The openshift_ovn plugin will now collect ovn db files

Cleaner Changes

• Archive extraction now uses fully_trusted_filter as per requirements for python-3.10+ runtimes

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.6.0

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.

sos-4.5.6

The sos team is pleased to announce the release of sos-4.5.6.

Global Changes

• snaps are now automatically built and pushed with new releases.
• Fixed an incompatibility issue with python-3.12 runtimes.

Report Changes

• Added a new ceph profile for use in those types of environments.

Plugin Changes

• Fixed an issue with the enablement of ceph plugins possibly be erroneously enabled.
• Fixed an issue with multiline regexes raising exceptions on python 3.11 runtimes.
• The lustre plugin now collects more debug parameters.
• The ssh plugin now controls collection of user ~/.ssh/config files via the userconfs option.
  • The default for the option is set to true/on/enabled, preserving previous behavior.

Cleaner Changes

• Obfuscated files will now have their permissions set to match the source file.
• Refined the regex used to extract MAC addresses, and will now match underscore separated addresses.

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.5.6

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.