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}