Documentation

Plugin library

Browse plugins for InfluxDB 3 Enterprise. Use these plugins to extend your database functionality with custom Python code that runs on write events, schedules, or HTTP requests.

Requirements

All plugins require:

  • InfluxDB 3 Core or InfluxDB 3 Enterprise with Processing Engine enabled
  • Python environment (managed automatically by InfluxDB 3)
  • Appropriate trigger configuration

Plugin metadata

Plugins in this library include a JSON metadata schema in a docstring header that defines supported trigger types and configuration parameters. This metadata enables:

  • the InfluxDB 3 Explorer UI to display and configure the plugin
  • automated testing and validation of plugins in the repository

Using TOML Configuration Files

Many plugins in this library support using TOML configuration files to specify all plugin arguments. This is useful for complex configurations or when you want to version control your plugin settings.

Important Requirements

To use TOML configuration files, you must set the PLUGIN_DIR environment variable in the InfluxDB 3 Enterprise host environment. This is required in addition to the --plugin-dir flag when starting InfluxDB 3 Enterprise:

  • --plugin-dir tells InfluxDB 3 Enterprise where to find plugin Python files
  • PLUGIN_DIR environment variable tells the plugins where to find TOML configuration files

Set up TOML Configuration

  1. Start InfluxDB 3 Enterprise with the PLUGIN_DIR environment variable set:

    PLUGIN_DIR=~/.plugins influxdb3 serve --node-id node0 --object-store file --data-dir ~/.influxdb3 --plugin-dir ~/.plugins
  2. Copy or create a TOML configuration file in your plugin directory:

    # Example: copy a plugin's configuration template
    cp plugin_config_example.toml ~/.plugins/my_config.toml
  3. Edit the TOML file to match your requirements. The TOML file should contain all the arguments defined in the plugin’s argument schema.

  4. Create a trigger with the config_file_path argument: When creating a trigger, specify the config_file_path argument to point to your TOML configuration file.

    • Specify only the filename (not the full path)
    • The file must be located under PLUGIN_DIR
    influxdb3 create trigger \
      --database mydb \
      --plugin-filename plugin_name.py \
      --trigger-spec "every:1d" \
      --trigger-arguments config_file_path=my_config.toml \
      my_trigger_name

For more information on using TOML configuration files, see the project README.


Was this page helpful?

Thank you for your feedback!


The future of Flux

Flux is going into maintenance mode. You can continue using it as you currently are without any changes to your code.

Read more

New in InfluxDB 3.4

Key enhancements in InfluxDB 3.4 and the InfluxDB 3 Explorer 1.2.

See the Blog Post

InfluxDB 3.4 is now available for both Core and Enterprise, which introduces offline token generation for use in automated deployments and configurable license type selection that lets you bypass the interactive license prompt. InfluxDB 3 Explorer 1.2 is also available, which includes InfluxDB cache management and other new features.

For more information, check out: