How Timber bills & collects payments

Timber offers a flexible subscription based billing system based on a retention and volume matrix. Timber aims to be as user friendly as possible with billing, helping you to choose the optimal plan for your usecase.

You must have admin permissions to access and mange your organization's billing.



For convenience, Timber offers a configurable matrix of periods, volume, and retention based plans. This provides you with maximum flexibility, helping you to choose the most cost effective plan for your needs. Each facet is described below.

Billing Period

Each plan will specify a billing period. By default, all plans are on a 30 day period. Billing periods start when you create your account, this is your billing period anchor. If you need to adjust billing period anchor please can contact support.


A plan's volume is the cumulative amount of log data, in bytes, sent to your Timber account within a single billing period. Unlike other logging platforms, Timber's volume limits are across your entire billing period, not daily. This works in your favor since logging volume is generally smoothed out over 30 days accounting for daily fluctuations. For example, weekdays are likely to produce more logging volume than weekends.

Let's look at a real world example to explain further: If you're on a plan with a 30 day billing period, and you send 2gb of data per day, your volume for the billing period would be be 60gb (30 * 2).


Retention is separate from volume and refers to the length of time data is stored from the time it is received. For example, if you're on a plan with a 14 day retention, and you send data on March 1, 2019 at 2pm, your data will be deleted sometime after 2pm on March 15, 2019. Timber offers liberal retention options due to the architecture of our ingestion pipeline. We can also offer custom retention based on your needs, just contact support.







Sources & Hosts









SQL Querying



Enhanced Durability




You can read more about our support in the support document.

Enhanced Durability

Timber implements a hybrid S3 ingestion pipeline. This means that in addition to persisting your data in a fast real-time query engine, your data is also available for querying on S3 which offers 11-9s of durability. Free customers are limited to our real-time engine only, which reduces the durability guarantees we can offer. This is mostly due to the fact that free plans do not retain data past our real-time window.

How Volume Is Calculated

Volume is calculated for each individual log line that you send to your Timber account. This is a byte size calculation. Because log lines can come in many forms (JSON, msgpack, text, etc), Timber normalizes all log lines into msgpack before calculating the byte size. This favors you, the customer, by removing any encoding "cruft" and ultimately producing a byte size calculation that is smaller. For example, given the following payload of log lines sent to Timber in application/ndjson format:

{"level":"info","message":"This is the first log line"}
{"level":"error","message":"This is the second log line","key":"val"}

The calculated byte size would be 104 bytes. Here's how we calculated that. In your sheel run:

sudo gem install msgpack-ruby

Then execute the following Ruby code:

line1 = MessagePack.pack({"level":"info","message":"This is the first log line"})
line2 = MessagePack.pack({"level":"error","message":"This is the second log line","key":"val"})
line1.bytesize + line2.bytesize
=> 104

If we were to use the raw JSON byte size we would end up with 124 bytes instead!

Choosing The Right Plan

Timber allows you to change your plan as frequently as you like, your plan will be pro-rated across your billing period. Therefore, we recommend starting with an aggressive limit and then upgrading as you get a better feel for your usage. Timber will send you multiple notifications as you approach and exceed your limit.



Timber offers trials, making it easy to for your experience Timber in real production environments:

  1. Your 14 day trial period begins when you create your account.

  2. You will not be billed during the trial period.

  3. Trials begin the moment you upgrade.

  4. You are free to upgrade and downgrade as much as you like without affecting your trial.

  5. Once the trial ends, your account will be billed as normal.

  6. Trials are once per customer, regardless if you downgrade and upgrade again.

Billing Periods

Your subscription operates on intervals called billing periods. By default, a single billing period is 30 days. All usage is totaled over a single billing period and resets when a new billing period starts.

Exceeding Your Limit

Timber defines 3 water marks as you approach and exceed your limit. Each watermark will deliver a notification to your designated system notification destination. Each watermark is described below:

80% Watermark

When you've used 80% of your allotted volume we'll send a notification to your designated system notification destination and display a warning within the Timber app itself.

100% Watermark

When you've used 100% of your allotted volume we'll send a notification to your designated system notification destination and display a stringent warning within the Timber app itself. As a courtesy, we will not deny log data, providing you with more time to adjust your plan.

120% Watermark

When you've used 100% of your allotted volume we'll send a notification to your designated system notification destination and display a red noticed within the Timber app itself stating that we have stopped accepting logs. For cost reasons we cannot continue to accept logs until you change your plan to one with a higher volume limit.

Changing Plans

You can change your plan by:

  1. Navigating to the settings section using the main navigation.

  2. Click on the "Plan & Payment" tab.

  3. Click on the "Change Plan" button.

  4. Select your desired plan details.

  5. Click "Update Plan".

Payment Methods

Changing Payment Methods

  1. Navigating to the settings section using the main navigation.

  2. Click on the "Plan & Payment" tab.

  3. Click the "Add card" button.

  4. Fill out the form with your card details.

  5. After the card is added, open the context menu, a click "Make default".

  6. This payment method will be used going forward.

  7. Optionally remove the old payment method.

Failed Payments

Timber will retry failed payments up to 3 times, at which point your account will be marked as delinquent and any new log data will be denied until payment is made.

International Currencies

Timber accepts Visa, Mastercard, American Express, Discover, and Diners Club payments worldwide. There are no currency restrictions if you use a valid credit card.


You can view a list of all invoices by:

  1. Navigating to your organization's settings section.

  2. Click on the "Invoices" tab.


Timber is PCI compliant and does not retain payment information in any way. You can read more about our security in our Security and Compliance guides.


You may cancel your Timber account at any time. You can accomplish by either:


Can I delete old data to make room for new data?

Like all other logging platforms, Timber's billing plans are usage based, not storage based. For example, if you send Timber 1gb per day for 30 days, your total usage would be 30gb, regardless if you clear or delete your data. This means if you would need at least a 30gb plan to accomodate this volume.

As much as we'd like to offer storage based plans we simply cannot. To understand why, you must understand that the bulk of any ingestion pipeline's cost is in processing and querying the data, not storing it. Timber goes to great lengths to process your data in such a way that provides for very fast exploratory searching and we do so in the most efficient way possible.

If you find that you are bumping into your limit and wish to reduce cost we recommend checking out our Reducing Log Volume guide. There are a lot of ways most users can substantially reduce their log volume which will have the largest impact on reducing your cost.