Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

Hiệu suất giám sát thu thập dấu vết để giúp bạn giám sát việc thực hiện các ứng dụng của bạn. 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 phải mất bao lâu ứng dụng của bạn để hoàn thành một nhiệm vụ cụ thể hoặc một tập hợp các nhiệm vụ, ví dụ như tải một tập hợp các hình ảnh hoặc truy vấn cơ sở dữ liệu của bạn.

Giá trị mặc định metric cho một dấu vết mã tùy chỉnh là "duration" của nó (thời gian giữa bắt đầu và điểm dừng của các dấu vết), nhưng bạn có thể thêm các chỉ số tùy chỉnh, là tốt.

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.đang Tuỳ chỉnh các dấu vết có thể bắt đầu bất cứ lúc nào sau khi họ đã được tạo ra, và họ là chủ đề an toàn.

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

Bạn có thể xem dữ liệu từ những dấu vết trong các dấu vết Tuỳ chỉnh tab phụ của bảng dấu vết, mà là ở dưới cùng của bảng điều khiển Performance (tìm hiểu thêm về cách sử dụng giao diện điều khiển sau đó trên trang này).

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 vết mã tùy chỉnh, Hiệu suất giám sát tự động đăng nhập 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, nước, điện thoại, vv) để bạn có thể lọc dữ liệu cho các dấu vết trong các căn cứ hỏa lực console. Bạn cũng có thể thêm và giám sát các thuộc tính tùy chỉnh (ví dụ như, mức độ trò chơi hoặc các thuộc tính người dùng).

Thêm nữa, bạn có thể cấu hình một dấu vết mã tùy chỉnh để ghi chỉ số tùy chỉnh cho các sự kiện hoạt động liên quan 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 các 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 Performance Giám sát Trace API ( 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 vết mã tùy chỉnh phải đáp ứng các yêu cầu sau: không đứng đầu hoặc cuối, không có dấu gạch dưới hàng đầu ( _ ) nhân vật, và chiều dài tối đa là 100 ký tự.
  • Mã tùy chỉnh dấu vết hỗ trợ thêm chỉ số 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

Lưu ý: sản phẩm căn cứ hỏa lực này không có sẵn trên hệ điều hành MacOS, Mac Catalyst, mục tiêu watchos.
// 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

Lưu ý: sản phẩm căn cứ hỏa lực này không có sẵn trên hệ điều hành MacOS, Mac Catalyst, mục tiêu watchos.
// 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 Performance Giám sát Trace API ( Swift | obj-C ) để thêm chỉ số tùy chỉnh để 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 đứng đầu hoặc cuối, không có dấu gạch dưới hàng đầu ( _ ) nhân vật, và chiều dài tối đa là 100 ký tự.
  • Mỗi mã tùy chỉnh dấu vết có thể ghi âm lên đến 32 số liệu (bao gồm cả số liệu Thời gian 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

Lưu ý: sản phẩm căn cứ hỏa lực này không có sẵn trên hệ điều hành MacOS, Mac Catalyst, mục tiêu watchos.
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

Lưu ý: sản phẩm căn cứ hỏa lực này không có sẵn trên hệ điều hành MacOS, Mac Catalyst, mục tiêu watchos.
FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace incrementMetric:@"EVENT_NAME" byInt: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 Performance Giám sát Trace API ( Swift | obj-C ) để thêm thuộc tính tuỳ chỉnh để 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 các thuộc tính tùy chỉnh phải đáp ứng các yêu cầu sau: không đứng đầu hoặc cuối, không có dấu gạch dưới hàng đầu ( _ ) nhân vật, và thời gian 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

Lưu ý: sản phẩm căn cứ hỏa lực này không có sẵn trên hệ điều hành MacOS, Mac Catalyst, mục tiêu watchos.
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

Lưu ý: sản phẩm căn cứ hỏa lực này không có sẵn trên hệ điều hành MacOS, Mac Catalyst, mục tiêu watchos.
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

Để tìm hiểu cách số liệu chính của bạn đang có xu hướng, thêm chúng vào bảng số liệu của bạn ở phía trên cùng của bảng điều khiển hiệu suất. 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 của bảng chỉ số trong trang tổng quan Giám sát hiệu suất Firebase

Để thêm một thước đo để hội đồng quản trị số liệu của bạn, đi đến bảng điều khiển hiệu suất trong căn cứ hỏa lực điều khiển, sau đó nhấp vào tab Bảng điều khiển. Nhấp vào thẻ số liệu trống, sau đó chọn số liệu hiện có để thêm vào bảng của bạn. Nhấn trên thẻ số liệu dân cư cho các tùy chọn hơn, như để thay thế hoặc loại bỏ một thước đo.

Bảng chỉ số 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 bảng điều khiển .

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

Để xem dấu vết của bạn, đi đến bảng điều khiển hiệu suất trong căn cứ hỏa lực điều khiển, di chuyển xuống bảng dấu vết, sau đó nhấp vào tab phụ thích hợp. Bảng hiển thị một số chỉ số hàng đầu cho mỗi dấu vết và bạn thậm chí có thể sắp xếp danh sách theo tỷ lệ phần trăm thay đổi cho một số liệu cụ thể.

Nếu bạn nhấp vào tên dấu vết trong bảng dấu vết, sau đó 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 bộ lọc nút (trên cùng bên trái của màn hình) để lọc dữ liệu bằng 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 App để xem dữ liệu về một thông cáo trong quá khứ hay phiên bản mới nhất của bạn
  • Lọc theo thiết bị để học cách xử lý các thiết bị cũ ứ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ề xem dữ liệu cho các dấu vết của bạn .

Bước tiếp theo

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