jonson 1.1.1

out-of-the-box, ready-to-use JSON logger

jonson

out-of-the-box, ready-to-use JSON logger

from jonson import logger

logger.info("Something going as expected", { "host": socket.gethostname() })
logger.warn("Something must have gone terribly wrong")

except Exception as e:
    logger.error(e, { description: "something descriptive" })

Log level

Create logger instance with a minimal log level

from jonson import Logger

logger = Logger("warn")

logger.info("Something going as expected", { "host": socket.gethostname() }) # ignored
logger.warn("Something must have gone terribly wrong") # sent

Log levels hirarchy

A few synonyms are available for convenience

1. trace, verbose
2. debug
3. info, log
4. warn
5. error
6. critical, fatal, panic

For example, a logger with log level "warn" will only print logs with level "warn", "error", or "critical".

Arguments

Create: Logger class accepts one or two arguments:

1. {string} Case insensitive name of minimal log level. defaults to "info"
2. {dictionary} {'Key':'Value'} pairs, optional. Persistent enrichment fields for all log records

logger = Logger(os.environ["LOG_LEVEL"], { "host": socket.gethostname() })

Send: Logger functions accept one or two arguments:

1. {any} Record's "message" field. Traditionally this would be a string or an exception.
2. {dictionary} {'Key':'Value'} pairs, optional. Values should be JSON serializable

logger.info("something, something", { dark: "side" })