Performance Monitoring 使用入门 (Flutter)

本快速入门介绍了如何设置 Firebase Performance Monitoring，帮助您深入了解 Flutter 应用的性能特征。

准备工作

如果您尚未在 Flutter 项目中配置并初始化 Firebase，请先配置并进行初始化。

第 1 步：将 Performance Monitoring 添加到您的应用

1. 从 Flutter 项目的根目录运行以下命令，以安装 Performance Monitoring Flutter 插件：

   flutter pub add firebase_performance
   

2. 从 Flutter 项目的根目录运行以下命令：

   flutterfire configure
   

   运行此命令可确保您的 Flutter 应用的 Firebase 配置保持最新状态，并且对于 Android，会自动向您的应用添加任何所需的 Performance Monitoring Gradle 插件。

3. 完成后，重新构建您的 Flutter 项目：

   flutter run
   

添加 Performance Monitoring SDK 后，Firebase 会自动开始收集与应用生命周期相关的数据（例如应用启动时间）以及 HTTP/HTTPS 网络请求的数据。

在 Flutter 上，不能针对个别 Flutter 屏幕自动进行屏幕渲染性能监控。单个视图控制器以原生方式封装整个 Flutter 应用，因此底层原生 Firebase SDK 无法感知屏幕转换。

注意：将 Performance Monitoring 添加到应用时，Remote Config SDK 会作为依赖项一并添加。如果您已在使用 Remote Config，则不会发现任何不同。但如果您是初次使用 Remote Config，请浏览 Remote Config 文档，以详细了解您能够在应用中使用的各种功能。

第 2 步：生成性能事件以显示初始数据

当您成功将 SDK 添加到应用后，Firebase 即会开始处理事件。如果您仍在本地进行开发，请与您的应用交互以生成事件，从而触发初始数据收集和处理。

注意：Performance Monitoring SDK 会在本地批量处理事件，然后定期（每 30 秒）或者在应用返回前台时将事件发送到 Firebase。因此，在发生应用交互后，Firebase 会稍隔一段时间才会收到来自您应用的事件信息。

1. 继续使用模拟器或测试设备开发应用。

2. 生成事件的方法包括：将应用在后台和前台之间切换数次、与应用进行交互（浏览多个屏幕），以及触发网络请求。

3. 前往 Firebase 控制台的“性能”信息中心。您应该会在几分钟内看到初始数据。

   如果您没有看到初始数据，请查看问题排查提示。

第 3 步：（可选）查看性能事件的日志消息

1. 检查您的日志消息中是否有错误消息。

   Performance Monitoring 使用以下标记标记其日志消息，以便您过滤日志消息：

   • iOS+：Firebase/Performance
   • Android：FirebasePerformance

2. 检查以下类型的日志，这些日志表明 Performance Monitoring 正在记录性能事件：

   • Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
   • Logging network request trace: URL

3. 点击网址即可在 Firebase 控制台中查看您的数据。系统可能需要一些时间才能在信息中心内更新数据。

第 4 步：（可选）为特定代码添加自定义监控

如需监控与应用中特定代码相关联的性能数据，您可以对自定义代码跟踪记录进行插桩处理。

借助自定义代码跟踪记录，您可以衡量应用完成一项或一组任务（例如加载一组图像或查询数据库）所需的时间。自定义代码跟踪记录的默认指标是其时长，但您也可以添加自定义指标，例如缓存命中数和内存警告。

在代码中，您可以使用 Performance Monitoring SDK 提供的 API 指定自定义代码跟踪记录的开始和结束（以及添加任何所需的自定义指标）。

请访问为特定代码添加监控功能，详细了解这些功能以及如何将其添加到您的应用中。

第 5 步：部署应用并查看结果

使用模拟器和一个或多个测试设备验证 Performance Monitoring 之后，您可以将应用的更新版本部署给用户。

您可以在 Firebase 控制台的“性能”信息中心监控性能数据。

后续步骤

• 详细了解 Performance Monitoring 自动收集的数据：

  • 与应用生命周期相关的数据，例如应用启动时间
  • 应用发出的 HTTP/HTTPS 网络请求的数据

• 在 Firebase 控制台中查看、跟踪和过滤性能数据。

• 通过对自定义代码跟踪记录进行插桩处理，针对应用的特定任务或工作流添加监控功能。

• 使用属性来过滤性能数据。