Background #

Currently, all components that read from object store assume that all the operations and functionality should be done based on all the available blocks that are present in the certain bucket’s root directory.

This is in most cases totally fine, however with time and allowance of storing blocks from multiple Sources into the same bucket, the number of objects in a bucket can grow drastically.

This means that with time you might want to scale out certain components e.g:

Compactor #

Larger number of objects does not matter much, however compactor has to scale (CPU, network, disk, memory) with number of Sources pushing blocks to the object storage.

Store Gateway #

Queries against store gateway which are touching large number of blocks (no matter from what Sources) might be expensive, so it can scale with number of blocks.

Relabelling #

Similar to promtail this config will follow native Prometheus relabel-config syntax.

Now, thanos only support following relabel actions:

  • keep

  • drop

  • hashmod

    • external labels for all components

    • __block_id for store gateway, see this example

The relabel config defines filtering process done on every synchronization with object storage.

We will allow potentially manipulating with several of inputs:

  • External labels:
    • <name>


  • If output is empty, drop block.

By default, on empty relabel-config, all external labels are assumed.

Example usages would be:

  • Drop blocks which contains external labels cluster=A
- action: drop
  regex: "A"
  - cluster
  • Keep only blocks which contains external labels cluster=A
- action: keep
  regex: "A"
  - cluster

We can shard by adjusting which labels should be included in the blocks.

Time Partitioning #

For store gateway, we can specify --min-time and --max-time flags to filter for what blocks store gateway should be responsible for.

More details can refer to “Time based partitioning” chapter in Store gateway.

Found a typo, inconsistency or missing information in our docs? Help us to improve Thanos documentation by proposing a fix on GitHub here ❤️