> ## Documentation Index
> Fetch the complete documentation index at: https://powersync-storage-v4.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage Reporting

> How self-hosted PowerSync collects anonymous usage metrics, and how to opt out.

## Overview

PowerSync uses OpenTelemetry to gather certain usage metrics. These metrics are shared with PowerSync 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:

<Note>Type definitions for each metric dimension are available in the [powersync-service](https://github.com/powersync-ja/powersync-service/blob/main/packages/types/src/metrics.ts) repository.</Note>

| 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   |
| attributed\_source\_records\_bytes    | gauge   |
| operation\_storage\_size\_bytes       | gauge   |
| attributed\_bucket\_data\_bytes       | gauge   |
| parameter\_storage\_size\_bytes       | gauge   |
| attributed\_parameter\_indexes\_bytes | gauge   |
| object\_storage\_size\_bytes          | gauge   |
| attributed\_object\_storage\_bytes    | gauge   |
| concurrent\_connections               | gauge   |

The four `attributed_*` gauges include `sync_config_id` and `sync_config_state` attributes. The Prometheus endpoint also includes `version_label` when the Sync Config has one. The Service removes `version_label` before sharing telemetry with PowerSync.

<Tip>To scrape your self-hosted PowerSync Service metrics, please see the [Monitoring](/maintenance-ops/self-hosting/monitoring) docs page for more details.</Tip>

### Opting Out

To opt out of sharing metrics with PowerSync, set the `disable_telemetry_sharing` key in your [`service.yaml`](/configuration/powersync-service/self-hosted-instances) to `true`:

```yaml service.yaml theme={null}
telemetry:
    # Opt out of reporting anonymized usage metrics to PowerSync telemetry service
    disable_telemetry_sharing: true
```