Skip to main content

Log

log.help​

Shows this help information.

log.journalctl​

Retrive log files for either kernel, system or salt-minion.

ARGUMENTS

  • log (str): The log you want to retrieve.

OPTIONAL ARGUMENTS

  • minutes (int): Specifies time delimiter on report retrival, time now minus minutes.
  • days (int): Overwrites minutes to days date minus days.
  • lines (int): Specifies the maximum number of lines returned.
  • grep (str): Match expressions and delimit output string.
  • matched_lines (int): Amount of lines returned after grep pattern context.
  • boot (int): Fetches boot records from journal using offset; positive starting from the first boot, non-positive starting from the last boot, -0 or no number for current boot.

log.kernel​

Print and/or clear the kernel ring buffer.

OPTIONAL ARGUMENTS

  • level (str): Restict output the the given level and higher. Default is err.
  • facilities (str): Restrict output to the given list (comma-separated) of facilities.
  • offset (str): Offset regex to begin from.
  • clear (bool): Clear after reading.

log.kernel_iter​

Helper function to retrieve new kernel log entries (based on cached offset value).

OPTIONAL ARGUMENTS

  • level (str): Restict output the the given level and higher. Default is err.
  • facilities (str): Restrict output to the given list (comma-separated) of facilities.
  • offset_key (str): Key to get value from result and use as offset. Default is timestamp.
  • reset (bool): Reset cached offset value and start over.

log.query​

Query a log file or any text file.

ARGUMENTS

  • file (str): Path of log file.

OPTIONAL ARGUMENTS

  • begin (str): Default is ^.
  • end (str): Default is $.
  • match (str): Default is .*.
  • count (int): Default is 0.
  • reverse (bool): Default is False.
  • before (int): Default is 0.
  • after (int): Default is 0.
  • first (int): Default is 0.
  • last (int): Default is 100.