Write data to InfluxDB

Discover what you’ll need to write data into InfluxDB Cloud or OSS (open source). Learn how to quickly start collecting data, and then explore ways to write data, best practices, and what we recommend if you’re migrating a large amount of historical data.

What you’ll need

To write data into InfluxDB, you need the following:

  • organizationSee View organizations for instructions on viewing your organization ID.
  • bucketSee View buckets for instructions on viewing your bucket ID.
  • authentication tokenSee View tokens for instructions on viewing your authentication token.
  • InfluxDB URLSee InfluxDB URLs.

The InfluxDB setup process creates each of these.

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 and InfluxDB OSS 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.

Quick Start for InfluxDB OSS

Select Quick Start in the last step of the InfluxDB user interface’s (UI) setup process to quickly start collecting data with InfluxDB. Quick Start creates a data scraper that collects metrics from the InfluxDB /metrics endpoint. The scraped data provides a robust dataset of internal InfluxDB metrics that you can query, visualize, and process.

Use Quick Start to collect InfluxDB metrics

After setting up InfluxDB v2.0, the “Let’s start collecting data!” page displays options for collecting data. Click Quick Start.

InfluxDB creates and configures a new scraper. The target URL points to the /metrics HTTP endpoint of your local InfluxDB instance (for example, http://localhost:9999/metrics), which outputs internal InfluxDB metrics in the Prometheus data format. The scraper stores the scraped metrics in the bucket created during the initial setup process.

Quick Start is only available in the last step of the setup process. If you missed the Quick Start option, you can manually create a scraper that scrapes data from the /metrics endpoint.

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?