Standard library
Logging
Leveled messages and key=value helpers.
Introduction
Leveled messages and key=value helpers. Import std/log to bind the module as log. Call free functions as log.name(...). Struct methods use a receiver value.
/ std/log
This page is the package reference for std/log. Private helpers used only by co-located tests are not listed.
Functions
Free functions on log. Each function has a short description, an example, then parameters and return shape.
emit
Emits msg when msg_level meets min_level. Call form: log.emit(min_level, msg_level, prefix, msg).
/ std/log
log.emit(1, 1, "app", "ready")
Parameters: min_level: minimum level. msg_level: message level. prefix: prefix string. msg: message body. Returns: None.
debug
Emits a debug-level log line. Call form: log.debug(min_level, msg).
/ std/log
log.debug("trace")Parameters: msg: message string. Returns: None.
info
Emits an info-level log line with the given message. Call form: log.info(min_level, msg).
/ std/log
log.info("ready")Parameters: msg: message string. Returns: None.
warn
Emits a warning-level log line. Call form: log.warn(min_level, msg).
/ std/log
log.warn("slow")Parameters: msg: message string. Returns: None.
error
Emits an error-level log line. Call form: log.error(min_level, msg).
/ std/log
log.error("failed")Parameters: msg: message string. Returns: None.
kv
Formats key-value fields for structured log lines. Call form: log.kv(pairs).
/ std/log
$ s = log.kv({ user: "ada" })Parameters: fields: product of fields to format. Returns: Formatted fields string.
info_kv
Emits an info log line with a message and key-value fields. Call form: log.info_kv(min_level, msg, pairs).
/ std/log
log.info_kv("login", { user: "ada" })Parameters: msg: message string. fields: product of fields. Returns: None.