Tuỳ chỉnh tính năng tổng hợp dữ liệu yêu cầu mạng

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õ 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 cho 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 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 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ẫu URL hay không. Nếu URL yêu cầu khớp với 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 mẫu URL tuỳ chỉnh để giám sát 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 được suy ra. Ví dụ: bạn có thể sử dụng mẫu URL tuỳ chỉnh để khắc phục sự cố một URL cụ thể hoặc để giám sát 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ả mẫu URL tuỳ chỉnh) và dữ liệu tổng hợp của các mẫu URL đó trong thẻ con Yêu cầu mạng của bảng dấu vết. Bảng 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 cố gắng so khớp URL yêu cầu với mọi mẫu URL tuỳ chỉnh đã định cấu hình trước khi chuyển sang 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ẫ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, thì Firebase 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ụ: một yêu cầu đến example.com/books/dog khớp với 2 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/* có quyền ưu tiên hơn phân đoạn bên trái cùng * trong example.com/*/dog.

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

• Các kết quả so 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 bạn tạo mẫu URL tuỳ chỉnh mới. Firebase không tổng hợp lại dữ liệu yêu cầu một cách hồi tố.

• Chỉ các yêu cầu trong tương lai mới bị ảnh hưởng khi bạn tạo 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ẫu URL tuỳ chỉnh mới.

Tạo mẫu URL tuỳ chỉnh

Bạn có thể tạo mẫu URL tuỳ chỉnh từ thẻ con Yêu cầu mạng trong bảng dấu vết. Bảng này nằm ở 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 để 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 các mẫu URL tuỳ chỉnh và dữ liệu tổng hợp của các mẫu URL đó.

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ẫu URL tuỳ chỉnh, hãy bắt đầu bằng tên máy chủ, sau đó là các phân đ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ả tên miền phụ (không bắt buộc). Sử dụng cú pháp phân đoạn đường dẫn sau để tạo mẫu có thể so khớp với URL.

• văn bản thuần tuý – so khớp với một chuỗi chính xác
• * – so 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
• ** – so khớp với hậu tố đường dẫn tuỳ ý

Bảng sau đây mô tả một số trường hợp so khớp mẫu URL tuỳ chỉnh tiềm năng.

Để so khớp...	Hãy tạo mẫu URL tuỳ chỉnh như...	Ví dụ về các kết quả so khớp 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ỳ phân đoạn đường dẫ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 so khớp với example.com/foo.
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 tên miền phụ đầu tiên (*)	*.example.com/foo	bar.example.com/foo baz.example.com/foo

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

Xem các mẫu URL tuỳ chỉnh và dữ liệu của các mẫu URL đó

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ẻ con Yêu cầu mạng của bảng dấu vết. Bảng 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 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ẽ xoá 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 tuỳ chỉnh hết hạn, thì Firebase sẽ 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ẫu URL tự động.

1. Trên trang tổng quan Hiệu suất, hãy cuộn xuống bảng dấu vết, sau đó chọn thẻ phụ Yêu cầu mạng.

2. Chọn Mẫu tuỳ chỉnh trong trình đơn thả xuống ở thẻ phụ Yêu cầu mạng.

3. Di chuột qua hàng của mẫu URL tuỳ chỉnh mà bạn muốn xoá.

4. Nhấp vào biểu tượng ở phía bên phải của hàng, chọn Xoá mẫu tuỳ chỉnh, sau đó xác nhận việc xoá trong hộp thoại.

Khi xoá 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 ánh xạ đến 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 khớp, thì hệ thống sẽ chuyển sang tính năng so khớp mẫu URL tự động.

• Các kết quả so 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 bạn xoá mẫu URL tuỳ chỉnh.

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

• Thẻ phụ Yêu cầu mạng (khi chọn Mẫu tuỳ chỉnh) không liệt kê bất kỳ mẫu URL tuỳ chỉnh nào đã 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 giám sát cho mỗi 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. Chỉ số này giúp bạn đo lường các lỗi mạng và lỗi 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à 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 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 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%.

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 tạo cấu hình.

Đị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ẫ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 Firebase, và Chủ sở hữu hoặc Người chỉnh sửa dự án.

1. 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 cách tính tỷ lệ thành công.
2. Cuộ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.
3. 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.
4. Ở 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.
5. Làm theo hướng dẫn trên màn hình để chọn các 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à mẫu URL tuỳ chỉnh. Bạn chỉ nên định cấu hình tỷ lệ thành công cho mẫu URL tuỳ chỉnh vì mẫu URL tự động có thể thay đổi theo thời gian khi dữ liệu của bạn thay đổi.