influxdata/influxdb · error · PluginError

error executing plugin

Error message

error executing plugin: {0}

What it means

PluginError::PluginExecutionError, wrapping influxdb3_py_api::ExecutePluginError when a plugin actually runs and fails inside the Python execution layer — an error in the plugin's own logic or its interaction with the write API, not in loading it.

Solutions

  1. Inspect the wrapped ExecutePluginError for the plugin-side failure detail
  2. Fix the plugin code or the data it is processing
  3. Check whether the error is data-dependent and skips the offending records
Defensive patterns

Strategy: try-catch

When it happens

Trigger: Thrown at influxdb3_processing_engine/src/plugins.rs:53 when the library encounters an invalid state.

Common situations: See trigger scenarios.


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

Appendix: source

Thrown at influxdb3_processing_engine/src/plugins.rs:53

    #[error("invalid database {0}")]
    InvalidDatabase(String),

    #[error("couldn't find db")]
    MissingDb,

    #[error(transparent)]
    PyError(#[from] pyo3::PyErr),

    #[error(transparent)]
    WriteBufferError(#[from] write_buffer::Error),

    #[error(transparent)]
    AnyhowError(#[from] anyhow::Error),

    #[error("reading plugin file: {0}")]
    ReadPluginError(#[from] std::io::Error),

    #[error("error executing plugin: {0}")]
    PluginExecutionError(#[from] influxdb3_py_api::error::ExecutePluginError),

    #[error("invalid cron syntax: {0}")]
    InvalidCronSyntax(#[from] cron::error::Error),

    #[error("cron schedule never triggers: {0}")]
    CronScheduleNeverTriggers(String),

    #[error("non-schedule plugin with schedule trigger: {0}")]
    NonSchedulePluginWithScheduleTrigger(String),

    #[error("error fetching plugin from repository: {0} {1}")]
    FetchingFromRepository(reqwest::StatusCode, String),

    #[error(
        "plugin installation is disabled; plugins must already exist in the configured plugin directory"
    )]
    PluginInstallationDisabled,

View on GitHub (pinned to 06200ef96b)