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 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 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 tùy chỉnh và tùy chỉnh cách tính tỷ lệ thành công .

Dữ liệu tổng hợp theo mẫu URL tùy 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 thì 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 tùy chỉnh để theo dõi các mẫu URL cụ thể mà Firebase không thu thập bằng tính năng khớp mẫu URL tự động có nguồn gốc của nó. Ví dụ: bạn có thể sử dụng mẫu URL tùy chỉnh để khắc phục sự cố với 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 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 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.

Việc so khớp mẫu URL tùy chỉnh hoạt động như thế nào?

Firebase cố gắng khớp các URL yêu cầu với bất kỳ mẫu URL tùy chỉnh nào được định cấu hình trước khi quay lại chế độ khớp mẫu URL tự động. Đối với mọi yêu cầu khớp với mẫu URL tùy chỉnh, Firebase 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 sẽ 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 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 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 trùng khớ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ước đây.

  • 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 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.

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ả thành viên dự án đều có thể xem mẫu URL tùy chỉnh và dữ liệu tổng hợp của họ.

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 cho mỗi tên 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ể tùy ý bao gồm miền phụ. 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 hậu tố đường dẫn tùy ý

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

Khớp... Tạo mẫu URL tùy chỉnh như... Ví dụ 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ỳ đoạn đường dẫn đơ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 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

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ả 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 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 tùy chỉnh, hãy chọn Mẫu tùy chỉnh từ menu thả xuống trong tab phụ Yêu cầu mạng của bảng dấu vết. 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 theo 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 dấu vết.

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ừ Trang tổng quan hiệu suất , cuộn xuống bảng dấu vết, 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 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 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à 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 đã 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 theo 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 đã xóa nào.

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 ứ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 bạn đặt.

Tùy chỉnh cách tính tỷ lệ thành công

Một trong những số liệu 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ố 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 tính 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 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" bên cạnh 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 phản hồi 404 là "thành công" vì dự kiến ​​sẽ có phản hồi 404 cho đ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 mẫu trong số đó là 200 phản hồi và 40 mẫu 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 đặt cấu hình tính toán tỷ lệ thành công để đếm phản hồi 404 là thành công, tỷ lệ thành công sẽ là 100%.

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

Để định cấu hình tính toán 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 bao gồm 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 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 dấu vết ở 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.