---
title: Troubleshoot issues writing data
description: 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.
url: https://docs.influxdata.com/influxdb3/enterprise/write-data/troubleshoot/
estimated_tokens: 2386
product: InfluxDB 3 Enterprise
version: enterprise
---

# Troubleshoot issues writing data

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

-   [Handle write responses](#handle-write-responses)
    -   [Review HTTP status codes](#review-http-status-codes)
-   [Troubleshoot failures](#troubleshoot-failures)
-   [Troubleshoot rejected points](#troubleshoot-rejected-points)
-   [Troubleshoot write performance issues](#troubleshoot-write-performance-issues)
    -   [Use debug logs for troubleshooting](#use-debug-logs-for-troubleshooting)

## Handle write responses

InfluxDB 3 Enterprise does the following when you send a write request:

1. Validates the request.
    
2. If successful, attempts to ingest data from the request body; otherwise, responds with an [error status](#review-http-status-codes).
    
3. Ingests or rejects data in the batch and returns one of the following HTTP status codes:
    
    -   `204 No Content`: All data in the batch is ingested.
    -   `400 Bad Request`: Some or all of the data has been rejected. Data that has not been rejected is ingested and queryable.

The response body contains error details about [rejected points](#troubleshoot-rejected-points), up to 100 points.

Writes are synchronous–the response status indicates the final status of the write and all ingested data is queryable.

To ensure that InfluxDB handles writes in the order you request them, wait for the response before you send the next request.

### Review HTTP status codes

InfluxDB 3 Enterprise 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:

| HTTP response code | Message | Description |
| --- | --- | --- |
| 204 "Success" |  | If InfluxDB ingested the data |
| 400 "Bad request" | error details about rejected points, up to 100 points: line contains the first rejected line, message describes rejections | If some or all request data isn’t allowed (for example, if it is malformed or falls outside of the bucket’s retention period)–the response body indicates whether a partial write has occurred or if all data has been rejected |
| 401 "Unauthorized" |  | If the Authorization header is missing or malformed or if the token doesn’t have permission to write to the database. See write API examples using credentials. |
| 404 "Not found" | requested resource type (for example, “organization” or “database”), and resource name | If a requested resource (for example, organization or database) wasn’t found |
| 500 "Internal server error" |  | Default status for an error |
| 503 “Service unavailable” |  | If the server is temporarily unavailable to accept writes. The Retry-After header describes when to try the write again. |

If your data did not write to the database, see how to [troubleshoot rejected points](#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](#troubleshoot-rejected-points).
-   Verify all lines contain valid syntax ([line protocol](/influxdb3/enterprise/reference/syntax/line-protocol/)).
-   Verify the timestamps in your data match the [precision parameter](/influxdb3/enterprise/reference/glossary/#precision) in your request.
-   Minimize payload size and network errors by [optimizing writes](/influxdb3/enterprise/write-data/best-practices/optimize-writes/).

## Troubleshoot rejected points

InfluxDB rejects points that don’t match the schema of existing data.

Check for [field data type](/influxdb3/enterprise/reference/syntax/line-protocol/#data-types-and-format) differences between the rejected data point and points within the same database–for example, did you attempt to write `string` data to an `int` field?

## Troubleshoot write performance issues

If you experience slow write performance or timeouts during high-volume ingestion, consider the following:

### Memory configuration

InfluxDB 3 Enterprise uses memory for both query processing and internal data operations, including converting data to Parquet format during persistence. For write-heavy workloads, insufficient memory allocation can cause performance issues.

**Symptoms of memory-related write issues:**

-   Slow write performance during data persistence (typically every 10 minutes)
-   Increased response times during high-volume ingestion
-   Memory-related errors in server logs

**Solutions:**

-   Increase the [`exec-mem-pool-bytes`](/influxdb3/enterprise/reference/config-options/#exec-mem-pool-bytes) configuration to allocate more memory for data operations. For write-heavy workloads, consider setting this to 30-40% of available memory.
-   Monitor memory usage during peak write periods to identify bottlenecks.
-   Adjust the [`gen1-duration`](/influxdb3/enterprise/reference/config-options/#gen1-duration) to control how frequently data is persisted to Parquet format.

### Example configuration for write-heavy workloads

```bash
influxdb3 serve \
  --exec-mem-pool-bytes PERCENTAGE \
  --gen1-duration 15m \
  # ... other options
```

Replace `PERCENTAGE` with the percentage of available memory to allocate (for example, `35%` for write-heavy workloads).

### Use debug logs for troubleshooting

For deeper investigation of write issues, enable debug logging for specific components. Debug logs provide detailed information about write buffer operations and WAL activity.

To enable debug logs for write operations, restart InfluxDB 3 Enterprise with targeted log filters:

```sh
influxdb3 serve --log-filter info,influxdb3_write_buffer=debug
```

```sh
influxdb3 serve --log-filter info,influxdb3_wal=debug
```

For more information about log levels and targeted filtering, see [log-filter configuration](/influxdb3/enterprise/reference/config-options/#log-filter).

#### Related

-   [Best practices for writing data](/influxdb3/enterprise/write-data/best-practices/)
-   [InfluxDB 3 Enterprise Internals](/influxdb3/enterprise/reference/internals/durability/)

[write](/influxdb3/enterprise/tags/write/) [line protocol](/influxdb3/enterprise/tags/line-protocol/) [errors](/influxdb3/enterprise/tags/errors/)