PowerShell / PowerShell/PSScriptAnalyzer

Proposal: Basic Telemetry for PSSA

Open
#1,414 3 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Issue - Discussion
Dominant language
C#
Stars
2.2k
Forks
414
Avg merge
13h 1m
Merged PRs (30d)
2

Description

PSScript Analyzer Proposed Telemetry

Goal

To better understand how PSSA is being used both within PSES and in isolation in order to make informed investments in PSSA 2.0.

Questions

  • What versions of PowerShell are being used with PSSA? What versions of PowerShell should we continue to support?
  • What tasks are PSSA currently being used to accomplish?
    • To what extent is PSSA being used inside vs. outside of PSES? Which of these experiences is most important to optimize?
    • To what extent are custom rules vs. built in rules being used?
    • What is the proportional use of PSSA as a formatter vs "analyzer"?
  • To what extent are the compatibility rules being used? Which platforms are being targeted the most?
  • What rules are being turned off? What rules should we strip out?
  • Which rules are causing the largest performance delays?

Proposed Metrics

  • Version of PowerShell
  • Inside vs Outside of PSES
  • CI usage/environment type
  • Time for each rule to complete
  • Count of:
    • Known formatter type rules
    • Known analyzer type rules (tally for each one)
    • Custom rules (not on our known list)
    • Known compatibility profiles (tally for each one)
    • Use of a configuration

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

The issue names no files, tests, or entry points. Start by turning the listed questions and proposed metrics into a telemetry design for PSSA, covering use inside and outside PSES. Done is an agreed scope and implementation plan for collecting the proposed metrics.

Written by the indexing model from the issue text.

Assessment

Tech stack
powershell
Domain
analytics, observability
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.