Skip to content

Latest commit

 

History

History
119 lines (90 loc) · 4.36 KB

analytics.md

File metadata and controls

119 lines (90 loc) · 4.36 KB

Usage Metrics Gathering

This document list exactly what is gathered and how.

Any change to analytics should most probably include a change to this document.

Pageview

Each command creates a pageview with the path /command/${commandName}/${subcommandName}. IE. ng generate component my-component --dryRun would create a page view with the path /command/generate/@schematics_angular/component.

We use page views to keep track of sessions more effectively, and to tag events to a page.

Project names and target names will be removed. The command ng run some-project:lint:some-configuration will create a page view with the path /command/run.

Dimensions

Google Analytics Custom Dimensions are used to track system values and flag values. These dimensions are aggregated automatically on the backend.

One dimension per flag, and although technically there can be an overlap between 2 commands, for simplicity it should remain unique across all CLI commands. The dimension is the value of the x-user-analytics field in the schema.json files.

To create a new dimension (tracking a new flag):

  1. Create the dimension on analytics.google.com first. Dimensions are not tracked if they aren't defined on GA.
  2. Use the ID of the dimension as the x-user-analytics value in the schema.json file.
  3. Add a new row to the table below in the same PR as the one adding the dimension to the code.
  4. New dimension PRs need to be approved by the tooling and DevRel leads. This is not negotiable.

DO NOT ADD x-user-analytics FOR VALUES THAT ARE USER IDENTIFIABLE (PII), FOR EXAMPLE A PROJECT NAME TO BUILD OR A MODULE NAME.

Note: There's a limit of 20 custom dimensions.

List Of All Dimensions

Id Flag Type
1 CPU Count number
2 CPU Speed number
3 RAM (In GB) number
4 Node Version number
5 Flag: --style string
6 --collection string
7 Flag: --strict boolean
8 Angular CLI Major Version string
9 Flag: --inline-style boolean
10 Flag: --inline-template boolean
11 Flag: --view-encapsulation string
12 Flag: --skip-tests boolean
13 Flag: --aot boolean
14 Flag: --minimal boolean
15 Flag: --standalone boolean
16 Flag: --optimization boolean
17 Flag: --routing boolean
18 Flag: --skip-import boolean
19 Flag: --export boolean
20 Build Errors (comma separated) string

Metrics

List of All Metrics

Id Flag Type
1 NgComponentCount number
2 UNUSED_2 none
3 UNUSED_3 none
4 UNUSED_4 none
5 Build Time number
6 NgOnInit Count number
7 Initial Chunk Size number
8 Total Chunk Count number
9 Total Chunk Size number
10 Lazy Chunk Count number
11 Lazy Chunk Size number
12 Asset Count number
13 Asset Size number
14 Polyfill Size number
15 Css Size number

Operating System and Node Version

A User Agent string is built to "fool" Google Analytics into reading the Operating System and version fields from it. The base dimensions are used for those.

Node version is our App ID, but a dimension is also used to get the numeric MAJOR.MINOR of node.

Debugging

Using DEBUG=ng:analytics will report additional information regarding initialization and decisions made during the usage analytics process, e.g. if the user has analytics disabled.

Using DEBUG=ng:analytics:command will show the decisions made by the command runner.

Using DEBUG=ng:analytics:log will show what we actually send to GA.

See the debug NPM library for more information.

Disabling Usage Analytics

There are 2 ways of disabling usage analytics:

  1. using ng analytics off --global (or changing the global configuration file yourself). This is the same as answering "No" to the prompt.
  2. There is an NG_CLI_ANALYTICS environment variable that overrides the global configuration. That flag is a string that represents the User ID. If the string "false" is used it will disable analytics for this run.