Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
feat(@angular-devkit/build-angular): add analytics for build
Add a few metrics that we want to capture in the build.
- Loading branch information
Showing
2 changed files
with
285 additions
and
5 deletions.
There are no files selected for viewing
256 changes: 256 additions & 0 deletions
256
packages/angular_devkit/build_angular/plugins/webpack/analytics.ts
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,256 @@ | ||
/** | ||
* @license | ||
* Copyright Google Inc. All Rights Reserved. | ||
* | ||
* Use of this source code is governed by an MIT-style license that can be | ||
* found in the LICENSE file at https://angular.io/license | ||
*/ | ||
import { analytics } from '@angular-devkit/core'; | ||
import { | ||
Compiler, | ||
Module, | ||
Stats, | ||
compilation, | ||
} from 'webpack'; | ||
import { Source } from 'webpack-sources'; | ||
import Compilation = compilation.Compilation; | ||
|
||
const NormalModule = require('webpack/lib/NormalModule'); | ||
|
||
interface NormalModule extends Module { | ||
_source?: Source | null; | ||
resource?: string; | ||
} | ||
|
||
const webpackAllErrorMessageRe = /^([^(]+)\(\d+,\d\): (.*)$/gm; | ||
const webpackTsErrorMessageRe = /^[^(]+\(\d+,\d\): error (TS\d+):/; | ||
|
||
/** | ||
* Faster than using a RegExp, so we use this to count occurences in source code. | ||
* @param source The source to look into. | ||
* @param match The match string to look for. | ||
* @param wordBreak Whether to check for word break before and after a match was found. | ||
* @return The number of matches found. | ||
* @private | ||
*/ | ||
export function countOccurrences(source: string, match: string, wordBreak = false): number { | ||
if (match.length == 0) { | ||
return source.length + 1; | ||
} | ||
|
||
let count = 0; | ||
// We condition here so branch prediction happens out of the loop, not in it. | ||
if (wordBreak) { | ||
const re = /\w/; | ||
for (let pos = source.lastIndexOf(match); pos >= 0; pos = source.lastIndexOf(match, pos - 1)) { | ||
if (!(re.test(source[pos - 1]) || re.test(source[pos + match.length]))) { | ||
count++; // 1 match, AH! AH! AH! 2 matches, AH! AH! AH! | ||
} | ||
} | ||
} else { | ||
for (let pos = source.lastIndexOf(match); pos >= 0; pos = source.lastIndexOf(match, pos - 1)) { | ||
count++; // 1 match, AH! AH! AH! 2 matches, AH! AH! AH! | ||
} | ||
} | ||
|
||
return count; | ||
} | ||
|
||
|
||
/** | ||
* Holder of statistics related to the build. | ||
*/ | ||
class AnalyticsBuildStats { | ||
public errors: string[] = []; | ||
public numberOfNgOnInit = 0; | ||
public initialChunkSize = 0; | ||
public totalChunkCount = 0; | ||
public totalChunkSize = 0; | ||
public lazyChunkCount = 0; | ||
public lazyChunkSize = 0; | ||
public assetCount = 0; | ||
public assetSize = 0; | ||
public polyfillSize = 0; | ||
public cssSize = 0; | ||
} | ||
|
||
|
||
/** | ||
* Analytics plugin that reports the analytics we want from the CLI. | ||
*/ | ||
export class NgBuildAnalyticsPlugin { | ||
protected _built = false; | ||
protected _stats = new AnalyticsBuildStats(); | ||
|
||
constructor( | ||
protected _projectRoot: string, | ||
protected _analytics: analytics.Analytics, | ||
protected _category: string, | ||
) {} | ||
|
||
protected _reset() { | ||
this._stats = new AnalyticsBuildStats(); | ||
} | ||
|
||
protected _getMetrics(stats: Stats) { | ||
const startTime = +(stats.startTime || 0); | ||
const endTime = +(stats.endTime || 0); | ||
const metrics: (string | number)[] = []; | ||
metrics[analytics.NgCliAnalyticsMetrics.BuildTime] = (endTime - startTime); | ||
metrics[analytics.NgCliAnalyticsMetrics.NgOnInitCount] = this._stats.numberOfNgOnInit; | ||
metrics[analytics.NgCliAnalyticsMetrics.InitialChunkSize] = this._stats.initialChunkSize; | ||
metrics[analytics.NgCliAnalyticsMetrics.TotalChunkCount] = this._stats.totalChunkCount; | ||
metrics[analytics.NgCliAnalyticsMetrics.TotalChunkSize] = this._stats.totalChunkSize; | ||
metrics[analytics.NgCliAnalyticsMetrics.LazyChunkCount] = this._stats.lazyChunkCount; | ||
metrics[analytics.NgCliAnalyticsMetrics.LazyChunkSize] = this._stats.lazyChunkSize; | ||
metrics[analytics.NgCliAnalyticsMetrics.AssetCount] = this._stats.assetCount; | ||
metrics[analytics.NgCliAnalyticsMetrics.AssetSize] = this._stats.assetSize; | ||
metrics[analytics.NgCliAnalyticsMetrics.PolyfillSize] = this._stats.polyfillSize; | ||
metrics[analytics.NgCliAnalyticsMetrics.CssSize] = this._stats.cssSize; | ||
|
||
return metrics; | ||
} | ||
protected _getDimensions(stats: Stats) { | ||
const dimensions: (string | number)[] = []; | ||
// Adding commas before and after so the regex are easier to define. | ||
dimensions[analytics.NgCliAnalyticsDimensions.BuildErrors] = `,${this._stats.errors.join()},`; | ||
|
||
return dimensions; | ||
} | ||
|
||
protected _reportBuildMetrics(stats: Stats) { | ||
const dimensions = this._getDimensions(stats); | ||
const metrics = this._getMetrics(stats); | ||
this._analytics.event(this._category, 'build', { dimensions, metrics }); | ||
} | ||
|
||
protected _reportRebuildMetrics(stats: Stats) { | ||
const dimensions = this._getDimensions(stats); | ||
const metrics = this._getMetrics(stats); | ||
this._analytics.event(this._category, 'rebuild', { dimensions, metrics }); | ||
} | ||
|
||
protected _checkTsNormalModule(module: NormalModule) { | ||
if (module._source) { | ||
// We're dealing with ES5 _or_ ES2015 JavaScript at this point (we don't know for sure). | ||
// Just count the ngOnInit occurences. Comments/Strings/calls occurences should be sparse | ||
// so we just consider them within the margin of error. We do break on word break though. | ||
this._stats.numberOfNgOnInit += countOccurrences(module._source.source(), 'ngOnInit', true); | ||
} | ||
} | ||
|
||
protected _collectErrors(stats: Stats) { | ||
if (stats.hasErrors()) { | ||
for (const errObject of stats.compilation.errors) { | ||
if (errObject instanceof Error) { | ||
const allErrors = errObject.message.match(webpackAllErrorMessageRe); | ||
for (const err of [...allErrors || []].slice(1)) { | ||
const message = (err.match(webpackTsErrorMessageRe) || [])[1]; | ||
if (message) { | ||
// At this point this should be a TS1234. | ||
this._stats.errors.push(message); | ||
} | ||
} | ||
// console.log(allErrors); | ||
} | ||
console.log(errObject.message); | ||
console.log('------'); | ||
} | ||
} | ||
} | ||
|
||
// We can safely disable no any here since we know the format of the JSON output from webpack. | ||
// tslint:disable-next-line:no-any | ||
protected _collectBundleStats(json: any) { | ||
json.chunks | ||
.filter((chunk: { rendered?: boolean }) => chunk.rendered) | ||
.forEach((chunk: { files: string[], initial?: boolean, entry?: boolean }) => { | ||
const asset = json.assets.find((x: { name: string }) => x.name == chunk.files[0]); | ||
const size = asset ? asset.size : 0; | ||
|
||
if (chunk.entry || chunk.initial) { | ||
this._stats.initialChunkSize += size; | ||
} else { | ||
this._stats.lazyChunkCount++; | ||
this._stats.lazyChunkSize += size; | ||
} | ||
this._stats.totalChunkCount++; | ||
this._stats.totalChunkSize += size; | ||
}); | ||
|
||
json.assets | ||
// Filter out chunks. We only count assets that are not JS. | ||
.filter((a: { name: string }) => { | ||
return json.chunks.every((chunk: { files: string[] }) => chunk.files[0] != a.name); | ||
}) | ||
.forEach((a: { size?: number }) => { | ||
this._stats.assetSize += (a.size || 0); | ||
this._stats.assetCount++; | ||
}); | ||
|
||
for (const asset of json.assets) { | ||
if (asset.name == 'polyfill') { | ||
this._stats.polyfillSize += asset.size || 0; | ||
} | ||
} | ||
for (const chunk of json.chunks) { | ||
if (chunk.files[0].endsWith('.css')) { | ||
this._stats.cssSize += chunk.size || 0; | ||
} | ||
} | ||
} | ||
|
||
/************************************************************************************************ | ||
* The next section is all the different Webpack hooks for this plugin. | ||
*/ | ||
|
||
/** | ||
* Reports a succeed module. | ||
* @private | ||
*/ | ||
protected _succeedModule(mod: Module) { | ||
// Only report NormalModule instances. | ||
if (mod.constructor !== NormalModule) { | ||
return; | ||
} | ||
const module = mod as {} as NormalModule; | ||
|
||
// Only reports modules that are part of the user's project. We also don't do node_modules. | ||
// There is a chance that someone name a file path `hello_node_modules` or something and we | ||
// will ignore that file for the purpose of gathering, but we're willing to take the risk. | ||
if (!module.resource | ||
|| !module.resource.startsWith(this._projectRoot) | ||
|| module.resource.indexOf('node_modules') >= 0) { | ||
return; | ||
} | ||
|
||
// Check that it's a source file from the project. | ||
if (module.constructor === NormalModule && module.resource.endsWith('.ts')) { | ||
this._checkTsNormalModule(module as {} as NormalModule); | ||
} | ||
} | ||
|
||
protected _compilation(compiler: Compiler, compilation: Compilation) { | ||
this._reset(); | ||
compilation.hooks.succeedModule.tap('NgBuildAnalyticsPlugin', this._succeedModule.bind(this)); | ||
} | ||
|
||
protected _done(stats: Stats) { | ||
this._collectErrors(stats); | ||
this._collectBundleStats(stats.toJson()); | ||
if (this._built) { | ||
this._reportRebuildMetrics(stats); | ||
} else { | ||
this._reportBuildMetrics(stats); | ||
this._built = true; | ||
} | ||
} | ||
|
||
apply(compiler: Compiler): void { | ||
compiler.hooks.compilation.tap( | ||
'NgBuildAnalyticsPlugin', | ||
this._compilation.bind(this, compiler), | ||
); | ||
compiler.hooks.done.tap('NgBuildAnalyticsPlugin', this._done.bind(this)); | ||
} | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters