Telemetry

PowerSync integrates with OpenTelemetry

Overview

PowerSync uses OpenTelemetry to gather metrics about usage and health.

This telemetry is shared with the PowerSync team unless you opt-out. This allows us to gauge adoption and usage patterns across deployments so that so that we can better allocate R&D capacity and ultimately better serve our customers (including you!). The metrics are linked to a random UUID and are therefore completely anonymous.

What is Collected

Below are the data points collected every few minutes and associated with a random UUID representing your instance:

dimension	type
data_replicated_bytes	counter
data_synced_bytes	counter
rows_replicated_total	counter
transactions_replicated_total	counter
chunks_replicated_total	counter
operations_synced_total	counter
replication_storage_size_bytes	gauge
operation_storage_size_bytes	gauge
parameter_storage_size_bytes	gauge
concurrent_connections	gauge

See https://github.com/powersync-ja/powersync-service/blob/main/packages/service-core/src/metrics/Metrics.ts for additional details.

To scrape your self-hosted PowerSync Service metrics, please see the Metrics docs page for more details.

Opting Out

To disable the sending of telemetry to PowerSync, set the disable_telemetry_sharing key in your configuration file (config.yaml or config.json) to true:

powersync.yaml

telemetry:
    # Opt out of reporting anonymized usage metrics to PowerSync telemetry service
    disable_telemetry_sharing: true