docs/performance/build_metrics/build_metrics.md

   1 # Build Metrics
   2
   3 **Build Metrics** is a catch-all term for performance measures that are
   4 generated by the Firefox build system and tracked by Perfherder.
   5
   6 ## num_constructors
   7
   8 Number of static constructors found by the compiler in the Firefox C++
   9 codebase. Lower is better. Static constructors are undesirable because
  10 their initialization imposes an unavoidable time penalty every time
  11 Firefox is started.
  12
  13 ## installer size
  14
  15 Size in bytes of the Firefox installer. Lower is better here, especially
  16 on space-restricted platforms like Android.
  17
  18 ## build times
  19
  20 Amount of time it takes to build Firefox in automation on a specific
  21 platform / configuration. Lower is better.
  22
  23 ## compiler warnings
  24
  25 Number of compiler warnings detected during a build. Lower is better.
  26
  27 Due to the way the build system works, compiler warnings are not
  28 consistently detected. So the value may fluctuate from build to build
  29 even if the number of compiler warnings didn\'t actually change. Since
  30 Perfherder alerts are calculated based on the mean value of a range, a
  31 regression may be reported as a fractional value.