| RFC | Author | Status | SupercededBy | Version | Area | Comments Due | Feedback |
|---|---|---|---|---|---|---|---|
RFC0016 |
Steve Lee, Jim Truher |
Final |
n/a |
0.3 |
Host |
Done |
Add basic census telemetry to PowerShell.
Downloads numbers do not tell us if we are successful in growing usage of PowerShell. The platform (Windows, Linux, Mac) usage data helps to prioritize new feature work and investments.
On every startup of the PowerShell Console host, telemetry will be sent via ApplicationInsights to collect the following information:
[System.Runtime.InteropServices.RuntimeInformation]::OSDescription(equivalent touname -aon Unix)- GitCommitId (from $psversiontable)
Performance will be measured to ensure collecting and sending telemetry does not have an impact to PowerShell startup time. Target is <5ms impact.
Telemetry is only collected if the file DELETE_ME_TO_DISABLE_CONSOLEHOST_TELEMETRY exists in $PSHome. Eventually, we want to adopt RFC0015 Startup Configuration as the way to enable/disable telemetry.
ApplicationInsights provides a mechanism for sending a CustomEvent which is essentially three elements:
- The name of the event
- A dictionary of properties
- A dictionary of metrics
For PowerShell Core purposes we will send only the name of the event and a dictionary of properties consisting of the list shown in the the specification. Initially, we will not provide any metrics, although we can easily do so at a later time.
None
Jason Shirk: Accept
Joey Aiello: Accept
Bruce Payette: Accept
Steve Lee: Accept
Hemant Mahawar: Accept
Commmittee agrees that this RFC satisfies the initial telemetry for census data. Future telemetry changes will be new RFCs.
N/A