From: Peeter Piegaze <61758048+peeter-piegaze-sonarsource@users.noreply.github.com> Date: Thu, 1 Sep 2022 13:34:49 +0000 (+0200) Subject: SONAR-17193 Documentation about Telemetry (#6577) X-Git-Tag: 9.7.0.61563~255 X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=d50804785fa2726b883275cf8a2f54c2818ffbcd;p=sonarqube.git SONAR-17193 Documentation about Telemetry (#6577) --- diff --git a/server/sonar-docs/src/pages/instance-administration/telemetry.md b/server/sonar-docs/src/pages/instance-administration/telemetry.md new file mode 100644 index 00000000000..f2bda565e99 --- /dev/null +++ b/server/sonar-docs/src/pages/instance-administration/telemetry.md @@ -0,0 +1,119 @@ +--- +title: Telemetry +url: /instance-administration/telemetry/ +--- + +SonarQube periodically sends telemetry data to SonarSource. +This data helps us understand how SonarQube is used, which helps us improve our products. + + +## No personally identifiable information is sent + +The telemetry doesn't collect personal data, such as usernames or email addresses. +It doesn't send source code or data such as project name, repository, or author. +No IP addresses are sent. +The data is sent securely, held under restricted access, and not published outside of SonarSource. + +Protecting your privacy is important to us. +If you suspect the telemetry is collecting sensitive data or the data is being insecurely or inappropriately handled, please send an email to `security@sonarsource.com` so that we can investigate. + + +## Turning it off + +You can disable telemetry at any time by setting the `sonar.telemetry.enabled` property to `false` in `$SONARQUBE-HOME/conf/sonar.properties`. +By default, it is set to `true`. + + +## What information is sent? + +Once a day (every 24 hours), SonarQube sends a `JSON` payload to `https://telemetry.sonarsource.com/sonarqube`. + +The data that is sent includes: + +* Information about the SonarQube instances itself (version, edition, database type, etc.) +* The list of projects on the instance including, for each: + * A traceable unique project identifier (but one which doesn’t reveal any identifying information about the project) + * Information about the project like language, last analysis time, number of lines of code, etc. +* The list of users on that instance including, for each: + * A traceable unique user identifier (but one which doesn’t reveal any identifiying information about the user) + * Information about the user's usage of the system like time of last login and current status. + +Here is an example of a telemetry payload: + +``` +{ + "id": "ID", + "version": "9.6", + "edition": "enterprise", + "licenseType": "TEST-LICENCE", + "database": { + "name": "oracle", + "version": "2.0.0" + }, + "plugins": [ + { + "name": "plugin-name", + "version": "9.6" + } + ], + "externalAuthProviders": [ + "sonarqube" + ], + "installationDate": 1661933380862, + "installationVersion": "9.6", + "docker": false, + "users": [ + { + "userUuid": "UUID-1", + "status": "active", + "lastActivity": "2022-01-01T08:00:00+00" + } + ], + "projects": [ + { + "projectUuid": "UUID-1", + "lastAnalysis": "2022-01-01T08:00:00+00" + "language": "java", + "loc": 40 + }, + { + "projectUuid": "UUID-2", + "lastAnalysis": "2022-01-01T08:00:00+00" + "language": "ts", + "loc": 24 + }, + { + "projectUuid": "UUID-3", + "lastAnalysis": "2022-08-31T10:09:56+0200", + "language": "css", + "loc": 7 + } + ], + "projects-general-stats": [ + { + "projectUuid": "UUID-1", + "branchCount": 2, + "pullRequestCount": 0, + "scm": "undetected", + "ci": "cirrus_ci", + "alm": "gitlab_cloud" + }, + { + "projectUuid":"UUID-2", + "branchCount": 1, + "pullRequestCount": 0, + "scm": "undetected", + "ci": "undetected", + "alm": "github_cloud" + }, + { + "projectUuid": "UUID-3", + "branchCount": 1, + "pullRequestCount": 0, + "scm": "undetected", + "ci": "undetected", + "alm": "undetected" + } + ] +} +``` diff --git a/server/sonar-docs/src/pages/setup/sonar-properties.md b/server/sonar-docs/src/pages/setup/sonar-properties.md index addbb7b691e..f39a8a48963 100644 --- a/server/sonar-docs/src/pages/setup/sonar-properties.md +++ b/server/sonar-docs/src/pages/setup/sonar-properties.md @@ -406,7 +406,7 @@ Delay in seconds between processing of notification queue. Default is 60 seconds Paths to persistent data files (embedded database and search index) and temporary files. Can be absolute or relative to installation directory. Defaults are respectively /data and /temp **`SONAR_TELEMETRY_ENABLE=true`** -Telemetry - Share anonymous SonarQube statistics. By sharing anonymous SonarQube statistics, you help us understand how SonarQube is used so we can improve the product to work even better for you. We don't collect source code or IP addresses. And we don't share the data with anyone else. To see an example of the data shared: login as a global administrator, call the WS api/system/info and check the Statistics field. +Telemetry - Share anonymous SonarQube statistics. By sharing anonymous SonarQube statistics, you help us understand how SonarQube is used so we can improve the product to work even better for you. We don't collect source code or IP addresses. And we don't share the data with anyone else. For more information, see [Telemetry](/instance-administration/telemetry/). ## Development – only for developers [[warning]] diff --git a/server/sonar-docs/static/SonarQubeNavigationTree.json b/server/sonar-docs/static/SonarQubeNavigationTree.json index 76288e1397b..0e47a473fbb 100644 --- a/server/sonar-docs/static/SonarQubeNavigationTree.json +++ b/server/sonar-docs/static/SonarQubeNavigationTree.json @@ -195,7 +195,8 @@ "/instance-administration/project-move/", "/instance-administration/compute-engine-performance/", "/instance-administration/db-copy/", - "/instance-administration/backup-restore/" + "/instance-administration/backup-restore/", + "/instance-administration/telemetry/" ] }, { diff --git a/server/sonar-docs/static/StaticNavigationTree.json b/server/sonar-docs/static/StaticNavigationTree.json index f6d985aa621..d6ca2db2577 100644 --- a/server/sonar-docs/static/StaticNavigationTree.json +++ b/server/sonar-docs/static/StaticNavigationTree.json @@ -230,7 +230,8 @@ "/instance-administration/project-move/", "/instance-administration/compute-engine-performance/", "/instance-administration/db-copy/", - "/instance-administration/backup-restore/" + "/instance-administration/backup-restore/", + "/instance-administration/telemetry/" ] }, { diff --git a/sonar-application/src/main/assembly/conf/sonar.properties b/sonar-application/src/main/assembly/conf/sonar.properties index fc3c22b91ef..24560229682 100644 --- a/sonar-application/src/main/assembly/conf/sonar.properties +++ b/sonar-application/src/main/assembly/conf/sonar.properties @@ -412,5 +412,4 @@ # Telemetry - Share anonymous SonarQube statistics # By sharing anonymous SonarQube statistics, you help us understand how SonarQube is used so we can improve the product to work even better for you. # We don't collect source code or IP addresses. And we don't share the data with anyone else. -# To see an example of the data shared: login as a global administrator, call the WS api/system/info and check the Statistics field. #sonar.telemetry.enable=true