Documentation

Query sample data

Use InfluxDB Cloud sample datasets to quickly access data that lets you explore and familiarize yourself with InfluxDB Cloud without requiring you to have to write your own data.

Network bandwidth

Each execution of sample.data() downloads the specified dataset from Amazon S3. If using InfluxDB Cloud or a hosted InfluxDB OSS instance, you may see additional network bandwidth costs when using this function. Approximate sample dataset sizes are listed for each sample dataset and in the output of sample.list().

Choose sample data

  1. Choose from the following sample datasets:
    • Air sensor sample data: Explore, visualize, and monitor humidity, temperature, and carbon monoxide levels in the air.
    • Bird migration sample data: Explore, visualize, and monitor the latitude and longitude of bird migration patterns.
    • NOAA NDBC sample data: Explore, visualize, and monitor NDBC’s observations from their buoys. This data observes air temperature, wind speed, and more from specific locations.
    • NOAA water sample data: Explore, visualize, and monitor temperature, water level, pH, and quality from specific locations.
    • USGS Earthquake data: Explore, visualize, and monitor earthquake monitoring data. This data includes alerts, cdi, quarry blast, magnitude, and more.
  2. Do one of the following to download sample data:

Add sample data with community template

  1. In the navigation menu on the left, select Settings > Templates.

  2. Paste the Sample Data community temple URL in resource manifest file field:

  3. Paste the Sample Data community template URL in the resource manifest file field and click the Lookup Template button.

Sample Data community template URL

    https://github.com/influxdata/community-templates/blob/master/sample-data/sample-data.yml

Explore sample data

Use the Data Explorer to query and visualize data in sample data buckets.

In the navigation menu on the left, click Data Explorer.

Add sample data

  1. In the navigation menu on the left, click Data (Load Data) > Buckets.

  2. Click Create bucket, and then name your bucket. The bucket will appear in your list of buckets.

  3. View the sample datasets document and choose a sample data to query.

  4. Copy the sample.data() function listed underneath.

  5. Click Explore on the left navigation of InfluxDB Cloud and click your bucket, and then click Script Editor.

  6. Paste the sample.data() function.

  7. Click Submit to run the query.

For more information about querying in the Script Editor, see how to Query data with Flux and the Data Explorer.

Create sample data dashboards

After adding a sample data bucket, create a dashboard specific to the sample dataset:

  1. Click Boards (Dashboards) in the navigation menu on the left.

  2. Click Create Dashboard > New Dashboard, and name the dashboard after your bucket.

  3. Click Add Cell, and select your sample data bucket.

  4. Click Script Editor.

  5. Copy and paste the sample.data() function into the script editor.

  6. Click Submit to run the query.

  7. Define the variables of your sample data.


Was this page helpful?

Thank you for your feedback!


Select your region

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.