เอกสารนี้แสดงภาพรวมระดับสูงของการวัดผลข้อขัดข้องและข้อยกเว้นโดยใช้ Google Analytics SDK สำหรับ Android v3
ภาพรวม
การวัดการขัดข้องและข้อยกเว้นช่วยให้คุณวัดจำนวนและประเภทของการขัดข้องที่เจอและไม่พบ รวมถึงข้อยกเว้นที่เกิดขึ้นในแอป โดยข้อยกเว้นจะมีช่องต่อไปนี้
ชื่อช่อง | ฟิลด์เครื่องมือติดตาม | ประเภท | จำเป็น | คำอธิบาย |
---|---|---|---|---|
คำอธิบาย |
|
|
ไม่ได้ | คำอธิบายข้อยกเว้น (สูงสุด 100 อักขระ) ยอมรับ
null
|
isFatal |
|
boolean
|
ได้ | ระบุว่าข้อยกเว้นนี้เป็นข้อยกเว้นที่ร้ายแรงหรือไม่
true หมายถึงอันตรายถึงชีวิต |
ข้อมูลข้อขัดข้องและข้อยกเว้นจะอยู่ในรายงานการขัดข้องและข้อยกเว้นเป็นหลัก
ข้อยกเว้นที่จับได้
ข้อยกเว้นที่พบคือข้อผิดพลาดในแอปที่คุณได้กำหนดโค้ดการจัดการข้อยกเว้น เช่น การหมดเวลาของการเชื่อมต่อเครือข่ายเป็นบางครั้งในระหว่างการขอข้อมูล
วัดข้อยกเว้นที่พบโดยการตั้งค่าช่องข้อยกเว้นในตัวติดตามและส่ง 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. ArrayListhighScores = getHighScoresFromCloud(); } catch (IOException e) { // May return null if EasyTracker has not yet been initialized with a // property ID. EasyTracker easyTracker = EasyTracker.getInstance(this); // StandardExceptionParser is provided to help get meaningful Exception descriptions. easyTracker.send(MapBuilder .createException(new StandardExceptionParser(this, null) // Context and optional collection of package names // to be used in reporting the exception. .getDescription(Thread.currentThread().getName(), // The name of the thread on which the exception occurred. e), // The exception. false) // False indicates a nonfatal exception .build() ); ... // Display alert to user that high scores are currently unavailable. }
การวัดข้อยกเว้นที่ตรวจไม่พบ
ข้อยกเว้นที่ตรวจไม่พบจะแสดงถึงกรณีที่แอปพบสภาวะที่ไม่คาดคิดระหว่างรันไทม์และมักเป็นอันตรายถึงชีวิตซึ่งทำให้แอปขัดข้อง
ระบบจะส่งข้อยกเว้นที่ตรวจไม่พบไปยัง Google Analytics โดยอัตโนมัติโดยใช้ EasyTracker หรือคลาส ExceptionReporter
การใช้ EasyTracker
หากต้องการส่งข้อยกเว้นที่ตรวจไม่พบทั้งหมดในแอปโดยอัตโนมัติโดยใช้ EasyTracker
เพิ่มบรรทัดนี้ในไฟล์ analytics.xml
ของคุณ:
<bool name="ga_reportUncaughtExceptions">true</bool>
หลังส่งข้อยกเว้นโดยใช้การวัดข้อยกเว้นอัตโนมัติแล้ว EasyTracker จะส่งข้อยกเว้นไปยังเครื่องจัดการข้อยกเว้นเริ่มต้นของ Thread
การใช้งานขั้นสูง
ใช้คลาส ExceptionReporter
เพื่อติดตั้งใช้งานการวัดข้อยกเว้นที่ตรวจไม่พบโดยอัตโนมัติหากคุณใช้การติดตั้งใช้งานขั้นสูงและไม่ได้ใช้ EasyTracker
ExceptionReporter
ทำหน้าที่เป็นเครื่องจัดการข้อยกเว้นเริ่มต้นที่ยังไม่ตรวจพบสำหรับเทรดที่เจาะจงหรือเทรดทั้งหมดในแอป หลังจากส่งข้อยกเว้นไปยัง Google Analytics แล้ว คลาส ExceptionReporter
อาจส่งต่อข้อยกเว้นไปยังเครื่องจัดการข้อยกเว้นที่ตรวจไม่พบซึ่งคุณให้มา (ไม่บังคับ)
โค้ดต่อไปนี้จะสร้างออบเจ็กต์ ExceptionReporter
ใหม่และตั้งค่าเป็นเครื่องจัดการข้อยกเว้นที่ไม่ถูกตรวจจับเริ่มต้นใหม่ ดังนั้น ระบบจะส่งข้อยกเว้นทั้งหมดที่ตรวจไม่พบไปยัง Google Analytics แล้วส่งต่อไปยังเครื่องจัดการข้อยกเว้นที่ตรวจไม่พบก่อนหน้านี้ สำหรับแอปพลิเคชันส่วนใหญ่ ตัวแฮนเดิลเริ่มต้นจะบันทึกข้อยกเว้นในบันทึกและยุติแอปพลิเคชัน
UncaughtExceptionHandler myHandler = new ExceptionReporter( GoogleAnalytics.getInstance(this).getDefaultTracker(), // Tracker, may return null if not yet initialized. GAServiceManager.getInstance(), // GAServiceManager singleton. Thread.getDefaultUncaughtExceptionHandler()); // Current default uncaught exception handler. // Make myHandler the new default uncaught exception handler. Thread.setDefaultUncaughtExceptionHandler(myHandler);
เมื่อใช้การวัดข้อยกเว้นอัตโนมัติ โปรดคํานึงถึงสิ่งต่อไปนี้
- ข้อยกเว้นทั้งหมดที่ส่งโดยใช้การวัดข้อยกเว้นอัตโนมัติจะรายงานเป็นข้อผิดพลาดร้ายแรงใน Google Analytics
- โดยค่าเริ่มต้น ระบบจะตั้งค่าช่องคำอธิบายโดยอัตโนมัติโดยใช้ประเภทข้อยกเว้น ชื่อคลาส ชื่อเมธอด และชื่อชุดข้อความ
คำอธิบายข้อยกเว้นของการแยกวิเคราะห์
SDK นี้มอบ StandardExceptionParser
เพื่อช่วยให้ขั้นตอนการรับและส่งคำอธิบายข้อยกเว้นไปยัง Google Analytics ง่ายขึ้น
// Using StandardExceptionParser to get an Exception description. try { // Request some scores from the network. ArrayListhighScores = getHighScoresFromCloud(); } catch (IOException e) { // May return null if EasyTracker has not yet been initialized with a // property ID. EasyTracker easyTracker = EasyTracker.getInstance(this); easyTracker.send(MapBuilder .createException(new StandardExceptionParser(this, null) // Context and optional collection of package names // to be used in reporting the exception. .getDescription(Thread.currentThread().getName(), // The name of the thread on which the exception occurred. e), // The exception. false) // False indicates a fatal exception .build() ); ... // Display alert to user that high scores are currently unavailable. }
คุณยังใช้โปรแกรมแยกวิเคราะห์ของตนเองโดยการใช้อินเทอร์เฟซ ExceptionParser
และเรียกเมธอด setDescription
ของตัวแยกวิเคราะห์นั้นเมื่อส่งข้อยกเว้นไปยัง Google Analytics ได้ด้วย