Sending your logs to Timber over HTTP is accomplished with our POST https://logs.timber.io/frames Ingestion API endpoint. A few examples:

Authentication

Once you’ve obtained your API key, you’ll need to add it add in the Authorization header like so:

Authorization: Basic base64(api_key)

Where base64 represents the resulting output after Base64 encoding your key. For example, if your key is abcd1234 then the header value should be:

Authorization: Basic YWJjZDEyMzQ=

Examples

text/plain

POST /frames HTTP/1.1
Host: logs.timber.io
Authorization: Basic {base64(api_key)} (see above)
Content-Type: text/plain

log line 1
log line 2

Optionally, you can prefix the line with an ISO8601 date and the Timber API will parse it. For example:

2016-03-02T00:01:02.112234Z - log line 1

application/json

POST /frames HTTP/1.1
Host: logs.timber.io
Authorization: Basic {base64(api_key)} (see above)
Content-Type: application/json

[
  {"dt": "2017-03-01T00:00:00.000000Z", "message": "log line 1"},
  {"dt": "2017-03-01T00:00:00.000000Z", "message": "log line 2"}
]

Please see the log line JSON schema doc for more info on our JSON schema, as well as the fields and requirements.

Other Supported Media Types

  1. application/msgpack - the same as json, just msgpack encoded / compressed.

Questions? Need help?

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

Chat with us

Start a trial - 15 days free

Log better and solve problems faster, today. Less than 1 minutes to install.

Start a trial