Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

Tùy chỉnh tổng hợp dữ liệu yêu cầu mạng

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Giám sát hiệu suất Firebase tự động tổng hợp dữ liệu cho các yêu cầu mạng tương tự để giúp bạn hiểu các xu hướng về hiệu suất yêu cầu mạng của mình.

Tuy nhiên, đôi khi, bạn cần tùy chỉnh cách Firebase tổng hợp dữ liệu yêu cầu mạng cụ thể để hỗ trợ tốt hơn cho các trường hợp sử dụng của ứng dụng. Chúng tôi cung cấp hai cách để bạn tùy chỉnh tổng hợp dữ liệu cho các yêu cầu mạng: tổng hợp dữ liệu theo các mẫu URL tùy chỉnhtùy chỉnh cách tính tỷ lệ thành công .

Tổng hợp dữ liệu trong các mẫu URL tùy chỉnh

Đối với mỗi yêu cầu, Firebase sẽ kiểm tra xem URL của yêu cầu mạng có khớp với một mẫu URL hay không. Nếu URL yêu cầu khớp với một mẫu URL, Firebase sẽ tự động tổng hợp dữ liệu của yêu cầu theo mẫu URL.

Bạn có thể tạo các mẫu URL tùy chỉnh để theo dõi các mẫu URL cụ thể mà Firebase không nắm bắt được bằng tính năng đối sánh mẫu URL tự động bắt nguồn của nó. Ví dụ: bạn có thể sử dụng mẫu URL tùy chỉnh để gỡ rối một URL cụ thể hoặc để theo dõi một tập hợp URL cụ thể theo thời gian.

Firebase hiển thị tất cả các mẫu URL (bao gồm cả các mẫu URL tùy chỉnh) và dữ liệu tổng hợp của chúng trong tab phụ Yêu cầu mạng của bảng theo dõi, ở cuối bảng điều khiển Hiệu suất của bảng điều khiển Firebase.

Đối sánh mẫu URL tùy chỉnh hoạt động như thế nào?

Firebase cố gắng đối sánh các URL yêu cầu với bất kỳ mẫu URL tùy chỉnh nào đã định cấu hình trước khi quay trở lại đối sánh mẫu URL tự động. Đối với bất kỳ yêu cầu phù hợp nào với mẫu URL tùy chỉnh, Firebase sẽ tổng hợp dữ liệu của các yêu cầu trong mẫu URL tùy chỉnh.

Nếu URL của một yêu cầu khớp với nhiều hơn một mẫu URL tùy chỉnh, thì Firebase sẽ ánh xạ yêu cầu đến chỉ mẫu URL tùy chỉnh cụ thể nhất, theo thứ tự cụ thể sau: văn bản thuần túy> * > ** từ trái sang phải trong đường dẫn . Ví dụ: một yêu cầu tới example.com/books/dog khớp với hai mẫu URL tùy chỉnh:

  • example.com/books/*
  • example.com/*/dog

Tuy nhiên, mẫu example.com/books/* là mẫu URL phù hợp cụ thể nhất vì các books ở phân đoạn ngoài cùng bên trái trong example.com/books/* được ưu tiên hơn phân đoạn ngoài cùng bên trái * trong example.com/*/dog .

Khi bạn tạo một mẫu URL tùy chỉnh mới, hãy lưu ý những điều sau:

  • Kết quả trùng khớp và dữ liệu tổng hợp từ các yêu cầu trước đó không bị ảnh hưởng bởi việc tạo mẫu URL tùy chỉnh mới. Firebase không tổng hợp lại dữ liệu yêu cầu trước đây.

  • Chỉ các yêu cầu trong tương lai mới bị ảnh hưởng bởi việc tạo mẫu URL tùy chỉnh mới. Bạn có thể cần đợi tối đa 12 giờ để Giám sát hiệu suất thu thập và tổng hợp dữ liệu theo mẫu URL tùy chỉnh mới.

Tạo mẫu URL tùy chỉnh

Bạn có thể tạo mẫu URL tùy chỉnh từ tab phụ Yêu cầu mạng trong bảng theo dõi, ở cuối bảng điều khiển Hiệu suất của bảng điều khiển Firebase.

Thành viên dự án phải là Chủ sở hữu hoặc Người biên tập để tạo mẫu URL tùy chỉnh mới; tuy nhiên, tất cả các thành viên dự án có thể xem các mẫu URL tùy chỉnh và dữ liệu tổng hợp của chúng.

Bạn có thể tạo tổng cộng 400 mẫu URL tùy chỉnh cho mỗi ứng dụng và tối đa 100 mẫu URL tùy chỉnh cho mỗi miền cho ứng dụng đó.

Để tạo mẫu URL tùy chỉnh, hãy bắt đầu bằng tên máy chủ, sau đó là các đoạn đường dẫn. Tên máy chủ phải bao gồm một miền hợp lệ và có thể bao gồm cả miền phụ theo tùy chọn. Sử dụng cú pháp phân đoạn đường dẫn sau để tạo một mẫu có thể khớp với URL.

  • văn bản thuần túy - khớp với một chuỗi chính xác
  • * - khớp với phân đoạn tên miền phụ đầu tiên hoặc bất kỳ chuỗi nào trong một phân đoạn đường dẫn duy nhất
  • ** - khớp với hậu tố đường dẫn tùy ý

Bảng sau đây mô tả một số đối sánh mẫu URL tùy chỉnh tiềm năng.

Khớp... Tạo mẫu URL tùy chỉnh như ... Đối sánh ví dụ với mẫu URL này
Một URL chính xác example.com/foo/baz example.com/foo/baz
Bất kỳ đoạn đường dẫn đơn nào ( * ) example.com/*/baz example.com/foo/baz
example.com/bar/baz
example.com/*/*/baz example.com/foo/bar/baz
example.com/bah/qux/baz
example.com/foo/* example.com/foo/baz
example.com/foo/bar

Lưu ý: Mẫu này sẽ không khớp với example.com/foo .

Hậu tố đường dẫn tùy ý ( ** ) example.com/foo/** example.com/foo
example.com/foo/baz
example.com/foo/baz/more/segments
subdomain.example.com/foo.bar/** subdomain.example.com/foo.bar
subdomain.example.com/foo.bar/baz
subdomain.example.com/foo.bar/baz/more/segments
Phân đoạn tên miền phụ đầu tiên ( * ) *.example.com/foo bar.example.com/foo
baz.example.com/foo

Xem các mẫu URL tùy chỉnh và dữ liệu của chúng

Firebase hiển thị tất cả các mẫu URL (bao gồm cả các mẫu URL tùy chỉnh) và dữ liệu tổng hợp của chúng trong tab phụ Yêu cầu mạng của bảng theo dõi, ở cuối bảng điều khiển Hiệu suất của bảng điều khiển Firebase.

Để chỉ xem các mẫu URL tùy chỉnh, hãy chọn Mẫu tùy chỉnh từ menu thả xuống trong tab phụ Yêu cầu mạng của bảng dấu vết. Lưu ý rằng nếu mẫu URL tùy chỉnh không có bất kỳ dữ liệu tổng hợp nào thì mẫu URL đó chỉ xuất hiện trong danh sách này.

Khi khoảng thời gian lưu giữ dữ liệu kết thúc đối với dữ liệu được tổng hợp theo mẫu URL, Firebase sẽ xóa dữ liệu đó khỏi mẫu URL. Nếu tất cả dữ liệu được tổng hợp theo mẫu URL tùy chỉnh hết hạn, thì Firebase sẽ không xóa mẫu URL tùy chỉnh khỏi bảng điều khiển Firebase. Thay vào đó, Firebase tiếp tục liệt kê các mẫu URL tùy chỉnh "trống" trong danh sách Mẫu tùy chỉnh của tab phụ Yêu cầu mạng của bảng dấu vết.

Xóa mẫu URL tùy chỉnh

Bạn có thể xóa các mẫu URL tùy chỉnh khỏi dự án của mình. Lưu ý rằng bạn không thể xóa mẫu URL tự động.

  1. Từ bảng điều khiển Hiệu suất , cuộn xuống bảng dấu vết, sau đó chọn tab phụ Yêu cầu mạng .

  2. Chọn Mẫu tùy chỉnh từ menu thả xuống trong tab phụ Yêu cầu mạng .

  3. Di chuột qua hàng của mẫu URL tùy chỉnh mà bạn muốn xóa.

  4. Nhấp vào ở ngoài cùng bên phải của hàng, chọn Xóa mẫu tùy chỉnh , sau đó xác nhận việc xóa trong hộp thoại.

Khi bạn xóa mẫu URL tùy chỉnh, hãy lưu ý những điều sau:

  • Mọi yêu cầu trong tương lai đều được ánh xạ tới mẫu URL tùy chỉnh phù hợp cụ thể nhất tiếp theo . Nếu Firebase không tìm thấy mẫu URL tùy chỉnh nào phù hợp, thì Firebase sẽ quay lại chế độ đối sánh mẫu URL tự động .

  • Kết quả trùng khớp và dữ liệu tổng hợp từ các yêu cầu trước đó không bị ảnh hưởng bởi việc xóa mẫu URL tùy chỉnh.

    Bạn vẫn có thể truy cập vào mẫu URL tùy chỉnh đã xóa và dữ liệu tổng hợp của nó trong tab phụ Yêu cầu mạng (với Tất cả yêu cầu mạng được chọn) cho đến khi kết thúc khoảng thời gian lưu giữ dữ liệu hiện hành. Khi tất cả dữ liệu tổng hợp trong mẫu URL tùy chỉnh đã xóa hết hạn, Firebase sẽ xóa mẫu URL tùy chỉnh.

  • Tab phụ Yêu cầu mạng (đã chọn Mẫu tùy chỉnh ) không liệt kê bất kỳ mẫu URL tùy chỉnh nào đã bị xóa.

Bước tiếp theo

  • Thiết lập cảnh báo cho các yêu cầu mạng đang làm giảm hiệu suất của ứng dụng của bạn. Ví dụ: bạn có thể định cấu hình cảnh báo qua email cho nhóm của mình nếu thời gian phản hồi cho một mẫu URL cụ thể vượt quá ngưỡng mà bạn đã đặt.

Tùy chỉnh cách tính tỷ lệ thành công

Một trong những số liệu mà Firebase giám sát cho từng yêu cầu mạng là tỷ lệ thành công của yêu cầu. Tỷ lệ thành công là phần trăm phản hồi thành công so với tổng số phản hồi. Số liệu này giúp bạn đo lường các lỗi mạng và máy chủ.

Cụ thể, Firebase tự động đếm các yêu cầu mạng có mã phản hồi trong khoảng 100 - 399 là phản hồi thành công.

Bạn có thể tùy chỉnh cách tính tỷ lệ thành công bằng cách đếm các mã lỗi nhất định là "phản hồi thành công" ngoài các mã phản hồi mà Firebase tự động tính là thành công.

Ví dụ: nếu ứng dụng của bạn có API điểm cuối tìm kiếm, bạn có thể tính 404 phản hồi là "thành công" vì 404 phản hồi được mong đợi cho một điểm cuối tìm kiếm. Giả sử có 100 mẫu cho điểm cuối tìm kiếm này mỗi giờ và 60 trong số đó là 200 phản hồi và 40 trong số đó là 404 phản hồi. Trước khi bạn cấu hình tỷ lệ thành công, tỷ lệ thành công sẽ là 60%. Sau khi bạn định cấu hình tính toán tỷ lệ thành công để đếm 404 phản hồi là thành công, tỷ lệ thành công sẽ là 100%.

Định cấu hình tính toán tỷ lệ thành công

Để định cấu hình tính toán tỷ lệ thành công cho mẫu URL mạng, bạn phải có quyền firebaseperformance.config.update . Các vai trò sau đây bao gồm quyền bắt buộc này theo mặc định: Quản trị viên hiệu suất Firebase, Quản trị viên chất lượng Firebase , Quản trị viên FirebaseChủ sở hữu hoặc người chỉnh sửa dự án.

  1. Chuyển đến tab Trang tổng quan giám sát hiệu suất trong bảng điều khiển Firebase, sau đó chọn ứng dụng mà bạn muốn định cấu hình tính toán tỷ lệ thành công.
  2. Cuộn xuống bảng dấu vết ở cuối màn hình và chọn tab Yêu cầu mạng .
  3. Tìm mẫu URL mà bạn muốn định cấu hình tính toán tỷ lệ thành công.
  4. Ở ngoài cùng bên phải của hàng, mở menu mục bổ sung ( ) và chọn Định cấu hình tỷ lệ thành công .
  5. Làm theo hướng dẫn trên màn hình để chọn mã phản hồi mà bạn muốn tính là mã phản hồi thành công.