Query.Farm Extensions Now Include Optional Telemetry

Author

Query.Farm

Published

September 15, 2025

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 extension
  • user_agent - A user agent identifying the telemetry sender.
  • duckdb_platform - The platform where the extension is running
  • duckdb_library_version - The library version of DuckDB the return value of DuckDB::LibraryVersion().
  • duckdb_release_codename - The release code name of DuckDB the return value of DuckDB::ReleaseCodename().
  • dudkdb_source_id - The source identifier of DuckDB the return value of DuckDB::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.