{"record":{"id":"eb1a130be413eca3","repo":"influxdata/influxdb","slug":"tracing-config-error-0","errorCode":null,"errorMessage":"Tracing config error: {0}","messagePattern":"Tracing config error: (.+?)","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"influxdb3/src/commands/serve.rs","lineNumber":120,"sourceCode":"pub const DEFAULT_HTTP_BIND_ADDR: &str = \"0.0.0.0:8181\";\n\n/// The default bind address for admin token recovery HTTP API.\npub const DEFAULT_ADMIN_TOKEN_RECOVERY_BIND_ADDR: &str = \"127.0.0.1:8182\";\n\npub const DEFAULT_TELEMETRY_ENDPOINT: &str = \"https://telemetry.v3.influxdata.com\";\n\nconst MIN_SNAPSHOTS_TO_LOAD_ON_START: u64 = 100;\n\nmod cli_params;\n#[cfg(test)]\nmod tests;\n\n#[derive(Debug, Error)]\npub enum Error {\n    #[error(\"Cannot parse object store config: {0}\")]\n    ObjectStoreParsing(#[from] influxdb3_clap_blocks::object_store::ParseError),\n\n    #[error(\"Tracing config error: {0}\")]\n    TracingConfig(#[from] trace_exporters::Error),\n\n    #[error(\"Error initializing tokio runtime: {0}\")]\n    TokioRuntime(#[source] std::io::Error),\n\n    #[error(\"Failed to bind address\")]\n    BindAddress(#[source] std::io::Error),\n\n    #[error(\"Server error: {0}\")]\n    Server(#[source] influxdb3_server::Error),\n\n    #[error(\"Token error: {0}\")]\n    TokenError(CatalogError),\n\n    #[error(\"Write buffer error: {0}\")]\n    WriteBuffer(#[from] influxdb3_write::write_buffer::Error),\n\n    #[error(\"invalid token: {0}\")]","sourceCodeStart":102,"sourceCodeEnd":138,"githubUrl":"https://github.com/influxdata/influxdb/blob/06200ef96ba82c5f6727e5038a83af8e722c6875/influxdb3/src/commands/serve.rs#L102-L138","documentation":"A serve-command `Error` variant (`TracingConfig`) wrapping `trace_exporters::Error` via `#[from]`. It is returned when the tracing/exporters subsystem fails to initialize from the provided tracing configuration (e.g. invalid exporter endpoint or trace span settings). Startup halts with this error before the server begins serving.","triggerScenarios":"Starting `influxdb3 serve` with tracing flags/env (`--tracing-exporter`, tracing endpoint, etc.) that cause trace_exporters initialization to fail.","commonSituations":"Pointing the tracing exporter at an invalid or unreachable URL, specifying an unsupported exporter format, malformed tracing config values from env vars.","solutions":["Verify the tracing exporter name and endpoint URL are valid and reachable.","Fix or remove the tracing-related flags/env vars to use defaults.","Check the wrapped trace_exporters::Error source for the exact cause."],"exampleFix":"// before\ninfluxdb3 serve --tracing-exporter otlp --tracing-endpoint \"localhost:bad port\"\n// after\ninfluxdb3 serve --tracing-exporter otlp --tracing-endpoint http://127.0.0.1:4317","handlingStrategy":"validation","validationCode":"url::Url::parse(&tracing_endpoint).expect(\"tracing endpoint must be a valid URL\");\nassert!(matches!(exporter.as_str(), \"\" | \"otlp\"), \"unsupported tracing exporter\");","typeGuard":null,"tryCatchPattern":"match serve(config) {\n    Err(serve::Error::TracingConfig(e)) => eprintln!(\"tracing config invalid: {}\", e),\n    Err(e) => eprintln!(\"serve failed: {}\", e),\n    Ok(_) => {}\n}","preventionTips":["Use default tracing settings unless exporter infra exists","Verify exporter endpoint reachability (curl) before serving","Keep tracing flags consistent between env vars and CLI args"],"tags":["rust","tracing","cli","configuration"],"backgroundTag":"invalid-config-value","analyzedSha":"06200ef96ba82c5f6727e5038a83af8e722c6875","analyzedAt":"2026-09-19T12:55:30.003Z","contentChangedAt":"2026-09-19T12:55:30.003Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}