Overview
Hotsos is a framework for software-defined analysis. It provides a library of plugins written in Python along with a high-level language in which to implement checks and analysis and report problems. Supported plugins include:
- Openstack
- Kubernetes
- Ceph
- Open vSwitch
- Juju
- MAAS
- Vault
- MySQL
- RabbitMQ
- and more
Each plugin has associated checks or "scenarios" that seek to identify issues and known bugs. The output is a summary from each plugin including key runtime information as well issues or bugs detected along with suggestions on how to deal with them. This information can be useful as an aid for further manual analysis.
The default summary format is yaml and a number of other options and formats are provided.
Hotsos is run directly on a host or against a sosreport.
The code has the following structure:
- core python library (includes plugins)
- checks/scenarios (see documentation at defs)
- python plugin extensions
- tests
Usage
Say for example that you are running an Openstack Cloud and one of your hypervisor nodes that is also running part of a Ceph storage cluster is experiencing a problem with network connectivity to workloads. Simply run hotsos on the node or against a sosreport generated from that node e.g.
ubuntu@ncpu1$ hotsos -s
INFO: analysing localhost /
INFO: output saved to hotsos-output-1673868979
Now you will find a folder called hotsos-output-1673868979 containing a
summary of information in a number of different formats. Taking the most common
yaml format we can see:
ubuntu@ncpu1$ cat hotsos-output-1673868979/ncpu1.summary.yaml
This file will contain a per-plugin summary of information found along with any
issues or bugs detected. By default hotsos will only look at the last 24 hours of logs.
You can increase this with --all-logs which will by default give you 7 days
worth and if you want more you can use --max-logrotate-depth <days>.
Our folder also contains other formats of the same information and one of those is json which can easily be queried using a tool called jq. Using this useful tool we can easily query for specific information e.g.
ubuntu@ncpu1$ jq -r '.storage."potential-issues"' hotsos-output-1673868979/ncpu1.summary.json
{
"BcacheWarnings": [
"One or more of the following bcache bdev config assertions failed: sequential_cutoff eq \"0.0k\"/actual=\"4.0M\", cache_mode eq \"writethrough [writeback] writearound none\"/actual=\"writethrough [writeback] writearound none\", writeback_percent ge 10/actual=\"10\" (origin=storage.auto_scenario_check)",
"One or more of the following bcache cacheset config assertions failed: congested_read_threshold_us eq 0/actual=\"2000\", congested_write_threshold_us eq 0/actual=\"20000\" (origin=storage.auto_scenario_check)"
]
}
Examples
An example full (yaml) summary can be found here
An example short (yaml) summary can be found here
Install
HotSOS can be installed in the following ways:
Daily build Debian package
NOTE: this is the recommended method.
$ sudo add-apt-repository ppa:ubuntu-support-team/hotsos
$ sudo apt install hotsos
pypi
NOTE: requires Python >= 3.8
$ sudo apt install python3-pip
$ pip install hotsos
NOTE: when upgrading be sure to upgrade dependencies since pip will not do this by default. To forcibly upgrade all dependencies you can use:
pip install --upgrade hotsos --upgrade-strategy eager
snap
You can install as a snap e.g.
$ sudo apt install snapd
$ sudo snap install hotsos --classic
See https://snapcraft.io/hotsos for more info on usage.
NOTE: the snap only currently works properly on Ubuntu Focal.
source
$ git clone https://github.com/canonical/hotsos
$ pip install -r hotsos/requirements.txt
$ ./hotsos/scripts/hotsos
1 maintainer
Metadata
1 maintainer
Release files for hotsos 1.1.14.post25
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| hotsos-1.1.14.post25.tar.gz | 204.8 kB | Without provenance | Details for hotsos-1.1.14.post25.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| hotsos-1.1.14.post25-py3-none-any.whl | Python 3 | none | any | Details for hotsos-1.1.14.post25-py3-none-any.whl |
Total release size: 511.6 kB
Release files / hotsos-1.1.14.post25.tar.gz
| Download URL | hotsos-1.1.14.post25.tar.gz |
|---|---|
| Size | 204.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7986016ff575ab6b25d5d3222eaac79dc40eb10a0943c8a68ac46c8187ad99c0
|
|
BLAKE2b-256 checksum How to use checksums |
55bc38dd8cd08b18da7ce64fe7b2548e25041618fb98d35ea52f4acef0e838aa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.11.4
|
Release files / hotsos-1.1.14.post25-py3-none-any.whl
| Download URL | hotsos-1.1.14.post25-py3-none-any.whl |
|---|---|
| Size | 306.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
880b4fc0013e0c63b14becd4185f3873438406bc5444dafab883825214890178
|
|
BLAKE2b-256 checksum How to use checksums |
40bee89a5ee6f8e12648126c23de8295cc15bcd1d8bebc9db7f8150d7d735bc3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.11.4
|
Security for hotsos 1.1.14.post25
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
