ข้อขัดข้องและข้อยกเว้น - iOS SDK

เอกสารนี้แสดงภาพรวมระดับสูงเกี่ยวกับการวัดข้อขัดข้องและข้อยกเว้นโดยใช้ Google Analytics SDK สำหรับ iOS v3

ภาพรวม

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

ชื่อช่อง	ฟิลด์เครื่องมือติดตาม	ประเภท	จำเป็น	คำอธิบาย
คำอธิบาย	kGAIExDescription	NSString	ไม่ได้	คำอธิบายข้อยกเว้น (สูงสุด 100 อักขระ) ยอมรับ nil
isFatal	kGAIExFatal	BOOL	ได้	ระบุว่าข้อยกเว้นนี้เป็นข้อยกเว้นที่ร้ายแรงหรือไม่ YES หมายถึงอันตรายถึงชีวิต

ข้อมูลข้อขัดข้องและข้อยกเว้นจะอยู่ในรายงานการขัดข้องและข้อยกเว้นเป็นหลัก

ข้อยกเว้นที่จับได้

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

วัดข้อยกเว้นที่พบโดยการตั้งค่าช่องข้อยกเว้นในตัวติดตามและส่ง Hit ตามตัวอย่างนี้

/*
 * An app tries to load a list of high scores from the cloud. If the request
 * times out, an exception is sent to Google Analytics
 */
@try {

  // Request some scores from the network.
  NSArray *highScores = [self getHighScoresFromCloud];

}
@catch (NSException *exception) {

    // May return nil if a tracker has not already been initialized with a
    // property ID.
    id tracker = [[GAI sharedInstance] defaultTracker];

    [tracker send:[[GAIDictionaryBuilder
        createExceptionWithDescription:@"Connection timeout"  // Exception description. May be truncated to 100 chars.
                             withFatal:@NO] build]];  // isFatal (required). NO indicates non-fatal exception.
}

การวัดข้อยกเว้นที่ตรวจไม่พบ

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

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  [[GAI sharedInstance] setTrackUncaughtExceptions:YES];
  return YES;
}

เมื่อใช้การวัดข้อยกเว้นอัตโนมัติ โปรดคํานึงถึงสิ่งต่อไปนี้

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