เอกสารนี้แสดงภาพรวมระดับสูงของการวัดข้อขัดข้องและข้อยกเว้นโดยใช้ Google Analytics SDK สำหรับ Android เวอร์ชัน 2
ภาพรวม
การวัดการขัดข้องและข้อยกเว้นช่วยให้คุณวัดจำนวนและประเภทของการขัดข้องที่เจอและไม่พบ รวมถึงข้อยกเว้นที่เกิดขึ้นในแอป โดยข้อยกเว้นใน Google Analytics ประกอบด้วย
String
(ไม่บังคับ) คำอธิบาย – คำอธิบายข้อยกเว้น (สูงสุด 100 อักขระ) ยอมรับnull
boolean
isFatal – ระบุว่าข้อยกเว้นร้ายแรงหรือไม่true
หมายถึงอันตรายถึงชีวิต
ข้อมูลข้อขัดข้องและข้อยกเว้นจะอยู่ในรายงานการขัดข้องและข้อยกเว้นเป็นหลัก
ข้อยกเว้นที่จับได้
ข้อยกเว้นที่พบคือข้อผิดพลาดในแอปที่คุณกำหนดโค้ดการจัดการข้อยกเว้น โดยทั่วไปแล้วเป็นข้อผิดพลาดที่คุณคาดว่าจะเกิดขึ้นระหว่างการใช้งานแอปตามปกติ และสิ่งที่คุณต้องการให้แอปกู้คืนได้ เช่น หมดเวลาของการเชื่อมต่อเครือข่ายเป็นครั้งคราวในระหว่างขอข้อมูล
คุณวัดข้อยกเว้นที่ตรวจจับได้โดยการเพิ่ม sendException()
ลงในบล็อก catch
ของโค้ดการจัดการข้อยกเว้น
ในตัวอย่างต่อไปนี้ แอปจะพยายามโหลดรายการคะแนนสูงสุดจากระบบคลาวด์ หากคำขอหมดเวลา ซึ่งอาจเป็นเพราะการเชื่อมต่อเครือข่ายช้า เราจะส่งข้อยกเว้นไปยัง Google Analytics ก่อนที่จะจัดการให้กับผู้ใช้
try { ArrayListhighScores = getHighScores(); // Get scores from the cloud. } catch (IOException e) { Tracker myTracker = EasyTracker.getTracker(); // Get a reference to tracker. myTracker.sendException(e.getMessage(), false); // false indicates non-fatal exception. ... // 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
เมื่อใช้การวัดข้อยกเว้นอัตโนมัติ โปรดคำนึงถึงสิ่งต่อไปนี้
- ข้อยกเว้นทั้งหมดที่ส่งโดยใช้การวัดข้อยกเว้นอัตโนมัติจะรายงานเป็นข้อผิดพลาดร้ายแรงใน Google Analytics
- ระบบจะป้อนข้อมูลในช่องคำอธิบายโดยอัตโนมัติโดยใช้สแต็กเทรซ
การใช้ ExceptionReporter
ใช้คลาส ExceptionReporter
เพื่อติดตั้งใช้งานการวัดข้อยกเว้นที่ตรวจไม่พบโดยอัตโนมัติหากไม่ได้ใช้ EasyTracker ซึ่งเป็นคลาสเดียวกับที่ EasyTracker ใช้เพื่อจัดการการรายงานข้อยกเว้นอัตโนมัติ
ExceptionReporter
ทำหน้าที่เป็นเครื่องจัดการข้อยกเว้นเริ่มต้นที่ยังไม่ตรวจพบสำหรับเทรดที่เจาะจงหรือเทรดทั้งหมดในแอป หลังจากส่งข้อยกเว้นไปยัง Google Analytics แล้ว คลาส ExceptionReporter
อาจส่งต่อข้อยกเว้นไปยังเครื่องจัดการข้อยกเว้นที่ตรวจไม่พบซึ่งคุณให้มา (ไม่บังคับ)
โค้ดต่อไปนี้จะสร้างออบเจ็กต์ ExceptionReporter
ใหม่และตั้งค่าเป็นเครื่องจัดการข้อยกเว้นที่ไม่ถูกตรวจจับเริ่มต้นใหม่ ดังนั้น ระบบจะส่งข้อยกเว้นทั้งหมดที่ตรวจไม่พบไปยัง Google Analytics แล้วส่งต่อไปยังเครื่องจัดการข้อยกเว้นที่ตรวจไม่พบก่อนหน้านี้ สำหรับแอปพลิเคชันส่วนใหญ่ ตัวแฮนเดิลเริ่มต้นจะบันทึกข้อยกเว้นในบันทึกและยุติแอปพลิเคชัน
UncaughtExceptionHandler myHandler = new ExceptionReporter( myTracker, // Currently used Tracker. GAServiceManager.getInstance(), // GAServiceManager singleton. Thread.getDefaultUncaughtExceptionHandler()); // Current default uncaught exception handler. // Make myHandler the new default uncaught exception handler. Thread.setDefaultUncaughtExceptionHandler(myHandler);
การใช้ ExceptionParser
SDK มีอินเทอร์เฟซ ExceptionParser
ที่คุณนำไปใช้เพื่อรับคำอธิบายที่เกี่ยวข้องมากที่สุดจากสแต็กเทรซเมื่อส่งข้อยกเว้นที่ตรวจไม่พบไปยัง Google Analytics ได้ อินเทอร์เฟซ ExceptionParser
มี 1 วิธี ดังนี้ getDescription(String threadName, Throwable t)
คุณสามารถตั้งค่า Tracker
ให้ใช้ ExceptionParser
เมื่อส่งข้อยกเว้นที่ตรวจไม่พบมายัง Google Analytics โดยเรียกใช้ setExceptionParser(ExceptionParser parser)
ตามตัวอย่างต่อไปนี้
// Where myParser represents your implementation of ExceptionParser. ExceptionParser parser = new myParser(context); // Where myTracker is an instance of Tracker. myTracker.setExceptionParser(parser);
จากนั้นเครื่องมือติดตามจะใช้เมธอด getDescription()
ของโปรแกรมแยกวิเคราะห์เพื่อสร้างช่องคำอธิบายของข้อยกเว้นที่ตรวจไม่พบซึ่งส่งไปยัง Google Analytics