influxdata/influxdb · error · WriteParseError

<transparent: SingleTenantExtractError>

Error message

<transparent: SingleTenantExtractError>

What it means

This is a transparent wrapper in iox_http's WriteParseError for SingleTenantExtractError. It occurs when parsing a single-tenant HTTP write request fails; the inner extraction error's message is displayed unchanged. It aggregates failures like invalid line protocol or bad write parameters in single-tenant mode.

Solutions

1. Read the inner SingleTenantExtractError message for the concrete failure.
2. Validate line protocol payload and Content-Type before sending.
3. Ensure the client targets the correct single-tenant endpoint contract.
4. Test the payload with a known-good writer to isolate the malformed part.

// Rust: sanity-check single-tenant write request before sending
fn single_tenant_write_ok(body: &str, content_type: &str) -> bool {
    content_type.starts_with("text/plain") // line protocol
        && body.lines().all(|l| !l.trim().is_empty())
}

fn is_single_tenant_err(e: &WriteParseError) -> bool {
    matches!(e, WriteParseError::SingleTenantError(_))
}

When it happens

Trigger: POSTing a write request to the single-tenant endpoint where request extraction (body decoding, line protocol parsing, params) fails.

Common situations: Malformed line protocol payloads; wrong Content-Type/encoding headers; legacy single-tenant clients sending unexpected fields.

Understand the failure class

Background: Schema validation failed / invalid input schema: payload rejected because its shape doesn't match the expected schema — this error's family across 28 libraries.

Related errors

• <transparent: MultiTenantExtractError>
• <transparent: V2WriteParseError>
• line protocol parse failed
• missing bucket value
• not implemented

AI-assisted analysis of influxdata/influxdb@06200ef96b (2026-09-19). Data as JSON: /api/errors/b04e66918951a19a. Report an issue: GitHub.

Appendix: source

Thrown at core/iox_http/src/write/params.rs:49

            Self::Nanosecond => 1,
        }
    }
}

#[derive(Debug)]
/// Standardized DML operation parameters
pub struct WriteParams {
    pub namespace: NamespaceName<'static>,
    pub precision: Precision,
}

#[derive(Debug, thiserror::Error)]
pub enum WriteParseError {
    #[error("not implemented")]
    NotImplemented,

    /// An error parsing a single-tenant HTTP request.
    #[error(transparent)]
    SingleTenantError(#[from] SingleTenantExtractError),

    /// An error parsing a multi-tenant HTTP request.
    #[error(transparent)]
    MultiTenantError(#[from] MultiTenantExtractError),
}

impl From<&WriteParseError> for hyper::StatusCode {
    fn from(value: &WriteParseError) -> Self {
        match value {
            WriteParseError::NotImplemented => Self::METHOD_NOT_ALLOWED,
            WriteParseError::SingleTenantError(e) => Self::from(e),
            WriteParseError::MultiTenantError(e) => Self::from(e),
        }
    }
}

/// A [`WriteRequestUnifier`] abstraction returns a unified [`WriteParams`]

View on GitHub (pinned to 06200ef96b)