Firebase Performance Monitoring 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 rõ các xu hướng về hiệu suất yêu cầu mạng.
Tuy nhiên, đôi khi bạn cần tuỳ 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 các trường hợp sử dụng của ứng dụng. Chúng tôi cung cấp 2 cách để bạn tuỳ chỉnh việc 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 tuỳ chỉnh và tuỳ chỉnh cách tính tỷ lệ thành công.
Tổng hợp dữ liệu theo các mẫu URL tuỳ 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 tuỳ chỉnh để theo dõi các mẫu URL cụ thể mà Firebase không thu thập được bằng tính năng so khớp mẫu URL tự động. Ví dụ: bạn có thể sử dụng một mẫu URL tuỳ chỉnh để khắc phục sự cố cho một URL cụ thể hoặc để theo dõi một nhóm URL cụ thể theo thời gian.
Firebase hiển thị tất cả các mẫu URL (bao gồm cả mẫu URL tuỳ chỉnh) và dữ liệu tổng hợp của các mẫu URL đó trong thẻ phụ Yêu cầu mạng của bảng dấu vết. Thẻ này nằm ở cuối trang tổng quan Hiệu suất của Firebase console.
Tính năng so khớp mẫu URL tuỳ chỉnh hoạt động như thế nào?
Firebase sẽ cố gắng so khớp các URL yêu cầu với mọi mẫu URL tuỳ chỉnh đã định cấu hình trước khi quay lại tính năng so khớp mẫu URL tự động. Đối với mọi yêu cầu khớp với một mẫu URL tuỳ chỉnh, Firebase sẽ tổng hợp dữ liệu của các yêu cầu đó theo mẫu URL tuỳ chỉnh.
Nếu URL của một yêu cầu khớp với nhiều mẫu URL tuỳ chỉnh, Firebase sẽ chỉ ánh xạ yêu cầu đó đến mẫu URL tuỳ chỉnh cụ thể nhất, theo thứ tự cụ thể sau: văn bản thuần tuý > *
> **
từ trái sang phải trong đường dẫn. Ví dụ: yêu cầu đến example.com/books/dog
sẽ khớp với hai mẫu URL tuỳ chỉnh:
example.com/books/*
example.com/*/dog
Tuy nhiên, mẫu example.com/books/*
là mẫu URL khớp cụ thể nhất vì phân đoạn bên trái cùng books
trong example.com/books/*
sẽ được ưu tiên hơn phân đoạn bên trái cùng *
trong example.com/*/dog
.
Khi tạo một mẫu URL tuỳ chỉnh mới, hãy lưu ý những điều sau:
Các yêu cầu trước và dữ liệu tổng hợp từ các yêu cầu đó sẽ không bị ảnh hưởng khi bạn tạo một mẫu URL tuỳ chỉnh mới. Firebase không tổng hợp lại dữ liệu yêu cầu theo cách hồi tố.
Chỉ những yêu cầu trong tương lai mới chịu ảnh hưởng khi bạn tạo một mẫu URL tuỳ chỉnh mới. Bạn có thể phải đợi tối đa 12 giờ để Performance Monitoring thu thập và tổng hợp dữ liệu theo một mẫu URL tuỳ chỉnh mới.
Tạo mẫu URL tuỳ chỉnh
Bạn có thể tạo một mẫu URL tuỳ chỉnh từ thẻ phụ Yêu cầu mạng trong bảng dấu vết ở cuối trang tổng quan 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 chỉnh sửa thì mới có thể tạo mẫu URL tuỳ chỉnh mới; tuy nhiên, tất cả thành viên dự án đều có thể xem mẫu URL tuỳ chỉnh và dữ liệu tổng hợp của mẫu đó.
Bạn có thể tạo tối đa 400 mẫu URL tuỳ chỉnh cho mỗi ứng dụng và tối đa 100 mẫu URL tuỳ chỉnh cho mỗi miền của ứng dụng đó.
Để tạo một mẫu URL tuỳ chỉnh, hãy bắt đầu bằng một tên máy chủ, theo sau là các phân đoạn đường dẫn. Tên máy chủ lưu trữ phải bao gồm một miền hợp lệ và có thể bao gồm miền con (không bắt buộc). Sử dụng cú pháp đoạn đường dẫn sau đây để tạo một mẫu có thể khớp với URL.
- văn bản thuần tuý – khớp với một chuỗi chính xác
*
– so khớp với phân khúc tên miền con đầu tiên hoặc bất kỳ chuỗi nào trong một phân khúc đường dẫn duy nhất**
– khớp với một hậu tố đường dẫn tuỳ ý
Bảng sau đây mô tả một số mẫu URL tuỳ chỉnh có thể khớp.
Để khớp... | Tạo mẫu URL tuỳ chỉnh như... | Ví dụ về các trường hợp khớp với mẫu URL này |
---|---|---|
URL khớp chính xác | example.com/foo/baz |
example.com/foo/baz
|
Mọi phân đoạn đường dẫn đơn lẻ (* ) |
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 |
|
Một hậu tố đường dẫn tuỳ ý (** ) |
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 miền con đầu tiên (* ) |
*.example.com/foo |
bar.example.com/foo baz.example.com/foo |
Xem các mẫu URL tuỳ chỉnh và dữ liệu của các mẫu đó
Firebase hiển thị tất cả các mẫu URL (bao gồm cả mẫu URL tuỳ chỉnh) và dữ liệu tổng hợp của các mẫu URL đó trong thẻ phụ Yêu cầu mạng của bảng dấu vết. Thẻ này nằm ở cuối trang tổng quan Hiệu suất của Firebase console.
Để chỉ xem các mẫu URL tuỳ chỉnh, hãy chọn Mẫu tuỳ chỉnh trong trình đơn thả xuống ở thẻ phụ Yêu cầu mạng của bảng dấu vết. Xin lưu ý rằng nếu một mẫu URL tuỳ chỉnh không có dữ liệu tổng hợp, thì mẫu đó sẽ 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ột mẫu URL, Firebase sẽ xoá dữ liệu đó khỏi mẫu URL. Nếu tất cả dữ liệu được tổng hợp theo một mẫu URL tuỳ chỉnh hết hạn, thì Firebase không xoá mẫu URL tuỳ 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 tuỳ chỉnh "trống" trong danh sách Mẫu tuỳ chỉnh của thẻ phụ Yêu cầu mạng trong bảng dấu vết.
Xoá mẫu URL tuỳ chỉnh
Bạn có thể xoá các mẫu URL tuỳ chỉnh khỏi dự án của mình. Xin lưu ý rằng bạn không thể xoá một mẫu URL tự động.
Trên trang tổng quan Hiệu suất, hãy di chuyển xuống bảng dấu vết, rồi chọn thẻ phụ Yêu cầu mạng.
Chọn Mẫu tuỳ chỉnh trong trình đơn thả xuống ở thẻ phụ Yêu cầu mạng.
Di chuột qua hàng của mẫu URL tuỳ chỉnh mà bạn muốn xoá.
Nhấp vào biểu tượng
ở ngoài cùng bên phải của hàng, chọn Xoá mẫu tuỳ chỉnh, rồi xác nhận việc xoá trong hộp thoại.
Khi xoá một mẫu URL tuỳ chỉnh, hãy lưu ý những điều sau:
Mọi yêu cầu trong tương lai đều được liên kết với mẫu URL tuỳ chỉnh khớp cụ thể nhất tiếp theo. Nếu Firebase không tìm thấy mẫu URL tuỳ chỉnh nào phù hợp, thì Firebase sẽ chuyển về chế độ so khớp mẫu URL tự động.
Các kết quả trùng khớp và dữ liệu tổng hợp từ các yêu cầu trước đó sẽ không bị ảnh hưởng khi bạn xoá một mẫu URL tuỳ chỉnh.
Bạn vẫn có thể truy cập vào một mẫu URL tuỳ chỉnh đã bị xoá và dữ liệu tổng hợp của mẫu đó trong thẻ phụ Yêu cầu mạng (khi bạn chọn Tất cả yêu cầu mạng) cho đến khi hết 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 tuỳ chỉnh đã xoá hết hạn, Firebase sẽ xoá mẫu URL tuỳ chỉnh đó.
Thẻ phụ Yêu cầu mạng (khi bạn chọn Mẫu tuỳ chỉnh) không liệt kê bất kỳ mẫu URL tuỳ chỉnh nào đã bị xoá.
Các 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. 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.
Tuỳ chỉnh cách tính tỷ lệ thành công
Một trong những chỉ số mà Firebase theo dõi 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à tỷ lệ phần trăm số phản hồi thành công so với tổng số phản hồi. Chỉ số này giúp bạn đo lường các lỗi về mạng và máy chủ.
Cụ thể, Firebase tự động tính các yêu cầu mạng có mã phản hồi trong phạm vi từ 100 đến 399 là các phản hồi thành công.
Bạn có thể tuỳ chỉnh cách tính tỷ lệ thành công bằng cách tính một số mã lỗi nhất định là "phản hồi thành công" ngoài những 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ó một API điểm cuối tìm kiếm, thì bạn có thể tính các phản hồi 404 là "thành công" vì các phản hồi 404 được dự kiến 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ờ, trong đó 60 mẫu là phản hồi 200 và 40 mẫu là phản hồi 404. Trước khi bạn định 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 cách tính tỷ lệ thành công để tính các phản hồi 404 là thành công, tỷ lệ thành công sẽ là 100%.
Định cấu hình cách tính tỷ lệ thành công
Để định cấu hình cách tính tỷ lệ thành công cho một mẫu URL mạng, bạn phải có quyền firebaseperformance.config.update
. Theo mặc định, các vai trò sau đây có quyền bắt buộc này: 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 Firebase và Chủ sở hữu hoặc Người chỉnh sửa dự án.
- Chuyển đến thẻ Performance Monitoring Trang tổng quan 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 năng tính tỷ lệ thành công.
- Di chuyển xuống bảng dấu vết ở cuối màn hình rồi chọn thẻ Yêu cầu mạng.
- Tìm mẫu URL mà bạn muốn định cấu hình cách tính tỷ lệ thành công.
- Ở phía bên phải của hàng, hãy mở trình đơn mục bổ sung ( ) rồi chọn Định cấu hình tỷ lệ thành công.
- 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.