Query.Farm Extensions Now Include Optional Telemetry
At Query.Farm, we strive to make our DuckDB extensions more reliable, performant, and useful for our community. To help us achieve that, weโre introducing optional telemetry in our extensions starting with DuckDB 1.4.
Why Telemetry?
Telemetry allows us to understand how our extensions are used in real-world scenarios. This helps us:
- Identify the most popular extensions and features
- Prioritize improvements that matter most to users
The telemetry data is minimal and non-intrusive. It does not include query data or personal information โ only metadata about the extension and the DuckDB environment. When an extension is loaded it sends a single HTTPS request to Query.Farmโs telemetry service (https://duckdb-in.query-farm.services/
) in a background thread.
What Data is Collected
Telemetry collects the following information:
extension_name
- The name of the extension being used.extension_version
- The version of the extensionuser_agent
- A user agent identifying the telemetry sender.duckdb_platform
- The platform where the extension is runningduckdb_library_version
- The library version of DuckDB the return value ofDuckDB::LibraryVersion()
.duckdb_release_codename
- The release code name of DuckDB the return value ofDuckDB::ReleaseCodename()
.dudkdb_source_id
- The source identifier of DuckDB the return value ofDuckDB::SourceID()
.
In simple terms, this includes:
- Extension name and version
- DuckDB platform, library version, release codename, and source ID
This helps us ensure compatibility and understand usage patterns across environments.
Opting Out
Telemetry is completely optional. If you prefer not to participate, set the environment variable:
On Linux/macOS:
export QUERY_FARM_TELEMETRY_OPT_OUT=1
On Windows (PowerShell):
setx QUERY_FARM_TELEMETRY_OPT_OUT 1
Setting this disables telemetry entirely โ no data will be sent.
Your Privacy Matters
We respect your privacy and are committed to transparency. The telemetry is used solely to improve our extensions, and you have full control to opt out at any time.