ovos-utils 0.4.0

collection of simple utilities for use across the openvoiceos ecosystem

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}