concepts / log-json-schema

Log Event JSON Schema

The Timber log event JSON schema describes the structure of all Timber logs through the JSON schema specification. It formalizes this process, creating a contract around the structure, allowing downstream consumers to predictably and efficiently consume this data. It solves the brittle traditional nature of logs. To get started, we recommend exploring the various contexts and events. If you are unaware what contexts and events are, please read out metadata, context, and events document.

Schema

Example JSON structure

{
  "dt": "2016-12-01T02:23:12.236543Z",           // Consistent ISO8601 dates with nanosecond precision
  "level": "info",                               // The level of the log
  "message": "POST /checkout for 192.321.22.21", // Human readable message
  "context": { ... },                            // Context (join) data shared across your logs
  "event": { ... }                               // Structured representation of this log event
}
Questions?

Chat with us, just click the talk button in the bottom right of this page.

Chat with us
Sign Up

Log better and solve problems faster, today. Install in under a minute.

Sign Up