Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Swift

// 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

// 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

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

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

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

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

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

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

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