Write data to InfluxDB 3 Core
InfluxDB 3 Core is in Public Alpha
InfluxDB 3 Core is in public alpha and available for testing and feedback, but is not meant for production use. Both the product and this documentation are works in progress. We welcome and encourage your input about your experience with the alpha and invite you to join our public channels for updates and to share feedback.
Use tools like the influxctl
CLI, Telegraf, and InfluxDB client libraries to
to write time series data to InfluxDB 3 Core. Line protocol
is the text-based format used to write data to InfluxDB. There are tools
available to covert other formats (for example—CSV)
to line protocol.
Choose the write endpoint for your workload
When bringing existing v1 write workloads, use the InfluxDB 3 Core
HTTP API /write
endpoint.
When creating new write workloads, use the HTTP API
/api/v2/write
endpoint.
Line protocol
All data written to InfluxDB is written using line protocol, a text-based format that lets you provide the necessary information to write a data point to InfluxDB.
Line protocol elements
In InfluxDB, a point contains a table name, one or more fields, a timestamp, and optional tags that provide metadata about the observation.
Each line of line protocol contains the following elements:
* Required- * table: A string that identifies the table to store the data in.
- tag set: Comma-delimited list of key value pairs, each representing a tag. Tag keys and values are unquoted strings. Spaces, commas, and equal characters must be escaped.
- * field set: Comma-delimited list of key value pairs, each representing a field. Field keys are unquoted strings. Spaces and commas must be escaped. Field values can be strings (quoted), floats, integers, unsigned integers, or booleans.
- timestamp: Unix timestamp associated with the data. InfluxDB supports up to nanosecond precision. If the precision of the timestamp is not in nanoseconds, you must specify the precision when writing the data to InfluxDB.
Line protocol element parsing
- table: Everything before the first unescaped comma before the first whitespace.
- tag set: Key-value pairs between the first unescaped comma and the first unescaped whitespace.
- field set: Key-value pairs between the first and second unescaped whitespaces.
- timestamp: Integer value after the second unescaped whitespace.
- Lines are separated by the newline character (
\n
). Line protocol is whitespace sensitive.
myTable, field1="v1",field2=1i
For schema design recommendations, see InfluxDB schema design.
Write data to InfluxDB
Use the influxdb3 CLI to write data
Use the influxdb3
CLI to write line protocol data to InfluxDB Clustered.
Use Telegraf to write data
Use Telegraf to collect and write data to InfluxDB 3 Core.
Use InfluxDB client libraries to write data
Use InfluxDB API clients to write points as line protocol data to InfluxDB Clustered.
Best practices for writing data
Learn about the recommendations and best practices for writing data to InfluxDB 3 Core.
Troubleshoot issues writing data
Troubleshoot issues writing data. Find response codes for failed writes. Discover how writes fail, from exceeding rate or payload limits, to syntax errors and schema conflicts.
Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB 3 Core and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support.