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.