OVOS-utils
collection of simple utilities for use across the mycroft ecosystem
Install
pip install ovos_utils
Commandline scripts
ovos-logs
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