Logging Standards

Import

from logger import mylog

Never import logging directly in application code. Use mylog exclusively.

Function Signature

mylog(level, message_or_list)

message_or_list can be a plain string or a list of values — the logger joins them with spaces.

Log Levels

Levels from least to most verbose (higher number = more output):

Message Format

Prefix every message with a [Module] tag matching the file/function context:

mylog("debug", [f"[device_handling] Processing MAC: {mac}"])
mylog("verbose", ["[Scan] Scan complete — devices updated:", count])

Use f-strings inside a list element, not string concatenation:

# Correct
mylog("debug", [f"[NIC] parent={parent_mac} nic_online={nic_online}"])

# Avoid
mylog("debug", "[NIC] parent=" + parent_mac + " nic_online=" + str(nic_online))

Timestamp

mylog / file_print prepend the current local-timezone time automatically via timeNowTZ. Do not add a timestamp manually inside the message.

What NOT to Log

• Do not log raw user input without sanitization.
• Do not log full SQL query strings at "none" or "minimal" — use "trace" at most.
• Do not use print() in server code — use mylog. file_print is an internal helper; do not call it directly.

Log File Location

Written to {logPath}/app.log (logPath from const.py → /tmp/logs at runtime). Do not hardcode this path.