vom-json
2020-06-10
A json-formatted logger for vom
.. image:: https://travis-ci.org/fisxoj/vom-json.svg?branch=master
:target: https://travis-ci.org/fisxoj/vom-json
:alt: Travis CI status badge
.. image:: https://img.shields.io/badge/Contributor%20Covenant-v1.4%20adopted-ff69b4.svg
:alt: Contributor Covenant
:target: CODE_OF_CONDUCT.md
:Source: `https://github.com/fisxoj/vom-json <https://github.com/fisxoj/vom-json>`_
:Docs: `https://fisxoj.github.io/vom-json/ <https://fisxoj.github.io/vom-json/>`_
vom-json is a complementary library to `vom <https://github.com/orthecreedence/vom>`_, which changes the logger syntax to something like `lambda-log <https://github.com/KyleRoss/node-lambda-log/>`_ which outputs its log messages in the JSON format. In some environments like AWS insights, this makes the log data more searchable.
You can use it two ways:
Wrap the body of your program in it using :macro:`vom-json:with-json-logging`::
(vom-json:with-json-logging
(vom:error "Oh noes!"))
;; => {"_logLevel":"error","_timestamp":"2020-05-11T18:23:58.569136Z","msg":"Oh noes!","_tags":[],"_package":"common-lisp-user"}
Enable the logger globally::
(vom-json:enable-json-logging)
This project is extremely inspired by `log4cl-json <https://github.com/40ants/log4cl-json/>`_.