Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 4 additions & 16 deletions api/get_telemetry_report.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,28 +11,16 @@ api:

# get_telemetry_report()

If background [telemetry][telemetry] is enabled, returns the string sent to our servers.
If telemetry is not enabled, outputs INFO message affirming telemetry is disabled
and returns a NULL report.

### Optional arguments

|Name|Type|Description|
|---|---|
| `always_display_report` | BOOLEAN | Set to true to always view the report, even if telemetry is disabled |
Returns the background [telemetry][telemetry] string sent to Timescale
servers. If telemetry is disabled, it sends the string that would be sent
if telemetry was enabled.

### Sample usage

If telemetry is enabled, view the telemetry report.
View the telemetry report:

```sql
SELECT get_telemetry_report();
```

If telemetry is disabled, view the telemetry report locally.

```sql
SELECT get_telemetry_report(always_display_report := true);
```

[telemetry]: /timescaledb/:currentVersion:/how-to-guides/configuration/telemetry