synthefy plugin

[ajanbekzat]

Synthefy Forecasting Plugin for InfluxDB 3

This PR adds a new HTTP trigger plugin that integrates Synthefy Forecasting API with InfluxDB 3 to enable on-demand time series forecasting.

Features

• On-demand forecasting via HTTP requests
• Multiple model support: Works with Synthefy models (sfm-tabular, Migas-latest, Chronos2, Moirai2, TimesFM, etc.)
• Multivariate forecasting: Supports metadata fields as covariates
• Tag filtering: Filter time series by tags (location, device, etc.)
• Automatic data writing: Forecasts written back to InfluxDB using Line Protocol

How It Works

1. Queries historical time series data from InfluxDB based on measurement, field, tags, and time range
2. Transforms data to Synthefy API v2 request format
3. Calls Synthefy Forecasting API to generate forecasts
4. Writes forecast results (with quantiles) back to InfluxDB

Requirements

• Python 3.7+
• pandas and httpx/requests packages
• Synthefy API key (create one here)

Usage Example

curl -X POST http://localhost:8181/api/v3/engine/forecast \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "measurement": "temperature",
    "field": "value",
    "tags": "location=NYC",
    "time_range": "30d",
    "forecast_horizon": "7d",
    "model": "sfm-tabular",
    "api_key": "your-api-key",
    "metadata_fields": "humidity,pressure"
  }'