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

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 ứng dụng của bạn. 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 mẫu URL tùy chỉnh và tùy 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 tùy chỉnh

Đối với mỗi yêu cầu, Firebase kiểm tra xem URL của yêu cầu mạng có khớp với 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 để giám sát các mẫu URL cụ thể mà Firebase không nắm bắt được bằng tính năng so khớp mẫu URL tự động bắt nguồn từ nó. Ví dụ: bạn có thể sử dụng mẫu URL tùy chỉnh để khắc phục sự cố 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á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 lại đối sánh mẫu URL tự động. Đối với mọi yêu cầu đối sánh với mẫu URL tùy chỉnh, Firebase sẽ tổng hợp dữ liệu của yêu cầu theo mẫu URL tùy chỉnh.

Nếu URL của yêu cầu khớp với nhiều mẫu URL tùy chỉnh, thì Firebase chỉ ánh xạ yêu cầu tới 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ụ: 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ì phân đoạn ngoài cùng bên trái books 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ẫu URL tùy chỉnh mới, hãy lưu ý những điều sau:

• Dữ liệu phù hợp và tổng hợp từ các yêu cầu trước đó không bị ảnh hưởng khi 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ở về trước.

• Chỉ các yêu cầu trong tương lai mới bị ảnh hưởng khi tạo mẫu URL tùy chỉnh mới. Bạn có thể phải đợ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, nằm ở 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 chỉnh sửa để 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 tối đa 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 trên 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ủ, theo sau là các đoạn đường dẫn. Tên máy chủ phải bao gồm miền hợp lệ và có thể bao gồm miền phụ tùy ý. Sử dụng cú pháp đoạn đường dẫn sau để tạo 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
• ** — khớp với một 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ư...	Ví dụ khớp với mẫu URL này
URL chính xác	example.com/foo/baz	example.com/foo/baz
Bất kỳ đoạn đường đơ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 .
Một 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

Lưu ý: Đối với các mẫu URL tùy chỉnh, Firebase không hỗ trợ cú pháp *. file-extension , như *.png hoặc *.css .

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 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ừ trình đơn thả xuống trong tab phụ Yêu cầu mạng của bảng theo dõi. 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 đó chỉ xuất hiện trong danh sách này.

Khi 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 trong một 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 theo dõi.

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 theo dõi, 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 đối sánh mẫu URL tự động .

• Dữ liệu 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 khi xóa mẫu URL tùy chỉnh.

  Bạn vẫn có thể truy cập mẫu URL tùy chỉnh đã xóa và dữ liệu tổng hợp của mẫu đó 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 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 (với Mẫu tùy chỉnh được chọn) không liệt kê bất kỳ mẫu URL tùy chỉnh nào đã 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 chỉ số 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à tỷ 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 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 phép 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, 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 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à phản hồi 200 và 40 trong số đó 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 tính toán tỷ lệ thành công để tính 404 phản hồi là thành công, tỷ lệ thành công sẽ là 100%.

Lưu ý: Cấu hình tỷ lệ thành công mới chỉ áp dụng cho dữ liệu được thu thập sau khi cấu hình được tạo.

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

Để định cấu hình phép tính 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 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 Firebase và Chủ 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 theo dõi ở 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, hãy 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.

Lưu ý: Bạn có thể định cấu hình tỷ lệ thành công cho cả mẫu URL tự động và tùy chỉnh. Bạn chỉ nên định cấu hình tỷ lệ thành công cho các mẫu URL tùy chỉnh vì các mẫu URL tự động có thể thay đổi theo thời gian khi dữ liệu của bạn thay đổi.