Telemetry

Integrate self-hosted PowerSync with OpenTelemetry for distributed observability.

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 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:

Type definitions for each metric dimension are available in the powersync-service repository.

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

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 service.yaml to true:

service.yaml

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