influxdata/influxdb · critical · Error

Operation with object store failed

Error message

Operation with object store failed: {0}

What it means

Wraps object_store::Error raised when an operation against the configured object store (local filesystem, S3, GCS, Azure) fails during HTTP request handling. The query/write path reads and writes parquet and catalog data through the object store, so any storage backend failure surfaces here.

Solutions

  1. Read the inner object_store error for the backend, operation, and HTTP/OS status.
  2. Verify object store configuration (endpoint, bucket/container, region, credentials).
  3. Test backend connectivity and permissions with the provider CLI (aws s3 ls, gsutil ls).
  4. Retry transient network errors; check provider status pages for outages.

Example fix

// before
INFLUXDB3_OBJECT_STORE=s3 INFLUXDB3_BUCKET=data  # no credentials configured
// after
export AWS_ACCESS_KEY_ID=...
export AWS_SECRET_ACCESS_KEY=...
export AWS_REGION=us-east-1
Defensive patterns

Strategy: retry

Validate before calling

// preflight: check object store reachability and credentials at startup
await provider.list({ maxKeys: 1 });

Try / catch

try { await queryOrWrite(); } catch (e) { if (e.message.startsWith('Operation with object store failed')) { await backoffRetry(queryOrWrite); checkObjectStoreConfig(); } else throw e; }

Prevention

When it happens

Trigger: Querying or writing when the backend returns an error: bucket/container does not exist, credentials are rejected, network to S3/GCS/Azure fails, or a local object-store path is missing or unreadable.

Common situations: Misconfigured AWS/GCS credentials or region; deleted or renamed bucket; network partitions to cloud storage; local dev setups where the object-store directory was removed.

Related errors


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

Appendix: source

Thrown at influxdb3_server/src/http.rs:346

    #[error("error in InfluxQL statement: {0}")]
    InfluxqlRewrite(#[from] rewrite::Error),

    #[error("must provide only one InfluxQl statement per query")]
    InfluxqlSingleStatement,

    #[error("must specify a 'db' parameter, or provide the database in the InfluxQL query")]
    InfluxqlNoDatabase,

    #[error(
        "provided a database in both the parameters ({param_db}) and \
        query string ({query_db}) that do not match, if providing a query \
        that specifies the database, you can omit the 'database' parameter \
        from your request"
    )]
    InfluxqlDatabaseMismatch { param_db: String, query_db: String },

    #[error("Operation with object store failed: {0}")]
    ObjectStore(#[from] object_store::Error),

    #[error("heap dump failed: {0}")]
    HeapPprof(#[from] jemalloc_pprof_http::Error),

    #[error(transparent)]
    Catalog(#[from] CatalogError),

    #[error("Python plugins not enabled on this server")]
    PythonPluginsNotEnabled,

    #[error("Plugin error: {0}")]
    Plugin(#[from] influxdb3_processing_engine::plugins::PluginError),

    #[error("Processing engine error: {0}")]
    ProcessingEngine(#[from] influxdb3_processing_engine::manager::ProcessingEngineError),

    #[error(transparent)]

View on GitHub (pinned to 06200ef96b)