Troubleshoot issues writing data

Learn how to avoid unexpected results and recover from errors when writing to InfluxDB Clustered.

• Handle write responses
  • Review HTTP status codes
• Troubleshoot failures
• Troubleshoot rejected points

Handle write responses

In InfluxDB Clustered, writes are synchronous. After InfluxDB validates the request and ingests the data, it sends a success response (HTTP 204 status code) as an acknowledgement that the data is written and queryable. To ensure that InfluxDB handles writes in the order you request them, wait for the acknowledgement before you send the next request.

If InfluxDB successfully writes all the request data to the database, it returns success (HTTP 204 status code). The first rejected point in a batch causes InfluxDB to reject the entire batch and respond with an HTTP error status.

Review HTTP status codes

InfluxDB uses conventional HTTP status codes to indicate the success or failure of a request. The message property of the response body may contain additional details about the error. Write requests return the following status codes:

If your data did not write to the database, see how to troubleshoot rejected points.

Troubleshoot failures

If you notice data is missing in your database, do the following:

• Check the message property in the response body for details about the error.
• If the message describes a field error, troubleshoot rejected points.
• Verify all lines contain valid syntax (line protocol).
• Verify the timestamps in your data match the precision parameter in your request.
• Minimize payload size and network errors by optimizing writes.

Troubleshoot rejected points

InfluxDB rejects points that fall within the same partition (default partitioning is measurement and day) as existing bucket data and have a different data type for an existing field.

Check for field data type differences between the rejected data point and points within the same database and partition–for example, did you attempt to write string data to an int field?