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 đượ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 hai cách để bạn tuỳ chỉnh tính năng 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ộ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 mẫu URL tuỳ chỉnh để theo dõi các mẫu URL cụ thể mà Firebase không ghi lại bằng tính năng so khớp mẫu URL tự động phái sinh. Ví dụ: bạn có thể sử dụng 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ả 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 đó trong thẻ con Yêu cầu mạng của bảng dấu vết, nằm ở cuối trang tổng quan 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 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 phương thức 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 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ụ: một yêu cầu đến 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:

• Việc tạo mẫu URL tuỳ chỉnh mới sẽ không ảnh hưởng đến 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 đó. Firebase không tổng hợp lại dữ liệu yêu cầu theo cách hồi tố.

• Việc tạo mẫu URL tuỳ chỉnh mới chỉ ảnh hưởng đến các yêu cầu trong tương lai. 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 ở 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 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ổng cộng 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 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 đ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 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
• ** – khớp với hậu tố đường dẫn tuỳ ý

Bảng sau đây mô tả một số kiểu so khớp mẫu URL tuỳ chỉnh có thể xảy ra.

Để so khớp...	Tạo mẫu URL tuỳ chỉnh như...	Ví dụ về các URL 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ỳ 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 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 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 mẫu URL tuỳ chỉnh và dữ liệu của mẫu

Firebase hiển thị tất 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 đó trong thẻ con Yêu cầu mạng của bảng dấu vết, nằm ở cuối trang tổng quan Hiệu suất của bảng điều khiển Firebase.

Để 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 trong thẻ phụ Yêu cầu mạng của bảng dấu vết. Xin lưu ý rằng nếu mẫu URL tuỳ chỉnh không có dữ liệu tổng hợp nào, 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ẫ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á mẫu URL tuỳ chỉnh khỏi dự án. 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 di chuyể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 của thẻ con 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 ở ngoài cùng 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ộ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 không tìm thấy mẫu URL tuỳ chỉnh nào khớp, Firebase sẽ chuyển về phương thức tự động so khớp mẫu URL.

• Việc xoá mẫu URL tuỳ chỉnh sẽ không ảnh hưởng đến 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 đó.

  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 đó trong thẻ phụ Yêu cầu kết nối mạng (với lựa chọn Tất cả yêu cầu kết nối mạng) 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 tuỳ chỉnh đã xoá hết hạn, Firebase sẽ xoá mẫu URL tuỳ chỉnh đó.

• Thẻ con 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 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 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 số lượt phản hồi thành công so với tổng số lượt phản hồi. Chỉ số này giúp bạn đo lường các lỗi 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 khoảng 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 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ì dự kiến sẽ có 404 phản hồi cho một đ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, 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ệ này sẽ là 60%. Sau khi bạn định cấu hình tính toán 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 tính năng tính 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 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.
2. 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.
3. Tìm mẫu URL mà bạn muốn định cấu hình tính năng tính tỷ lệ thành công.
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 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à 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.