Documentation

Sample data

This page documents an earlier version of InfluxDB. InfluxDB v2.6 is the latest stable version. View this page in the v2.6 documentation.

Use sample data to familiarize yourself with time series data and InfluxDB. InfluxData provides many sample time series datasets to use with InfluxDB. You can also use the Flux InfluxDB sample package to view, download, and output sample datasets.

Air sensor sample data

Size: ~600 KB • Updated: every 15m

Air sensor sample data represents an “Internet of Things” (IoT) use case by simulating temperature, humidity, and carbon monoxide levels for multiple rooms in a building.

To download and output the air sensor sample dataset, use the sample.data() function.

import "influxdata/influxdb/sample"

sample.data(set: "airSensor")

Companion SQL sensor data

The air sensor sample dataset is paired with a relational SQL dataset with meta information about sensors in each room. These two sample datasets are used to demonstrate how to join time series data and relational data with Flux in the Query SQL data sources guide.

Download SQL air sensor data

Bird migration sample data

Size: ~1.2 MB • Updated: N/A

Bird migration sample data is adapted from the Movebank: Animal Tracking data set and represents animal migratory movements throughout 2019.

To download and output the bird migration sample dataset, use the sample.data() function.

import "influxdata/influxdb/sample"

sample.data(set: "birdMigration")

The bird migration sample dataset is used in the Work with geo-temporal data guide to demonstrate how to query and analyze geo-temporal data.

NOAA sample data

There are two National Oceanic and Atmospheric Administration (NOAA) datasets available to use with InfluxDB.

NOAA NDBC data

Size: ~1.3 MB • Updated: every 15m

The NOAA National Data Buoy Center (NDBC) dataset provides the latest observations from the NOAA NDBC network of buoys throughout the world. Observations are updated approximately every 15 minutes.

To download and output the most recent NOAA NDBC observations, use the sample.data() function.

import "influxdata/influxdb/sample"

sample.data(set: "noaa")

Store historical NOAA NDBC data

The NOAA NDBC sample dataset only returns the most recent observations; not historical observations. To regularly query and store NOAA NDBC observations, add the following as an InfluxDB task. Replace example-org and example-bucket with your organization name and the name of the bucket to store data in.

import "influxdata/influxdb/sample"

option task = {
  name: "Collect NOAA NDBC data"
  every: 15m,
}

sample.data(set: "noaa")
  |> to(
      org: "example-org",
      bucket: "example-bucket"
  )

NOAA water sample data

Size: ~10 MB • Updated: N/A

The NOAA water sample dataset is static dataset extracted from NOAA Center for Operational Oceanographic Products and Services data. The sample dataset includes 15,258 observations of water levels (ft) collected every six minutes at two stations (Santa Monica, CA (ID 9410840) and Coyote Creek, CA (ID 9414575)) over the period from August 18, 2015 through September 18, 2015.

Store NOAA water sample data to avoid bandwidth usage

To avoid having to re-download this 10MB dataset every time you run a query, we recommend that you create a new bucket (noaa) and write the NOAA sample water data to it.

import "experimental/csv"

csv.from(url: "https://influx-testdata.s3.amazonaws.com/noaa.csv")
    |> to(bucket: "noaa", org: "example-org")

The NOAA water sample dataset is used to demonstrate Flux queries in the Common queries and Common tasks guides.

USGS Earthquake data

Size: ~6 MB • Updated: every 15m

The United States Geological Survey (USGS) earthquake dataset contains observations collected from USGS seismic sensors around the world over the last week. Data is updated approximately every 15m.

To download and output the last week of USGS seismic data, use the sample.data() function.

import "influxdata/influxdb/sample"

sample.data(set: "usgs")

Was this page helpful?

Thank you for your feedback!


Set your InfluxDB URL

Linux Package Signing Key Rotation

All signed InfluxData Linux packages have been resigned with an updated key. If using Linux, you may need to update your package configuration to continue to download and verify InfluxData software packages.

For more information, see the Linux Package Signing Key Rotation blog post.

InfluxDB Cloud backed by InfluxDB IOx

All InfluxDB Cloud organizations created on or after January 31, 2023 are backed by the new InfluxDB IOx storage engine. Check the right column of your InfluxDB Cloud organization homepage to see which InfluxDB storage engine you’re using.

If powered by IOx, this is the correct documentation.

If powered by TSM, see the TSM-based InfluxDB Cloud documentation.

InfluxDB Cloud backed by InfluxDB TSM

All InfluxDB Cloud organizations created on or after January 31, 2023 are backed by the new InfluxDB IOx storage engine which enables nearly unlimited series cardinality and SQL query support. Check the right column of your InfluxDB Cloud organization homepage to see which InfluxDB storage engine you’re using.

If powered by TSM, this is the correct documentation.

If powered by IOx, see the IOx-based InfluxDB Cloud documentation.

State of the InfluxDB Cloud (IOx) documentation

The new documentation for InfluxDB Cloud backed by InfluxDB IOx is a work in progress. We are adding new information and content almost daily. Thank you for your patience!

If there is specific information you’re looking for, please submit a documentation issue.