cmclark00/retro-imager
1
0
Fork 0
mirror of https://github.com/cmclark00/retro-imager.git synced 2025-05-18 16:05:21 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

Merge pull request #131 from raspberrypi/document-telemetry

Browse source 
Document telemetry and how to opt-out
This commit is contained in:
maxnet 2020-12-07 12:58:17 +01:00 • committed by GitHub
commit a8a12fc993
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 27 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

27
README.md
View file

@ -116,3 +116,30 @@ On Windows start the application with the command-line option --debug to let it
If the application is started with "--repo [your own URL]" it will use a custom image repository. If the application is started with "--repo [your own URL]" it will use a custom image repository.
So can simply create another 'start menu shortcut' to the application with that parameter to use the application with your own images. So can simply create another 'start menu shortcut' to the application with that parameter to use the application with your own images.
### Telemetry
In order to understand which images and operating systems are most popular and re-organise the application accordingly, when using the default image repository, the URL, operating system name and category (if present) of a selected image are sent to https://rpi-imager-stats.raspberrypi.org by [`downloadstatstelemetry.cpp`](https://github.com/raspberrypi/rpi-imager/blob/qml/downloadstatstelemetry.cpp).
This web service is hosted by [Heroku](https://www.heroku.com) and only stores an incrementing counter using a [Redis Sorted Set](https://redis.io/topics/data-types#sorted-sets) for each URL, operating system name and category per day in the `eu-west-1` region and does not associate any personal data with those counts. This allows us to query the number of downloads over time and nothing else.
The download counts are retained for 90 days and the last 1,500 requests to the service are logged for one week before expiring as this is the [minimum log retention period for Heroku](https://devcenter.heroku.com/articles/logging#log-history-limits).
On Windows, you can opt out of telemetry by disabling it in the Registry:
```
reg add "HKCU\Software\Raspberry Pi\Imager\General" /v telemetry /t REG_DWORD /d 0
```
On Linux, add the following to `~/.config/Raspberry Pi/Imager.conf`:
```ini
[%General]
telemetry=0
```
On macOS, disable it by editing the property list for the application:
```
defaults write org.raspberrypi.Imager.plist General.telemetry -bool NO
```