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 tương tự về mạng để giúp bạn hiểu 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 mà bạn tuỳ chỉnh phương pháp tổng hợp dữ liệu cho các yêu cầu mạng: tổng hợp dữ liệu dưới mẫu URL tuỳ chỉnh và tuỳ chỉnh cách tính tỷ lệ thành công.

Dữ liệu tổng hợp trong 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ẫu URL. 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 để giám sát các mẫu URL cụ thể Firebase không nắm bắt bằng mẫu URL tự động phát sinh so khớp. Ví dụ: bạn có thể sử dụng mẫu URL tuỳ chỉnh để khắc phục sự cố với một URL cụ thể hoặc để theo dõi 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 tuỳ chỉnh) và dữ liệu tổng hợp trong tab phụ Yêu cầu mạng của bảng theo dõi, là ở cuối Trang tổng quan về Hiệu suất của bảng điều khiển Firebase.

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 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 dùng tính năng khớp mẫu URL tự động. Đối với mọi yêu cầu phù hợp vào mẫu URL tùy chỉnh, Firebase sẽ tổng hợp các yêu cầu trong dữ liệu tùy chỉnh, Mẫu URL.

Nếu URL của yêu cầu khớp với nhiều mẫu URL tùy chỉnh, Firebase sẽ ánh xạ cho 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 ngay trong đường dẫn. Ví dụ: yêu cầu example.com/books/dog 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 books ở 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 tạo mẫu URL tuỳ 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 bằng cách tạo mẫu URL tuỳ chỉnh mới. Firebase không áp dụng cho các thời điểm trước đó tổng hợp lại dữ liệu yêu cầu.

• Chỉ các yêu cầu trong tương lai mới bị ảnh hưởng khi việc 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ẻ phụ Yêu cầu mạng trong thẻ bảng dấu vết nằm ở cuối màn hình Trang tổng quan về Hiệu suất của bảng điều khiển Firebase.

Thành viên của 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 và dữ liệu tổng hợp tương ứng.

Bạn có thể tạo tổng cộng 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 ứng dụng cho ứng dụng đó.

Để tạo 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ủ phải bao gồm một miền hợp lệ và có thể bao gồm cả miền con (không bắt buộc). Sử dụng cú pháp phân đoạn đường dẫn sau đây để tạo mẫu có thể khớp với URL.

• văn bản thuần tuý – khớp chính xác với một chuỗi
• * – khớp với phân đoạn miền con đầ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 tuỳ ý

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

Để khớp...	Tạo mẫu URL tuỳ 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
Một phân đoạn đường dẫn bất kỳ (*)	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 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 miền con đầ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 của *.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 đó

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

Để chỉ xem mẫu URL tuỳ chỉnh, hãy chọn Mẫu tuỳ 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. Xin lưu ý rằng nếu một tuỳ chỉnh Mẫu URL không có bất kỳ dữ liệu tổng hợp nào, thì nó 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 dưới 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 trong một mẫu URL tuỳ chỉnh hết hạn, thì Firebase không xóa mẫu URL tùy chỉnh khỏi bảng điều khiển Firebase. Thay vào đó, Firebase sẽ tiếp tục liệt kê trạng thái "trống" URL tuỳ chỉnh các mẫu trong danh sách Mẫu tùy chỉnh của thẻ phụ Yêu cầu mạng của bảng bảng dấu vết.

Xóa mẫu URL tùy 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. Từ cột Hiệu suất trang tổng quan, 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 trên trình đơn thả xuống trong mục Yêu cầu về mạng thẻ phụ.

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 ở ngoài cùng bên phải của chọn Xoá mẫu tuỳ chỉnh rồi xác nhận việc xoá trong hộp thoại.

Khi bạn 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 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 phù hợp, thì nó quay lại sử dụng tự động so khớp mẫu URL.

• 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 bằng cách 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à phiên bản tổng hợp của mẫu đó dữ liệu trong tab phụ Yêu cầu mạng (với Tất cả yêu cầu mạng đã chọn) cho đến khi hết 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 xoá mẫu URL tuỳ chỉnh.

• Thẻ phụ Yêu cầu mạng (trong đó Mẫu tuỳ chỉnh được chọn) không có liệt kê mọi mẫu URL tuỳ chỉnh đã xoá.

Các bước tiếp theo

• Thiết lập thông 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 thông 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 phản hồi thành công so với tổng số câu trả lời. Chỉ số này giúp bạn đo lường mạng và máy chủ lỗi.

Cụ thể, Firebase tự động tính các yêu cầu mạng bằng một phản hồi trong phạm vi 100 - 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 đếm một số 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 sẽ tự động được tính là thành công.

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

Để định cấu hình tính năng tính tỷ lệ thành công cho 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 sẽ 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.

1. Chuyển đến Performance Monitoring Trang tổng quan phím tab trong bảng điều khiển của Firebase, sau đó chọn ứng dụng mà bạn muốn định cấu hình phép 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 và 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 tỷ lệ thành công phép tính.
4. Ở ngoài cùng 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 mã phản hồi bạn muốn được 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à tuỳ chỉnh. Bạn chỉ nên định cấu hình tỷ lệ thành công cho các 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.