Google is committed to advancing racial equity for Black communities. See how.
Trang này được dịch bởi Cloud Translation API.
Switch to English

Thêm giám sát tùy chỉnh cho mã ứng dụng cụ thể

Giám sát hiệu suất thu thập các dấu vết để giúp bạn theo dõi hiệu suất của ứng dụng. Dấu vết là một báo cáo về dữ liệu hiệu suất được thu thập giữa hai thời điểm trong ứng dụng của bạn.

Bạn có thể tạo dấu vết của riêng mình để theo dõi dữ liệu hiệu suất được liên kết với mã cụ thể trong ứng dụng của bạn. Với một dấu vết mã tùy chỉnh , bạn có thể đo lường thời gian ứng dụng của mình hoàn thành một tác vụ cụ thể hoặc một nhóm tác vụ, ví dụ: tải một bộ hình ảnh hoặc truy vấn cơ sở dữ liệu của bạn.

Số liệu mặc định cho theo dõi mã tùy chỉnh là "thời lượng" của nó (thời gian giữa điểm bắt đầu và điểm dừng của theo dõi), nhưng bạn cũng có thể thêm số liệu tùy chỉnh .

Trong mã của mình, bạn xác định phần đầu và phần cuối của một dấu vết mã tùy chỉnh bằng cách sử dụng các API do SDK giám sát hiệu suất cung cấp. Dấu vết mã tùy chỉnh cũng có thể được bắt đầu sau khi chúng được tạo và chúng an toàn trong chuỗi.

Xem dữ liệu từ dấu vết mã tùy chỉnh trong tab Trên thiết bị của bảng điều khiển Firebase ( tìm hiểu thêm sau trên trang này). Lưu ý rằng vì chỉ số mặc định được thu thập cho các dấu vết này là "thời lượng", chúng đôi khi được gọi là "Dấu vết thời lượng". Ngoài ra, trong bảng điều khiển Firebase (trong tab Trên thiết bị ), các dấu vết này được nhóm lại trong bảng có nhãn Thời lượng .

Thuộc tính mặc định, thuộc tính tùy chỉnh và chỉ số tùy chỉnh

Đối với dấu vết mã tùy chỉnh, Giám sát hiệu suất tự động ghi lại các thuộc tính mặc định (siêu dữ liệu phổ biến như phiên bản ứng dụng, quốc gia, thiết bị, v.v.) để bạn có thể lọc dữ liệu cho dấu vết trong bảng điều khiển Firebase. Bạn cũng có thể thêm và giám sát các thuộc tính tùy chỉnh (chẳng hạn như cấp độ trò chơi hoặc thuộc tính người dùng).

Bạn có thể định cấu hình thêm một dấu vết mã tùy chỉnh để ghi lại các số liệu tùy chỉnh cho các sự kiện liên quan đến hiệu suất xảy ra trong phạm vi của dấu vết. Ví dụ: bạn có thể tạo số liệu tùy chỉnh cho số lần truy cập và bỏ lỡ bộ nhớ cache hoặc số lần giao diện người dùng không phản hồi trong một khoảng thời gian đáng chú ý.

Thuộc tính tùy chỉnh và chỉ số tùy chỉnh hiển thị trong bảng điều khiển Firebase cùng với thuộc tính mặc định và chỉ số mặc định cho theo dõi.

Thêm dấu vết mã tùy chỉnh

Sử dụng API theo dõi giám sát hiệu suất ( Swift | Obj-C ) để thêm dấu vết mã tùy chỉnh để theo dõi mã ứng dụng cụ thể.

Lưu ý những điều dưới đây:

  • Một ứng dụng có thể có nhiều dấu vết mã tùy chỉnh.
  • Nhiều hơn một dấu vết mã tùy chỉnh có thể chạy cùng một lúc.
  • Tên cho dấu vết mã tùy chỉnh phải đáp ứng các yêu cầu sau: không có khoảng trắng ở đầu hoặc cuối, không có ký tự gạch dưới ( _ ) ở đầu và độ dài tối đa là 100 ký tự.
  • Dấu vết mã tùy chỉnh hỗ trợ thêm số liệu tùy chỉnhthuộc tính tùy chỉnh .

Để bắt đầu và dừng theo dõi mã tùy chỉnh, hãy bọc mã mà bạn muốn theo dõi bằng các dòng mã tương tự như sau:

Nhanh

// Add the Performance Monitoring module to your header
import FirebasePerformance

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

// code that you want to trace

trace.stop()

Objective-C

// Add the Performance Monitoring module to your header
@import FirebasePerformance;

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

// code that you want to trace

[trace stop];

Thêm số liệu tùy chỉnh vào dấu vết mã tùy chỉnh

Sử dụng API theo dõi giám sát hiệu suất ( Swift | obj-C ) để thêm số liệu tùy chỉnh vào dấu vết mã tùy chỉnh.

Lưu ý những điều dưới đây:

  • Tên cho chỉ số tùy chỉnh phải đáp ứng các yêu cầu sau: không có khoảng trắng ở đầu hoặc cuối, không có ký tự gạch dưới ( _ ) ở đầu và độ dài tối đa là 100 ký tự.
  • Mỗi dấu vết mã tùy chỉnh có thể ghi lại tối đa 32 chỉ số (bao gồm cả chỉ số Thời lượng mặc định).

Để thêm số liệu tùy chỉnh, hãy thêm một dòng mã tương tự như sau mỗi khi sự kiện xảy ra. Ví dụ: chỉ số tùy chỉnh này tính các sự kiện liên quan đến hiệu suất xảy ra trong ứng dụng của bạn, chẳng hạn như số lần truy cập hoặc thử lại trong bộ nhớ cache.

Nhanh

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.incrementMetric(named:"EVENT_NAME", by: 1)
// code that you want to trace (and log custom metrics)

trace.stop()

Objective-C

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace incrementMetric:@"EVENT_NAME" by:1];
// code that you want to trace (and log custom metrics)

[trace stop];

Tạo thuộc tính tùy chỉnh cho dấu vết mã tùy chỉnh

Sử dụng API theo dõi hiệu suất theo dõi ( Swift | Obj-C ) để thêm thuộc tính tùy chỉnh vào dấu vết mã tùy chỉnh.

Để sử dụng thuộc tính tùy chỉnh, hãy thêm mã vào ứng dụng của bạn để xác định thuộc tính và liên kết thuộc tính đó với một dấu vết mã tùy chỉnh cụ thể. Bạn có thể đặt thuộc tính tùy chỉnh bất kỳ lúc nào giữa thời điểm bắt đầu theo dõi và khi dừng theo dõi.

Lưu ý những điều dưới đây:

  • Tên cho thuộc tính tùy chỉnh phải đáp ứng các yêu cầu sau: không có khoảng trắng ở đầu hoặc cuối, không có ký tự gạch dưới ( _ ) ở đầu và độ dài tối đa là 32 ký tự.

  • Mỗi dấu vết mã tùy chỉnh có thể ghi lại tối đa 5 thuộc tính tùy chỉnh.

  • Bạn không nên sử dụng các thuộc tính tùy chỉnh chứa thông tin nhận dạng cá nhân của một cá nhân đối với Google.

    Tìm hiểu thêm về hướng dẫn này

Nhanh

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.setValue("A", forAttribute: "experiment")

// Update scenario.
trace.setValue("B", forAttribute: "experiment")

// Reading scenario.
let experimentValue:String? = trace.valueForAttribute("experiment")

// Delete scenario.
trace.removeAttribute("experiment")

// Read attributes.
let attributes:[String, String] = trace.attributes;

Objective-C

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace setValue:@"A" forAttribute:@"experiment"];

// Update scenario.
[trace setValue:@"B" forAttribute:@"experiment"];

// Reading scenario.
NSString *experimentValue = [trace valueForAttribute:@"experiment"];

// Delete scenario.
[trace removeAttribute:@"experiment"];

// Read attributes.
NSDictionary <NSString *, NSString *> *attributes = [trace attributes];

Theo dõi, xem và lọc dữ liệu hiệu suất

Theo dõi các chỉ số cụ thể trong trang tổng quan của bạn

Thêm các chỉ số chính vào trang tổng quan để tìm hiểu xu hướng của chúng. Bạn có thể nhanh chóng xác định các hồi quy bằng cách xem các thay đổi hàng tuần hoặc xác minh rằng các thay đổi gần đây trong mã của bạn đang cải thiện hiệu suất.

hình ảnh về trang tổng quan chỉ số Giám sát hiệu suất Firebase

Để thêm chỉ số vào trang tổng quan của bạn, hãy chuyển đến Trang tổng quan về hiệu suất trong bảng điều khiển Firebase, sau đó nhấp vào tab Trang tổng quan . Nhấp vào thẻ số liệu trống, sau đó chọn số liệu hiện có để thêm vào trang tổng quan của bạn. Nhấp vào trên thẻ chỉ số đã phổ biến để có thêm tùy chọn, chẳng hạn như thay thế hoặc xóa số liệu.

Trang tổng quan hiển thị dữ liệu chỉ số được thu thập theo thời gian, cả ở dạng đồ họa và dưới dạng số phần trăm thay đổi.

Tìm hiểu thêm về cách sử dụng trang tổng quan .

Xem tất cả các dấu vết và dữ liệu của chúng

Để xem các dấu vết này, hãy chuyển đến Bảng điều khiển hiệu suất trong bảng điều khiển Firebase, sau đó nhấp vào tab Trên thiết bị .

Từ tab Trên thiết bị , bạn có thể nhấp qua các màn hình khác nhau để khám phá dấu vết và đi sâu vào các chỉ số quan tâm. Trên hầu hết các trang, bạn có thể sử dụng nút bộ lọc (trên cùng bên trái màn hình) để lọc dữ liệu theo thuộc tính, ví dụ:

hình ảnh dữ liệu Giám sát hiệu suất Firebase đang được lọc theo thuộc tính
  • Lọc theo phiên bản Ứng dụng để xem dữ liệu về bản phát hành trước đây hoặc bản phát hành mới nhất của bạn
  • Lọc theo thiết bị để tìm hiểu cách các thiết bị cũ hơn xử lý ứng dụng của bạn
  • Lọc theo Quốc gia để đảm bảo vị trí cơ sở dữ liệu của bạn không ảnh hưởng đến một khu vực cụ thể

Tìm hiểu thêm về cách xem dữ liệu cho dấu vết của bạn .

Bước tiếp theo

  • Xem báo cáo chi tiết về các phiên của người dùng trong đó bạn có thể thấy một dấu vết cụ thể trong bối cảnh dòng thời gian của các dấu vết khác được thu thập trong cùng một phiên.