使用特性过滤数据

借助 Performance Monitoring，您可以使用特性来细分性能数据，并重点关注您的应用在不同实际场景中的性能。

点击跟踪记录表（位于“性能”信息中心的底部）中的某个跟踪记录名称后，即可点击各个相关屏幕以浏览跟踪记录并深入了解感兴趣的指标。在大多数页面上，您可以使用过滤按钮（屏幕左上角）按特性过滤数据，例如：

按特性过滤 Firebase Performance Monitoring 数据的图片

按”页面网址”过滤可查看网站中特定页面的数据
按“有效连接类型”过滤可了解 3G 连接对应用的影响
按“国家/地区”过滤可确保您的数据库位置不会影响特定区域

默认特性

Performance Monitoring 会根据跟踪记录类型自动收集各种默认特性。

除上述默认特性外，您还可以针对自定义代码跟踪记录创建自定义特性，以按适用于您的应用的类别来细分数据。例如，在游戏中，您可以按游戏关卡细分数据。

为 Web 应用收集的默认特性

默认情况下，Web 应用的所有跟踪记录均会收集以下特性：

浏览器
国家/地区
有效连接类型
页面网址
Service Worker 状态
公开范围状态

收集用户数据

收集用户数据：Performance Monitoring 本身不会收集任何个人身份信息 (PII)，例如姓名、电子邮件地址或电话号码。开发者可以通过针对自定义代码跟踪记录创建自定义特性来使用 Performance Monitoring 收集其他数据。通过 Performance Monitoring 收集的此类数据不应包含可让 Google 识别出个人身份的信息。

下面是不含个人身份信息的日志消息示例：

trace.putAttribute("experiment", "A");

下面是包含个人身份信息的示例（请勿在您的应用中使用此类自定义特性）：

trace.putAttribute("email", user.getEmailAddress());

暴露任何个人身份信息的数据一律会被删除，恕不另行通知。

创建自定义特性

您可以针对任何插桩的自定义代码跟踪记录创建自定义特性。

使用 Performance Monitoring Trace API 将自定义特性添加到自定义代码跟踪记录中。

如需使用自定义特性，请向您的应用添加定义该特性的代码，并将其与特定自定义代码跟踪记录相关联。您可以在跟踪记录开始和结束之间的任何时间设置自定义特性。

请注意以下几点：

自定义特性的名称必须符合以下要求：没有前导空格或尾随空格、没有前导下划线 (_) 字符，长度上限为 32 个字符。
每个自定义代码跟踪记录最多可记录 5 个自定义特性。
您不应使用包含的信息可让 Google 识别出个人身份的自定义特性。
详细了解此准则
收集用户数据：Performance Monitoring 本身不会收集任何个人身份信息 (PII)，例如姓名、电子邮件地址或电话号码。开发者可以通过针对自定义代码跟踪记录创建自定义特性来使用 Performance Monitoring 收集其他数据。通过 Performance Monitoring 收集的此类数据不应包含可让 Google 识别出个人身份的信息。

下面是不含个人身份信息的日志消息示例：
```
trace.putAttribute("experiment", "A");
```
下面是包含个人身份信息的示例（请勿在您的应用中使用此类自定义特性）：
```
trace.putAttribute("email", user.getEmailAddress());
```
暴露任何个人身份信息的数据一律会被删除，恕不另行通知。

Web 版本 9

import { trace } from "firebase/performance";

const t = trace(perf, "test_trace");
t.putAttribute("experiment", "A");

// Update scenario
t.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = t.getAttribute("experiment");

// Delete scenario
t.removeAttribute("experiment");

// Read attributes
const traceAttributes = t.getAttributes();perf_add_custom_attributes.js

Web 版本 8

const trace = perf.trace("test_trace");
trace.putAttribute("experiment", "A");

// Update scenario
trace.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = trace.getAttribute("experiment");

// Delete scenario
trace.removeAttribute("experiment");

// Read attributes
const traceAttributes = trace.getAttributes();index.js