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

เพิ่มการตรวจสอบที่กำหนดเองสำหรับรหัสแอปเฉพาะ

การตรวจสอบประสิทธิภาพร่องรอยเก็บรวบรวมเพื่อช่วยให้คุณตรวจสอบประสิทธิภาพของแอปของคุณ การติดตามคือรายงานข้อมูลประสิทธิภาพที่บันทึกระหว่างช่วงเวลาสองจุดในแอปของคุณ

คุณสามารถสร้างการติดตามของคุณเองเพื่อตรวจสอบข้อมูลประสิทธิภาพที่เกี่ยวข้องกับโค้ดเฉพาะในแอปของคุณ ด้วยร่องรอยรหัสที่กำหนดเองคุณสามารถวัดใช้เวลานานเท่าใดแอปของคุณเพื่อให้งานที่เฉพาะเจาะจงหรือชุดของงานเช่นการโหลดชุดของภาพหรือสอบถามฐานข้อมูลของคุณ

เริ่มต้นตัวชี้วัดสำหรับการติดตามรหัสที่กำหนดเองคือ "ระยะเวลา" มัน (เวลาระหว่างจุดเริ่มต้นและหยุดของการตรวจสอบ) แต่คุณสามารถเพิ่มตัวชี้วัดที่กำหนดเองเช่นเดียว

ในโค้ดของคุณ คุณกำหนดจุดเริ่มต้นและจุดสิ้นสุดของการติดตามโค้ดที่กำหนดเองโดยใช้ API ที่จัดเตรียมโดย Performance Monitoring SDKร่องรอยรหัสที่กำหนดเองสามารถเริ่มต้นได้ตลอดเวลาหลังจากที่พวกเขาได้รับการสร้างขึ้นและพวกเขาจะปลอดภัยด้าย

เนื่องจากเมตริกเริ่มต้นที่รวบรวมสำหรับการติดตามเหล่านี้คือ "duration" บางครั้งจึงเรียกว่า "Duration traces"

คุณสามารถดูข้อมูลจากร่องรอยเหล่านี้ในร่องรอยที่กำหนดเองแท็บย่อยของตารางร่องรอยซึ่งอยู่ที่ด้านล่างของแผงควบคุมการปฏิบัติงาน (การเรียนรู้เพิ่มเติมเกี่ยวกับการ ใช้คอนโซล ในภายหลังหน้านี้)

แอตทริบิวต์เริ่มต้น แอตทริบิวต์ที่กำหนดเอง และเมตริกที่กำหนดเอง

สำหรับร่องรอยรหัสที่กำหนดเอง, การตรวจสอบประสิทธิภาพโดยอัตโนมัติ คุณลักษณะเริ่มต้น (เมตาดาต้าที่เหมือนกันเช่นรุ่น app ประเทศอุปกรณ์อื่น ๆ ) เพื่อให้คุณสามารถกรองข้อมูลสำหรับการติดตามในคอนโซล Firebase นอกจากนี้คุณยังสามารถเพิ่มและจอภาพ แอตทริบิวต์ที่กำหนดเอง (เช่นระดับของเกมหรือผู้ใช้คุณสมบัติ)

นอกจากนี้คุณยังสามารถกำหนดค่าการติดตามรหัสที่กำหนดเองเพื่อบันทึก ตัวชี้วัดที่กำหนดเอง สำหรับการจัดกิจกรรมที่เกี่ยวข้องกับประสิทธิภาพที่เกิดขึ้นภายในขอบเขตร่องรอยของ ตัวอย่างเช่น คุณสามารถสร้างเมตริกที่กำหนดเองสำหรับจำนวนแคชที่เข้าชมและพลาด หรือจำนวนครั้งที่ UI ไม่ตอบสนองในช่วงเวลาที่เห็นได้ชัดเจน

แอตทริบิวต์ที่กำหนดเองและเมตริกที่กำหนดเองจะแสดงในคอนโซล Firebase ควบคู่ไปกับแอตทริบิวต์เริ่มต้นและเมตริกเริ่มต้นสำหรับการติดตาม

เพิ่มการติดตามโค้ดที่กำหนดเอง

ใช้ผลการดำเนินงานการตรวจสอบติดตาม API ( สวิฟท์ | Obj-C ) เพื่อเพิ่มร่องรอยรหัสที่กำหนดเองในการตรวจสอบรหัสโปรแกรมที่เฉพาะเจาะจง

สังเกตสิ่งต่อไปนี้:

  • แอปสามารถมีการติดตามโค้ดที่กำหนดเองได้หลายรายการ
  • สามารถเรียกใช้การติดตามโค้ดที่กำหนดเองได้มากกว่าหนึ่งรายการพร้อมกัน
  • ชื่อร่องรอยรหัสที่กำหนดเองจะต้องตอบสนองความต้องการต่อไปนี้: ไม่มีนำหน้าหรือต่อท้ายช่องว่างไม่มีขีดชั้นนำ ( _ ) ตัวอักษรและความยาวสูงสุดคือ 100 ตัวอักษร
  • ร่องรอยรหัสที่กำหนดเองสนับสนุนการเพิ่ม ตัวชี้วัดที่กำหนดเอง และ แอตทริบิวต์ที่กำหนดเอง

ในการเริ่มและหยุดการติดตามโค้ดแบบกำหนดเอง ให้รวมโค้ดที่คุณต้องการติดตามด้วยบรรทัดโค้ดที่คล้ายกับต่อไปนี้:

Swift

หมายเหตุ: สินค้า Firebase นี้ไม่สามารถใช้ได้กับ MacOS, Mac Catalyst เป้าหมาย 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()

วัตถุประสงค์-C

หมายเหตุ: สินค้า Firebase นี้ไม่สามารถใช้ได้กับ MacOS, Mac Catalyst เป้าหมาย 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];

เพิ่มเมตริกที่กำหนดเองลงในการติดตามโค้ดที่กำหนดเอง

ใช้ผลการดำเนินงานการตรวจสอบติดตาม API ( สวิฟท์ | Obj-C ) เพื่อเพิ่มตัวชี้วัดที่กำหนดเองเพื่อร่องรอยรหัสที่กำหนดเอง

สังเกตสิ่งต่อไปนี้:

  • ชื่อตัวชี้วัดที่กำหนดเองจะต้องตอบสนองความต้องการต่อไปนี้: ไม่มีนำหน้าหรือต่อท้ายช่องว่างไม่มีขีดชั้นนำ ( _ ) ตัวอักษรและความยาวสูงสุดคือ 100 ตัวอักษร
  • แต่ละร่องรอยรหัสที่กำหนดเองสามารถบันทึกได้ถึง 32 ตัวชี้วัด (รวมทั้งตัวชี้วัดค่าเริ่มต้นระยะเวลา)

หากต้องการเพิ่มเมตริกที่กำหนดเอง ให้เพิ่มบรรทัดโค้ดที่คล้ายกับต่อไปนี้ทุกครั้งที่เกิดเหตุการณ์ ตัวอย่างเช่น ตัววัดที่กำหนดเองนี้จะนับเหตุการณ์ที่เกี่ยวข้องกับประสิทธิภาพที่เกิดขึ้นในแอปของคุณ เช่น การเรียกใช้แคชหรือการลองใหม่

Swift

หมายเหตุ: สินค้า Firebase นี้ไม่สามารถใช้ได้กับ MacOS, Mac Catalyst เป้าหมาย 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()

วัตถุประสงค์-C

หมายเหตุ: สินค้า Firebase นี้ไม่สามารถใช้ได้กับ MacOS, Mac Catalyst เป้าหมาย 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];

สร้างแอตทริบิวต์ที่กำหนดเองสำหรับการติดตามโค้ดที่กำหนดเอง

ใช้ผลการดำเนินงานการตรวจสอบติดตาม API ( สวิฟท์ | Obj-C ) เพื่อเพิ่มแอตทริบิวต์ที่กำหนดเองเพื่อร่องรอยรหัสที่กำหนดเอง

หากต้องการใช้แอตทริบิวต์ที่กำหนดเอง ให้เพิ่มโค้ดลงในแอปที่กำหนดแอตทริบิวต์และเชื่อมโยงกับการติดตามโค้ดที่กำหนดเองโดยเฉพาะ คุณสามารถตั้งค่าแอตทริบิวต์แบบกำหนดเองได้ตลอดเวลาระหว่างเวลาที่การติดตามเริ่มต้นและเมื่อการติดตามหยุดลง

สังเกตสิ่งต่อไปนี้:

  • ชื่อแอตทริบิวต์ที่กำหนดเองจะต้องตอบสนองความต้องการต่อไปนี้: ไม่มีนำหน้าหรือต่อท้ายช่องว่างไม่มีขีดชั้นนำ ( _ ) ตัวอักษรและความยาวสูงสุดคือ 32 ตัวอักษร

  • การติดตามโค้ดที่กำหนดเองแต่ละรายการสามารถบันทึกแอตทริบิวต์ที่กำหนดเองได้สูงสุด 5 รายการ

  • คุณไม่ควรใช้แอตทริบิวต์ที่กำหนดเองซึ่งมีข้อมูลที่ระบุตัวบุคคลต่อ Google

    เรียนรู้เพิ่มเติมเกี่ยวกับแนวทางปฏิบัตินี้

Swift

หมายเหตุ: สินค้า Firebase นี้ไม่สามารถใช้ได้กับ MacOS, Mac Catalyst เป้าหมาย 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;

วัตถุประสงค์-C

หมายเหตุ: สินค้า Firebase นี้ไม่สามารถใช้ได้กับ MacOS, Mac Catalyst เป้าหมาย 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];

ติดตาม ดู และกรองข้อมูลประสิทธิภาพ

ติดตามตัวชี้วัดเฉพาะในแดชบอร์ดของคุณ

ต้องการเรียนรู้วิธีชี้วัดที่สำคัญของคุณมีแนวโน้มเพิ่มพวกเขาไปยังคณะกรรมการชี้วัดของคุณที่ด้านบนของแผงควบคุมการปฏิบัติงานที่ คุณสามารถระบุการถดถอยได้อย่างรวดเร็วโดยดูการเปลี่ยนแปลงแบบสัปดาห์ต่อสัปดาห์ หรือตรวจสอบว่าการเปลี่ยนแปลงล่าสุดในโค้ดของคุณกำลังปรับปรุงประสิทธิภาพ

รูปภาพของบอร์ดเมตริกในแดชบอร์ดการตรวจสอบประสิทธิภาพของ Firebase

หากต้องการเพิ่มตัวชี้วัดไปยังคณะกรรมการชี้วัดของคุณไปที่ แผงควบคุมการปฏิบัติงาน ใน Firebase คอนโซลจากนั้นคลิกที่แท็บแดชบอร์ด คลิกการ์ดตัวชี้วัดที่ว่างเปล่า จากนั้นเลือกตัวชี้วัดที่มีอยู่เพื่อเพิ่มลงในกระดานของคุณ คลิก ในการ์ดตัวชี้วัดที่มีประชากรสำหรับตัวเลือกมากขึ้นเช่นการที่จะเปลี่ยนหรือลบเมตริก

กระดานเมตริกจะแสดงข้อมูลเมตริกที่เก็บรวบรวมในช่วงเวลาต่างๆ ทั้งในรูปแบบกราฟิกและการเปลี่ยนแปลงเป็นเปอร์เซ็นต์ที่เป็นตัวเลข

เรียนรู้เพิ่มเติมเกี่ยวกับการ ใช้แดชบอร์ด

ดูร่องรอยและข้อมูลของพวกเขา

เพื่อดูร่องรอยของคุณไปที่ แผงควบคุมการปฏิบัติงาน ใน Firebase คอนโซลเลื่อนลงไปที่โต๊ะร่องรอยจากนั้นคลิกที่แท็บย่อยที่เหมาะสม ตารางจะแสดงเมตริกระดับบนสุดบางรายการสำหรับแต่ละการติดตาม และคุณยังสามารถจัดเรียงรายการตามเปอร์เซ็นต์การเปลี่ยนแปลงสำหรับเมตริกเฉพาะได้อีกด้วย

หากคุณคลิกชื่อการติดตามในตารางการติดตาม คุณจะสามารถคลิกผ่านหน้าจอต่างๆ เพื่อสำรวจการติดตามและเจาะลึกลงไปในเมตริกที่สนใจได้ บนหน้าเว็บมากที่สุดคุณสามารถใช้ตัวกรอง ปุ่ม (ซ้ายของหน้าจอ) ในการกรองข้อมูลโดยแอตทริบิวต์ตัวอย่างเช่น:

รูปภาพของข้อมูลการตรวจสอบประสิทธิภาพ Firebase ถูกกรองตามแอตทริบิวต์
  • กรองตามรุ่น App เพื่อดูข้อมูลเกี่ยวกับการเปิดตัวอดีตหรือรุ่นล่าสุดของคุณ
  • กรองตามอุปกรณ์เพื่อเรียนรู้วิธีจัดการกับอุปกรณ์รุ่นเก่าของแอป
  • กรองตามประเทศเพื่อให้แน่ใจว่าสถานที่ตั้งของฐานข้อมูลของคุณจะไม่ส่งผลกระทบต่อภูมิภาคที่เฉพาะเจาะจง

เรียนรู้เพิ่มเติมเกี่ยวกับการ ดูข้อมูลสำหรับร่องรอยของคุณ

ขั้นตอนถัดไป

  • ดูรายงานรายละเอียดของ เซสชันของผู้ใช้ ในที่ที่คุณสามารถดูร่องรอยที่เฉพาะเจาะจงในบริบทที่ระยะเวลาของร่องรอยอื่น ๆ ที่รวบรวมในช่วงเดียวกัน