OVOS-utils

collection of simple utilities for use across the mycroft ecosystem

Install

pip install ovos_utils

Small helper tool to quickly navigate the logs, create slices and quickview errors

ovos-logs slice [options]

Slice logs of a given time period. Defaults on the last service start (-s) until now (-u)

Different logs can be picked using the -l option. All logs will be included if not specified.
Optionally the directory where the logs are stored (-p) and the file where the slices should be dumped (-f) can be specified.

[ex: ovos-logs slice]
^{Slice all logs from service start up until now.}

[ex: ovos-logs slice -s 17:05:20 -u 17:05:25]
^{Slice all logs from 17:05:20 until 17:05:25.}
^{**no logs in that timeframe in other present logs}

[ex: ovos-logs slice -s 17:05:20 -u 17:05:25 -l skills]
^{Slice skills.log from 17:05:20 until 17:05:25.}

[ex: ovos-logs slice -s 17:05:20 -u 17:05:25 -f ~/testslice.log]
^{Slice the logs from 17:05:20 until 17:05:25 on all log files and dump the slices in the file ~/testslice.log (default: ~/slice_<timestamp>.log).}

ovos-logs list [-e|-w|-d|-x] [options]

List logs by severity (error/warning/debug/exception). A log level has to be specified - more than one can be listed

A start and end date can be specified using the -s and -u options. Defaults to the last service start until now.
Different logs can be picked using the -l option. All logs will be included if not specified.
Optionally, the directory where the logs are stored (-p) and the file where the slices should be dumped (-f) can be passed as arguments.

[ex: ovos-logs list -x]
^{List the logs with level EXCEPTION (plus tracebacks) from the last service start until now.}

[ex: ovos-logs list -w -e -s 20-12-2023 -l bus -l skills]
^{List the logs with level WARNING and ERROR from the 20th of December 2023 until now from the logs bus.log and skills.log.}

ovos-logs reduce [options]

Downsize logs to a given size (in bytes) or remove entries before a given date.

Different logs can be included using the -l option. If not specified, all logs will be included.
Optionally the directory where the logs are stored (-p) can be specified.

[ex: ovos-logs reduce]
^{Downsize all logs to 0 bytes}

[ex: ovos-logs reduce -s 1000000]
^{Downsize all logs to ~1MB (latest logs)}

[ex: ovos-logs reduce -d "1-12-2023 17:00"]
^{Downsize all logs to entries after the specified date/time}

[ex: ovos-logs reduce -s 1000000 -l skills -l bus]
^{Downsize skills.log and bus.log to ~1MB (latest logs)}

ovos-logs show -l [servicelog]

Show logs

[ex: ovos-logs show -l bus]
^{Show the logs from bus.log.}

[ex: wrong servicelog]
^{**logs shown depending on the logs present in the folder}

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

ovos_utils-0.13.8a1.tar.gz (78.8 kB view details)

Uploaded Jul 24, 2026 Source

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

Uploaded Jul 24, 2026 Python 3

Details for the file ovos_utils-0.13.8a1.tar.gz.

Details for the file ovos_utils-0.13.8a1-py3-none-any.whl.