Skip to content

Explain bucket concepts #887

Open
Open
@alsargent

Description

@alsargent

On https://v2.docs.influxdata.com/v2.0/organizations/buckets/, please explain the considerations someone might want to take to create additional buckets. You can use the text below as a starting point:

The main reasons for creating separate buckets are:

  1. Data organization: putting all related measurements into the same place. For example, maybe you want one bucket for weather measurements from your windmills (temperature, windspeed, etc.) and another bucket relating to power generation for your windmills.

  2. Retention policy: each bucket has its own data retention policy. For example, you can store high granularity data collected once every 5 seconds in one bucket. But, the storage for that will become quite large. So, you might want to retain that raw data for just 30 days, and have another bucket that rolls up that data into min/max/average for one hour periods. That second bucket might keep data for 10 years or whatever is required for a windmill operator.

  3. Security: each token in InfluxDB is allowed to read and/or write to a certain set of buckets. By controlling access to these tokens, you control which buckets can be accessed. For example, a windmill operator might want to provide public access to their raw weather data to developers, as a public service, but keep energy data private. Having one bucket for weather, and another for power generation, allows them to do this.

Here's our page for managing authentication tokens:
https://v2.docs.influxdata.com/v2.0/security/tokens/

And here's our page for rolling up data, also called downsampling:
https://v2.docs.influxdata.com/v2.0/process-data/common-tasks/downsample-data/

Relevant URLs

https://v2.docs.influxdata.com/v2.0/organizations/buckets/

Metadata

Metadata

Assignees

Labels

enhancementNew feature or request

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions