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
- Quickly start collecting data
- Load data from sources in the InfluxDB UI
- Use no-code solutions
- Use developer tools
- Best practices for writing data
- Migrate historical data
- Next steps
What you’ll need
To write data into InfluxDB, you need the following:
- organization – See View organizations for instructions on viewing your organization ID.
- bucket – See View buckets for instructions on viewing your bucket ID.
- authentication token – See View tokens for instructions on viewing your authentication token.
- InfluxDB URL – See InfluxDB URLs.
The InfluxDB setup process creates each of these.
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
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 (
you must specify the precision in your write request.
InfluxDB accepts the following precisions:
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
In the navigation menu on the left, click Data (Load Data) > Buckets.
Click Add Demo Data, and then select the demo data bucket to add.
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:
In the navigation menu on the left, click Boards (Dashboards).
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
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
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
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.
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB and this documentation. To find support, the following resources are available:
InfluxDB Cloud and InfluxDB Enterprise customers can contact InfluxData Support.