blob: 27502895680deddbb2b772813f61ec6630e75d46 [file] [log] [blame]
<!--
Copyright 2015 The Chromium Authors. All rights reserved.
Use of this source code is governed by a BSD-style license that can be
found in the LICENSE file.
-->
<!--
This file is used to generate a comprehensive list of Chrome rappor metrics
along with a detailed description for each histogram. See the design doc at
http://www.chromium.org/developers/design-documents/rappor
for a description of rappor metrics.
-->
<rappor-configuration>
<!--
Noise levels that rappor metrics can be collected with. This list should be
kept in sync with NoiseLevel definitions in
components/rappor/rappor_parameters.h.
-->
<noise-levels>
<noise-level name="NO_NOISE">
<summary>
Adds no noise at all. Only use this for non-sensitive fields, and only for
metrics from UMA enabled users.
</summary>
<noise-values fake-prob="0.0" fake-one-prob="0.0" one-coin-prob="1.0"
zero-coin-prob="0.0"/>
</noise-level>
<noise-level name="NORMAL_NOISE">
<summary>
The most common amount of noise, suitable for most fields.
</summary>
<noise-values fake-prob="0.5" fake-one-prob="0.5" one-coin-prob="0.75"
zero-coin-prob="0.25"/>
</noise-level>
<noise-level name="SPARSE_NOISE">
<summary>
Reduced noise, suitable for metrics which receive limited reports (less than
500,000 per day) or expect a highly skewed/sparse distribution over a wide
set of domains. Approval from the Chrome Privacy and Rappor teams is
required to implement a metric using this noise level.
</summary>
<noise-values fake-prob="0.25" fake-one-prob="0.5" one-coin-prob="0.75"
zero-coin-prob="0.25"/>
</noise-level>
</noise-levels>
<!--
Parameters that rappor metrics can be collected with. This list should be
kept in sync with parameter type definitions in
components/rappor/rappor_parameters.h.
-->
<rappor-parameter-types>
<rappor-parameters name="ETLD_PLUS_ONE">
<summary>
Deprecated parameters for collecting the domain and registry of a URL from
UMA enabled users. Should use UMA_RAPPOR_TYPE instead.
</summary>
<parameters num-cohorts="128" bytes="16" hash-functions="2"
reporting-level="FINE" noise-level="NORMAL_NOISE"/>
</rappor-parameters>
<rappor-parameters name="LOW_FREQUENCY_ETLD_PLUS_ONE">
<summary>
Parameters for collecting the domain and registry of a URL from UMA enabled
users, using SPARSE_NOISE. Intended for sparse/skewed metrics, or low
frequency metrics (less than 500,000 reports per day). Explicit approval
from the Chrome Privacy and Rappor teams is required to use this type. New
metrics should also consider LOW_FREQUENCY_UMA_RAPPOR_TYPE instead.
</summary>
<parameters num-cohorts="128" bytes="16" hash-functions="2"
reporting-level="FINE" noise-level="SPARSE_NOISE"/>
</rappor-parameters>
<rappor-parameters name="LOW_FREQUENCY_UMA_RAPPOR_TYPE">
<summary>
Parameters suitable for metrics from UMA enabled users, using SPARSE_NOISE.
Intended for sparse/skewed metrics, or low frequency metrics (less than
500,000 reports per day). Explicit approval from the Chrome Privacy and
Rappor teams is required to use this type.
</summary>
<parameters num-cohorts="128" bytes="4" hash-functions="2"
reporting-level="FINE" noise-level="SPARSE_NOISE"/>
</rappor-parameters>
<rappor-parameters name="UMA_RAPPOR_TYPE">
<summary>
Parameters suitable for metrics from UMA enabled users.
</summary>
<parameters num-cohorts="128" bytes="4" hash-functions="2"
reporting-level="FINE" noise-level="NORMAL_NOISE"/>
</rappor-parameters>
</rappor-parameter-types>
<!-- Rappor metric definitions -->
<rappor-metrics>
<rappor-metric name="CustomTabs.ServiceClient.PackageName"
type="UMA_RAPPOR_TYPE">
<owner>yusufo@chromium.org</owner>
<summary>
The package name for a client that has connected through the custom tabs
service.
</summary>
</rappor-metric>
<rappor-metric name="CustomTabs.ServiceClient.PackageNameThirdParty"
type="UMA_RAPPOR_TYPE">
<owner>yusufo@chromium.org</owner>
<summary>
The package name for a client that has connected through the custom tabs
service excluding Google Search App.
</summary>
</rappor-metric>
</rappor-metrics>
</rappor-configuration>