{"record":{"id":"dcf8d5ecfbacf5ff","repo":"influxdata/influxdb","slug":"current-node-mode-does-not-use-the-processing-engine","errorCode":null,"errorMessage":"Current node mode does not use the processing engine","messagePattern":"Current node mode does not use the processing engine","errorType":"http","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"influxdb3_server/src/http.rs","lineNumber":388,"sourceCode":"    #[error(\"Authentication error: {0}\")]\n    Authentication(#[from] AuthenticatorError),\n\n    #[error(\"The following Database does not exist: {0}\")]\n    MissingDb(String),\n\n    #[error(\"The following Database Table does not exist: {0}\")]\n    MissingTable(String),\n\n    #[error(\"Cannot parse the given human time: {0}\")]\n    ParsingHumanTime(#[source] humantime::DurationError),\n\n    #[error(\"Cannot parse the timestamp: {0}\")]\n    ParsingTimestamp(#[from] chrono::ParseError),\n\n    #[error(\"Timestamp is out of range\")]\n    TimestampOutOfRange,\n\n    #[error(\"Current node mode does not use the processing engine\")]\n    NoProcessingEngine,\n\n    #[error(\"invalid request: {0}\")]\n    InvalidRequest(String),\n\n    #[error(transparent)]\n    LegacyWriteParse(#[from] WriteParseError),\n}\n\n#[derive(Debug, Error)]\npub(crate) enum AuthenticationError {\n    #[error(\"the request was not authenticated\")]\n    Unauthenticated,\n    #[error(\n        \"Authorization header was malformed, the request was not in the form of 'Authorization: <auth-scheme> <token>', supported auth-schemes are Bearer, Token and Basic\"\n    )]\n    MalformedRequest,\n    #[error(\"requestor is forbidden from requested resource\")]","sourceCodeStart":370,"sourceCodeEnd":406,"githubUrl":"https://github.com/influxdata/influxdb/blob/06200ef96ba82c5f6727e5038a83af8e722c6875/influxdb3_server/src/http.rs#L370-L406","documentation":"Error variant `NoProcessingEngine` in influxdb3_server/src/http.rs (ErrorWrite enum). It means the HTTP request required the Processing Engine (e.g. a trigger or plugin-bearing write path), but the node was started in a mode where the Processing Engine is not enabled, so the server cannot fulfill it.","triggerScenarios":"Sending an HTTP request whose handling requires the Processing Engine (e.g. writes or triggers meant to invoke plugins/WAL processing) to an InfluxDB 3 node launched without Processing Engine support in its node mode.","commonSituations":"Running a plain Core/Enterprise node (no processing-engine feature) and pointing an application or plugin pipeline at it; deploying a cluster where only some node types run the Processing Engine but clients route engine-dependent requests to all nodes.","solutions":["Start the server in a node mode that enables the Processing Engine (e.g. pass the appropriate --node-mode / processing-engine flags at startup)","Route the request to a node that runs the Processing Engine instead of this one","Remove or disable the plugin/trigger-dependent calls from the client if the engine is intentionally disabled"],"exampleFix":"// before: server started without processing engine\ninfluxdb3 serve --node-id=host1\n// after: enable processing engine mode\ninfluxdb3 serve --node-id=host1 --node-mode=all","handlingStrategy":"fallback","validationCode":"// Check node capabilities before sending engine-dependent requests\nconst supportsPE = await fetch(`${host}/health`).then(r => r.json()).then(h => !!h.processing_engine_enabled);","typeGuard":null,"tryCatchPattern":"try {\n  await writeWithTriggers(payload);\n} catch (e) {\n  if (String(e.message).includes('does not use the processing engine')) {\n    routeToProcessingEngineNode(payload);\n  } else { throw e; }\n}","preventionTips":["Document which node modes in your cluster run the Processing Engine and route accordingly","Probe /health at startup and assert the node supports the Processing Engine before enabling plugin features"],"tags":["http","processing-engine","node-mode","configuration"],"backgroundTag":"feature-not-enabled","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"}