Documentation

Write data to InfluxDB

Collect and write time series data to InfluxDB Cloud and InfluxDB OSS. Discover how to quickly start collecting data, and then explore other ways to write data using no-code solutions or developer tools.

What you’ll need

To write data into InfluxDB, you need the following:

Use line protocol format to write data into InfluxDB. Each line represents a data point. Each point requires a measurement and field set and may also include a tag set and a timestamp.

Line protocol data looks like this:

mem,host=host1 used_percent=23.43234543 1556892576842902000
cpu,host=host1 usage_user=3.8234,usage_system=4.23874 1556892726597397000
mem,host=host1 used_percent=21.83599203 1556892777007291000

Timestamp precision

When writing data to InfluxDB, we recommend including a timestamp with each point. If a data point does not include a timestamp when it is received by the database, InfluxDB uses the current system time (UTC) of its host machine.

The default precision for timestamps is in nanoseconds. If the precision of the timestamps is anything other than nanoseconds (ns), you must specify the precision in your write request. InfluxDB accepts the following precisions:

  • ns - Nanoseconds
  • us - Microseconds
  • ms - Milliseconds
  • s - Seconds

For more details about line protocol, see the Line protocol reference and Best practices for writing data.

Quickly start collecting data

Familiarize yourself with querying, visualizing, and processing data in InfluxDB Cloud by collecting data right away. The following options are available:

Demo data for InfluxDB Cloud

Use InfluxDB Cloud demo data buckets for quick and easy access to different types of demo data that let you explore and familiarize yourself with InfluxDB Cloud.

Free to use and read-only

  • InfluxDB Cloud demo data buckets are free to use and are not subject to Free Plan rate limits.
  • Demo data buckets are read-only. You cannot write data into demo data buckets.

Demo data sets

Choose from the following demo data sets:

  • Website Monitoring
    Explore, visualize, and monitor HTTP response metrics from InfluxData websites.

Add a demo data bucket

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

  2. Click Add Demo Data, and then select the demo data bucket to add.

  3. The Demo Data bucket appears in your list of buckets.

Explore demo data

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

In the navigation menu on the left, click Explore (Data Explorer).

View demo data dashboards

After adding a demo data bucket, view the pre-built dashboard specific to the demo data set:

  1. In the navigation menu on the left, click Boards (Dashboards).

  2. Click the name of the dashboard that corresponds to your demo data bucket.

Other sample data sets

See Sample data for more sample InfluxDB data sets.

Sample data

Use sample data sets to quickly populate InfluxDB with sample time series data.


Other ways to write data

There are multiple options for writing data into InfluxDB, including both no-code and developer solutions.


Next steps

With your data in InfluxDB, you’re ready to do one or more of the following:

Query and explore your data

Query data using Flux, the UI, and the influx command line interface. See Query data.

Process your data

Use InfluxDB tasks to process and downsample data. See Process data.

Visualize your data

Build custom dashboards to visualize your data. See Visualize data.

Monitor your data and send alerts

Monitor your data and sends alerts based on specified logic. See Monitor and alert.


New! Cloud or OSS?

InfluxDB OSS 2.0 now generally available!

InfluxDB OSS 2.0 is now generally available and ready for production use. See the InfluxDB OSS 2.0 release notes.

For information about upgrading to InfluxDB OSS 2.0, see: