Bắt đầu sử dụng tính năng Giám sát hiệu suất cho Flutter

Hướng dẫn bắt đầu nhanh này mô tả cách thiết lập tính năng Giám sát hiệu suất Firebase để giúp bạn hiểu rõ hơn về các đặc điểm liên quan đến hiệu suất của ứng dụng Flutter.

Trước khi bắt đầu

Nếu bạn chưa thực hiện, hãy định cấu hình và khởi chạy Firebase trong dự án Flutter của bạn.

Bước 1: Thêm tính năng Giám sát hiệu suất vào ứng dụng

  1. Trong thư mục gốc của dự án Flutter, hãy chạy lệnh sau để cài đặt trình bổ trợ Giám sát hiệu suất cho Flutter:

    flutter pub add firebase_performance

  2. Trong thư mục gốc của dự án Flutter, hãy chạy lệnh sau:

    flutterfire configure

    Việc chạy lệnh này đảm bảo rằng cấu hình Firebase của ứng dụng Flutter luôn được cập nhật và đối với Android, hãy thêm trình bổ trợ Performance Monitoring Gradle bắt buộc vào ứng dụng của bạn.

  3. Sau khi hoàn tất, hãy tạo lại dự án Flutter:

    flutter run

Sau khi bạn thêm SDK Giám sát hiệu suất, Firebase sẽ tự động bắt đầu thu thập dữ liệu liên quan đến vòng đời của ứng dụng (như thời gian bắt đầu ứng dụng) và dữ liệu cho các yêu cầu mạng HTTP/S.

Trên Flutter, bạn không thể tự động theo dõi hiệu suất kết xuất màn hình cho từng màn hình Flutter. Một bộ điều khiển khung hiển thị duy nhất sẽ đóng gói toàn bộ ứng dụng Flutter của bạn theo cách gốc, vì vậy, Firebase SDK gốc cơ bản sẽ không nhận biết được các hiệu ứng chuyển đổi màn hình.

Bước 2: Tạo sự kiện hiệu suất để hiển thị dữ liệu ban đầu

Firebase bắt đầu xử lý các sự kiện khi bạn thêm thành công SDK vào ứng dụng của mình. Nếu bạn vẫn đang phát triển ứng dụng trên thiết bị, hãy tương tác với ứng dụng để tạo sự kiện cho quá trình thu thập dữ liệu và xử lý ban đầu.

  1. Tiếp tục phát triển ứng dụng bằng trình mô phỏng hoặc thiết bị thử nghiệm.

  2. Tạo sự kiện bằng cách chuyển đổi ứng dụng giữa chế độ nền và chế độ nền trước nhiều lần, tương tác với ứng dụng bằng cách di chuyển giữa các màn hình và/hoặc kích hoạt yêu cầu mạng.

  3. Chuyển đến trang tổng quan Hiệu suất của bảng điều khiển Firebase. Bạn sẽ thấy dữ liệu ban đầu xuất hiện trong vòng vài phút.

    Nếu bạn không thấy dữ liệu ban đầu, hãy xem mẹo khắc phục sự cố.

Bước 3: (Không bắt buộc) Xem thông điệp nhật ký cho các sự kiện hiệu suất

  1. Kiểm tra thông điệp nhật ký để xem có thông báo lỗi nào không.

    Tính năng Giám sát hiệu suất gắn thẻ các thông điệp nhật ký bằng các thẻ sau để bạn có thể lọc thông điệp nhật ký:

    • iOS+: Firebase/Performance
    • Android: FirebasePerformance

  2. Kiểm tra các loại nhật ký sau đây để biết Performance Monitoring có đang ghi nhật ký các sự kiện hiệu suất hay không:

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

  3. Nhấp vào URL để xem dữ liệu của bạn trong bảng điều khiển của Firebase. Có thể mất vài phút để dữ liệu cập nhật trong trang tổng quan.

Bước 4: (Không bắt buộc) Thêm tính năng giám sát tuỳ chỉnh cho mã cụ thể

Để theo dõi dữ liệu hiệu suất liên quan đến mã cụ thể trong ứng dụng, bạn có thể đo lường dấu vết mã tuỳ chỉnh.

Với dấu vết mã tuỳ chỉnh, bạn có thể đo lường thời gian cần thiết để ứng dụng hoàn tất một tác vụ hoặc một nhóm tác vụ cụ thể, chẳng hạn như tải một nhóm hình ảnh hoặc truy vấn cơ sở dữ liệu. Chỉ số mặc định cho dấu vết mã tuỳ chỉnh là thời lượng, nhưng bạn cũng có thể thêm các chỉ số tuỳ chỉnh, chẳng hạn như kết quả tìm kiếm trong bộ nhớ đệm và cảnh báo bộ nhớ.

Trong mã của mình, bạn xác định điểm bắt đầu và điểm kết thúc của dấu vết mã tuỳ chỉnh (và thêm mọi chỉ số tuỳ chỉnh mong muốn) bằng cách sử dụng API do SDK Giám sát hiệu suất cung cấp.

Hãy truy cập vào phần Thêm tính năng giám sát cho mã cụ thể để tìm hiểu thêm về các tính năng này và cách thêm chúng vào ứng dụng của bạn.

Bước 5: Triển khai ứng dụng rồi xem kết quả

Sau khi xác thực tính năng Giám sát hiệu suất bằng trình mô phỏng và một hoặc nhiều thiết bị kiểm thử, bạn có thể triển khai phiên bản cập nhật của ứng dụng cho người dùng.

Bạn có thể theo dõi dữ liệu hiệu suất trong trang tổng quan Hiệu suất của bảng điều khiển Firebase.

Các bước tiếp theo