influxdata/influxdb · error · Error

client error

Error message

client error: {0}

What it means

Variant of the `influxdb3 show system` command's Error enum, produced via #[from] when an influxdb3_client::Error occurs while querying a system table through the HTTP client. The raw client error is displayed prefixed with "client error: ".

Solutions

1. Confirm the server is reachable at the given --host address (curl the health endpoint).
2. Check the token/credentials passed to the show command.
3. Inspect the inner influxdb3_client::Error text for the concrete HTTP cause.
4. Retry if the failure was transient network or timeout related.

curl -fsS "$HOST/health" >/dev/null || { echo 'server unreachable'; exit 1; }

match cmd_result {
    Err(Error::InfluxDB3Client(e)) => {
        // inspect e: retry on timeout/transient, fix host/token on connect/auth errors
    }
    ...
}

When it happens

Trigger: Running `influxdb3 show system <table>` where the underlying HTTP request to the server fails: connection refused, non-2xx response, timeout, or malformed response built by influxdb3_client.

Common situations: Server not running or wrong --host/--port, TLS mismatch between client and server, expired/missing auth token, or network issues between CLI and server.

Understand the failure class

Background: 'Something went wrong' / 'Request failed (500)' / 'HTTP error! status: 404' — what failed HTTP requests actually mean and how to find the real cause — this error's family across 28 libraries.

Related errors

• failed to send request
• client disconnected
• error fetching plugin from repository
• failed to build an http client
• failed to parse JSON response

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

Appendix: source

Thrown at influxdb3/src/commands/show/system.rs:12

use std::path::PathBuf;

use clap::Parser;
use influxdb3_client::Client;
use secrecy::ExposeSecret;
use serde::Deserialize;

use super::super::common::{Format, InfluxDb3Config};

#[derive(Debug, thiserror::Error)]
pub(crate) enum Error {
    #[error("client error: {0}")]
    InfluxDB3Client(#[from] influxdb3_client::Error),

    #[error("deserializing show tables: {0}")]
    DeserializingShowTables(#[source] serde_json::Error),

    #[error("system table '{0}' not found: {1}")]
    SystemTableNotFound(String, SystemTableNotFound),

    #[error("parquet format is not supported for this command")]
    ParquetFormatNotSupported,
}

pub(super) type Result<T> = std::result::Result<T, Error>;

#[derive(Debug, Parser)]
#[clap(visible_alias = "s", trailing_var_arg = true)]
pub struct SystemConfig {
    #[clap(subcommand)]

View on GitHub (pinned to 06200ef96b)