# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
# file, You can obtain one at http://mozilla.org/MPL/2.0/.

# If this file is changed, update the generated docs:
# https://firefox-source-docs.mozilla.org/mach/telemetry.html#updating-generated-metrics-docs

# Adding a new metric? We have docs for that!
# https://mozilla.github.io/glean/book/user/metrics/adding-new-metrics.html

---
$schema: moz://mozilla.org/schemas/glean/metrics/1-0-0

mozbuild:
  compiler:
    type: string
    description: The compiler type in use (CC_TYPE), such as "clang" or "gcc".
    lifetime: application
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1291053
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1291053#c34
    notification_emails:
      - build-telemetry@mozilla.com
      - mhentges@mozilla.com
    expires: never
    send_in_pings:
      - usage
  artifact:
    type: boolean
    description: True if `--enable-artifact-builds`.
    lifetime: application
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1291053
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1291053#c34
    notification_emails:
      - build-telemetry@mozilla.com
      - mhentges@mozilla.com
    expires: never
    send_in_pings:
      - usage
  debug:
    type: boolean
    description: True if `--enable-debug`.
    lifetime: application
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1291053
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1291053#c34
    notification_emails:
      - build-telemetry@mozilla.com
      - mhentges@mozilla.com
    expires: never
    send_in_pings:
      - usage
  opt:
    type: boolean
    description: True if `--enable-optimize`.
    lifetime: application
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1291053
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1291053#c34
    notification_emails:
      - build-telemetry@mozilla.com
      - mhentges@mozilla.com
    expires: never
    send_in_pings:
      - usage
  ccache:
    type: boolean
    description: True if `--with-ccache`.
    lifetime: application
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1291053
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1291053#c34
    notification_emails:
      - build-telemetry@mozilla.com
      - mhentges@mozilla.com
    expires: never
    send_in_pings:
      - usage
  sccache:
    type: boolean
    description: True if ccache in use is sccache.
    lifetime: application
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1291053
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1291053#c34
    notification_emails:
      - build-telemetry@mozilla.com
      - mhentges@mozilla.com
    expires: never
    send_in_pings:
      - usage
  icecream:
    type: boolean
    description: True if icecream in use.
    lifetime: application
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1291053
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1291053#c34
    notification_emails:
      - build-telemetry@mozilla.com
      - mhentges@mozilla.com
    expires: never
    send_in_pings:
      - usage
  clobber:
    type: boolean
    description: True if the build was a clobber/full build.
    lifetime: application
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1526072
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1526072#c15
    notification_emails:
      - build-telemetry@mozilla.com
      - mhentges@mozilla.com
    expires: never
    send_in_pings:
      - usage
  project:
    type: string
    description: The project being built.
    lifetime: application
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1654084
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1654084#c2
    notification_emails:
      - build-telemetry@mozilla.com
      - mhentges@mozilla.com
    expires: never
    send_in_pings:
      - usage