|
| 1 | +# About Oracle Java Platform Extension for Visual Studio Code use of Telemetry |
| 2 | +## First Your Privacy and Anonymity |
| 3 | + |
| 4 | +During startup, close or usage of the Oracle Java Platform extension for Visual Studio Code (hereafter referred to as "JVSCE"), Oracle does not collect or track any personally identifiable information (such as names or email addresses) about you or your source code, or associate your usage of JVSCE with personally identifiable data. |
| 5 | + |
| 6 | +If you choose to enable telemetry collection in JVSCE, we will collect a limited set of information that is not personally identifiable. It is anonymous technical data commonly known as "telemetry". An element-by-element description of what is collected and how it helps us, [is listed below](#specifics-about-java-extension-usage-metrics). |
| 7 | + |
| 8 | +We do not transmit your source code nor the contents of the files you edit with Visual Studio Code. |
| 9 | + |
| 10 | +## We Collect this Data to Measure Our Own Performance, Diagnose Problems, and Improve Your Experience |
| 11 | +The purpose of the telemetry transmitted to Oracle during the JVSCE startup, close, or usage, is to find any technical problems or anomalies that occur, so we can understand and correct them; as well as, to understand the usage of Java versions and language features, so we can help improve the platform. It's similar to a car mechanic's practice of plugging into your engine's diagnostic port to identify performance issues (not to identify the car's owner!). The issues we identify could be anything from slow performance or missing platforms for JDK builds to adoption of popular Java language capabilities. Your source code, privacy and anonymity are not compromised by our collecting this telemetry. The information thus collected helps to improve the extension experience and the Java platform. |
| 12 | + |
| 13 | +## If You Would Like to Enable or Disable the Collection of this Data |
| 14 | +If you have not already made a choice for this setting, the extension might request that you enable Telemetry via a notification pop-up at the time of activation of the extension. |
| 15 | + |
| 16 | +If you wish to enable or disable the collection and transmission of the telemetry, you may do so from VS Code Settings → [jdk.telemetry.enabled](vscode://settings/jdk.telemetry.enabled). |
| 17 | + |
| 18 | +No information is sent to Oracle prior to you enabling Telemetry. |
| 19 | + |
| 20 | +# Specifics About Java Extension Usage Metrics |
| 21 | +## WHO Sends Information to Oracle? |
| 22 | +We, the authors of the JVSCE, collect and send information from the Java extension, when it is running in VS Code, only for users who consent to its collection. |
| 23 | + |
| 24 | +## HOW Is Information Sent to Oracle? |
| 25 | +Small JSON messages are transported via a secure HTTPS connection over the Internet. |
| 26 | + |
| 27 | +## WHEN Is Information Sent to Oracle? |
| 28 | +Information may be sent in one or more separate messages, depending on the events reported by JVSCE. |
| 29 | + |
| 30 | +The following types of messages may be sent if users have consented to telemetry from JVSCE: |
| 31 | +1. Start |
| 32 | + - When a JVSCE instance is launched in a window, a "Start" event is sent. |
| 33 | + - This contains information about the version, language, architecture etc. of JVSCE, VSCode and the OS. |
| 34 | +2. Close |
| 35 | + - When a JVSCE instance is closed in a window, a "Close" event is sent. |
| 36 | + - This contains timing information for the session. |
| 37 | +3. Workspace Change |
| 38 | + - When a workspace is loaded for which JVSCE is active, a "Workspace Change" event is sent. |
| 39 | + - This contains information about the Java version used, build tool used, and performance times. |
| 40 | +4. JDK Download |
| 41 | + - When a JDK is downloaded and installed using JVSCE, a "JDK Download" event is sent. |
| 42 | + - This contains information about the Java version downloaded. |
| 43 | +5. JDK Feature |
| 44 | + - A "JDK Feature" event is sent when certain Java language features, such as `records`, `switch-expressions`, `pattern-matching` etc., or, functionality introduced in [JEPs](https://openjdk.org/jeps/0), is used while editing a Java file. |
| 45 | + - This contains information about the Java version in use and the feature names or JEP numbers used. |
| 46 | + |
| 47 | +## WHAT Information is Sent to Oracle? |
| 48 | +Some or all of the following information may be sent to Oracle depending on the type of event triggered: |
| 49 | + |
| 50 | +| Event | Data Name | Value Description | |
| 51 | +|-------|----------------|--------------------------------------------------------------| |
| 52 | +| _ALL_ | VsCodeId | Anonymous machine identifier generated by VS Code. <br>It cannot be used to track the IP address or identity of the user. <br>Example: `9c5aa07a61ed54bbf61705d17bd214ef269bbed8d5a557ba9e50658b31ffae79` | |
| 53 | +| _ALL_ | VscSessionId | Anonymous session identifier generated by VS Code. <br>It cannot be used to track the IP address or identity of the user. <br>Example: `15cf5498-7981-45af-aca3-34e0fa6e906c1716187959345` | |
| 54 | +| Start | ExtensionInfo | JVSCE information like extension name, id and version. <br>Example: `Oracle.oracle-java`, `oracle-java`, `23.1.0` | |
| 55 | +| Start | VsCodeInfo | VS Code related information like version, language and host-type. <br>Example: `1.97.2`, `en`, `desktop` | |
| 56 | +| Start | PlatformInfo | Host platform/OS information like os name, architecture and version. <br>Example: `mac`, `arm64`, `14.6` | |
| 57 | +| Start | LocationInfo | Platform location information like language-region and time-zone. <br>Example: `en-US`, `Asia/Jakarta` | |
| 58 | +| Close | SessionTime | Indicates the time for which JVSCE was active in a session. | |
| 59 | +| Workspace Change | Timing Info | Indicates performance information like the time taken to initialise the language server and the time taken to parse and load the project information | |
| 60 | +| Workspace Change | ProjectInfo | Indicates project-related Java and JVSCE information like an anonymous project identifier, Java version, Java VM name, Java preview-feature enablement, build tool and whether project loading had problems. <br>The identifier cannot be used to track the IP address or identity of the user. <br>Example: `[{"id": "02a4eb67236abe93d137136be01f1372b8372e2230896932ef25267df32b4f52", "buildTool": "MavenProject", "isOpenedWithProblems": false, "javaVersion": "21.0.6+8-LTS-jvmci-23.1-b59;Oracle GraalVM 21.0.6+8.1;Java HotSpot(TM) 64-Bit Server VM", "isPreviewEnabled": false}]` | |
| 61 | +| JDK Download | Vendor | Indicates the vendor of the JDK downloaded using JVSCE. <br>Example: `OracleJDK` | |
| 62 | +| JDK Download | Version | Indicates the version of the JDK downloaded. <br>Example: `21` | |
| 63 | +| JDK Download | Platform | Indicates the OS name and architecture of the downloaded JDK. <br>Example: `windows`, `x64` | |
| 64 | +| JDK Download | Timing Info | Indicates the time taken to download the JDK. | |
| 65 | +| JDK Feature | JEPs | Indicates the Java language features used as denoted by their [JEP numbers](https://openjdk.org/jeps/0). <br>Example: `[477, 395, 394]` | |
| 66 | +| JDK Feature | Features | Indicates the Java language features used as denoted by their common names. <br>Example: `["RECORDS", "SWITCH_RULE", "PATTERN_MATCHING_IN_INSTANCEOF"]` | |
| 67 | +| JDK Feature | Version | Indicates the Java version and enablement of Java preview-features. <br>Example: `23.0.2+7-58`, `"isPreviewEnabled": true` | |
| 68 | + |
| 69 | +See information on [Oracle Privacy Policies](https://www.oracle.com/legal/privacy/). |
0 commit comments