wasp/web/docs/telemetry.md

50 lines
1.9 KiB
Markdown

---
title: Telemetry
---
## Overview
The term **telemetry** refers to the collection of certain usage data to help improve the quality of a piece of software (in this case, Wasp).
Our telemetry implementation is anonymized and very limited in its scope, focused on answering following questions:
- How many people and how often: tried to install Wasp, use Wasp, or have built a Wasp app?
- How many projects are created with Wasp?
## When and what is sent?
- Information is sent via HTTPS request when `wasp` CLI command is invoked.
Information is sent no more than twice in a period of 12 hours (sending is paused for 12 hours after last invocation, separately for `wasp build` command and for all other commands). Exact information as it is sent:
```json
{
// Randomly generated, non-identifiable UUID representing a user.
"distinct_id": "bf3fa7a8-1c11-4f82-9542-ec1a2d28786b",
// Non-identifiable hash representing a project.
"project_hash": "6d7e561d62b955d1",
// True if command was `wasp build`, false otherwise.
"is_build": true,
"wasp_version": "0.1.9.1",
"os": "linux"
}
```
- Information is also sent once via HTTPS request when wasp is installed via `install.sh` script. Exact information as it is sent:
```json
{
// Randomly generated id.
"distinct_id": "274701613078193779564259",
"os": "linux"
}
```
## Opting out
You can opt-out of telemetry by setting the `WASP_TELEMETRY_DISABLE` environment variable to any value, e.g.:
```
export WASP_TELEMETRY_DISABLE=1
```
## Future plans
We don't have this implemented yet, but the next step will be to make telemetry go in two directions -> instead of just sending usage data to us, it will also at the same time check for any messages from our side (e.g. notification about new version of Wasp, or a security notice). [Link to corresponding github issue](https://github.com/wasp-lang/wasp/issues/163).