Downsample data with notebooks

Create a notebook to downsample data. Downsampling aggregates or summarizes data within specified time intervals, reducing the overall disk usage as data collects over time.

The following example creates a notebook that queries Coinbase bitcoin price sample data from the last hour, downsamples the data into ten minute summaries, and then writes the downsampled data to an InfluxDB bucket.

  1. If you do not have an existing bucket to write the downsampled data to, create a new bucket.

  2. Create a new notebook.

  3. Select Past 1h from the time range drop-down list at the top of your notebook.

  4. In the Build a Query cell:

    1. In the FROM column under Sample, select Coinbase bitcoin price.
    2. In the next FILTER column, select _measurement from the drop-down list and select the coindesk measurement in the list of measurements.
    3. In the next FILTER column, select _field from the drop-down list, and select the price field from the list of fields.
    4. In the next FILTER column, select code from the drop-down list, and select a currency code.
  5. Click after your Build a Query cell to add a new cell and select Flux Script.

  6. In the Flux script cell:

    1. Use __PREVIOUS_RESULT__ to load the output of the previous notebook cell into the Flux script.

    2. Use aggregateWindow() to window data into ten minute intervals and return the average of each interval. Specify the following parameters:

      • every: Window interval (should be less than or equal to the duration of the queried time range). For this example, use 10m.
      • fn: Aggregate or selector function to apply to each window. For this example, use mean.
        |> aggregateWindow(every: 10m, fn: mean)
  7. Click after your Flux Script cell to add a new cell and select Output to Bucket. Select a bucket from the Choose a bucket drop-down list.

  8. (Optional) Click and select Note to add a note to describe your notebook, for example, “Downsample Coinbase bitcoin prices into hourly averages.”

  9. Click Preview in the upper left to verify that your notebook runs and displays the output.

  10. Click Run to run the notebook and write the downsampled data to your bucket.

Continuously run a notebook

To continuously run your notebook, export the notebook as a task:

  1. Click to add a new cell, and then select Task.

  2. Provide the following:

    • Every: Interval that the task should run at.
    • Offset: (Optional) Time to wait after the defined interval to execute the task. This allows the task to capture late-arriving data.
  3. Click Export as Task.

Was this page helpful?

Thank you for your feedback!

The future of Flux

Flux is going into maintenance mode. You can continue using it as you currently are without any changes to your code.

Flux is going into maintenance mode and will not be supported in InfluxDB 3.0. This was a decision based on the broad demand for SQL and the continued growth and adoption of InfluxQL. We are continuing to support Flux for users in 1.x and 2.x so you can continue using it with no changes to your code. If you are interested in transitioning to InfluxDB 3.0 and want to future-proof your code, we suggest using InfluxQL.

For information about the future of Flux, see the following: