antilog

Antilog is the antidote to modern loggers.

• AntiLog only logs JSON formatted output. Structured logging is the only good logging.
• AntiLog does not have log levels. If you don't want something logged, don't log it.
• AntiLog supports setting fields in context. This is useful for building a log context over the course of an operation.
• AntiLog has no dependencies. Using antilog only brings in what it needs, and that isn't much!
• AntiLog always uses RFC3339 formatted UTC timestamps, for sanity.

Basic Usage

    antilog.Write("a message")

{ "timestamp": "2019-11-18T14:00:32Z", "message": "a message" }

With Fields

    antilog.Write("a message",
        "field", "value",
        "a_number", 123,
        "a_bool", false,
    )

{ "timestamp": "2019-11-18T14:00:32Z", "message": "a message", "field": "value", "a_number": 123, "a_bool": false }

With Context

    logger := antilog.With(
        "request_id", "12345",
        "user_id": "big_jim_mcdonald",
    )

    logger.Write("a message",
        "field", "value",
        "a_number", 123,
        "a_bool", false)

{ "timestamp": "2019-11-18T14:00:32Z", "message": "a message", "request_id": "12345", "user_id": "big_jim_mcdonald", "field": "value", "a_number": 123, "a_bool": false }

With More Complex Data Types

    antilog.Write("something complex!",
        "array", []string{"this", "is", "an", "array"},
        "map", map[string]string{
            "key": "value",
            "just": "like that",
        },
        "the_antilog_struct_itself", antilog.With("hello", "world"),
    )

{ "timestamp": "2019-11-18T13:41:56Z", "message": "something complex!", "array": [ "this", "is", "an", "array" ], "map": { "key": "value", "just": "like that" }, "the_antilog_struct_itself": { "Fields": [ "hello", "world" ] } }

Output To Somewhere Other Than STDOUT

    var sb strings.Builder
    logger := antilog.WithWriter(sb)

    logger.Write("a message",
        "field", "value",
        "a_number", 123,
        "a_bool", false)

    fmt.Println(sb.String())

{ "timestamp": "2019-11-18T14:00:32Z", "message": "a message", "field": "value", "a_number": 123, "a_bool": false }