วิเคราะห์ปัญหาจาก Firebase Crashlytics และ Android Vitals ด้วยข้อมูลเชิงลึกเกี่ยวกับคุณภาพแอป

คุณสามารถดูและดําเนินการกับข้อมูลข้อขัดข้องของแอปจาก Firebase Crashlytics และ Android Vitals ได้โดยตรงใน Android Studio การผสานรวมนี้จะดึงข้อมูลสแต็กเทรซและสถิติข้อขัดข้องจาก Crashlytics และ Google Play ไปยังหน้าต่างเครื่องมือ App Quality Insights ใน Studio IDE คุณจึงไม่ต้องสลับไปมาระหว่างเบราว์เซอร์กับ IDE ทีมพัฒนาซอฟต์แวร์จะได้รับประโยชน์จากความสามารถหลักๆ ต่อไปนี้

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

รายงาน Android Vitals พร้อมให้บริการสำหรับแอปทั้งหมดที่เผยแพร่ใน Google Play หากยังไม่ได้ใช้ Crashlytics และต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับข้อเสนอของ Crashlytics โปรดดูFirebase Crashlytics

เริ่มต้นใช้งาน

หากต้องการดูข้อมูล Crashlytics ใน Android Studio คุณต้องตั้งค่า Firebase และ Crashlytics ในโปรเจ็กต์แอป โดยเปิด Firebase Assistant ใน Android Studio โดยไปที่เครื่องมือ > Firebase คลิก Crashlytics แล้วทําตามบทแนะนําเพื่อเพิ่ม Firebase และ Crashlytics ลงในโปรเจ็กต์ คุณสามารถอ่านข้อมูลเพิ่มเติมเกี่ยวกับเวิร์กโฟลว์ของ Firebase Assistant ได้ในคู่มือเริ่มต้นใช้งาน Firebase สําหรับ Android

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

วิเคราะห์ Android Vitals

ข้อมูลเชิงลึกเกี่ยวกับคุณภาพของแอปประกอบด้วยข้อมูล Android Vitals ซึ่งจะช่วยให้คุณเข้าถึงเมตริกหลักที่ Google Play รวบรวมได้ง่ายขึ้นและปรับปรุงประสบการณ์ของผู้ใช้ ใช้ Android Vitals เพื่อแก้ไขปัญหาที่เกี่ยวข้องกับความเสถียรของแอปเพื่อช่วยปรับปรุงคุณภาพของแอปใน Google Play

ข้อมูล Android Vitals ใน Android Studio

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

  1. ลงชื่อเข้าใช้บัญชีนักพัฒนาแอปใน Android Studio โดยใช้ไอคอนโปรไฟล์ ที่ท้ายแถบเครื่องมือ
  2. เปิดข้อมูลเชิงลึกเกี่ยวกับคุณภาพของแอปโดยคลิกหน้าต่างเครื่องมือใน Android Studio หรือคลิกดู > หน้าต่างเครื่องมือ > ข้อมูลเชิงลึกเกี่ยวกับคุณภาพของแอป
  3. คลิกแท็บ Android Vitals ภายในข้อมูลเชิงลึกเกี่ยวกับคุณภาพของแอป
  4. ไม่บังคับ: หากต้องการใช้การผสานรวมการควบคุมเวอร์ชันสําหรับบิลด์ที่แก้ไขข้อบกพร่องได้ ให้เพิ่ม Firebase Crashlytics SDK (หรือ Firebase Android Bill of Materials) เวอร์ชันล่าสุดลงในแอป จากนั้นเพิ่มโค้ดต่อไปนี้ลงในไฟล์ build.gradle.kts หรือ build.gradle ระดับโมดูล บิลด์รุ่น (แก้ไขข้อบกพร่องไม่ได้) จะเปิดใช้ Flag นี้โดยค่าเริ่มต้น

Kotlin

android {
  buildTypes {
    getByName("debug") {
      vcsInfo {
        include = true
      }
    }
  }
}

Groovy

android {
  buildTypes {
    debug {
      vcsInfo {
        include true
      }
    }
  }
}

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

หน้าต่างเครื่องมือข้อมูลเชิงลึกเกี่ยวกับคุณภาพของแอป

  1. ใช้เมนูแบบเลื่อนลงของรหัสแอปพลิเคชันเพื่อเลือกรหัสแอปที่ต้องการวิเคราะห์ เช่น แม้ว่าคุณจะทํางานกับแอปเวอร์ชันแก้ไขข้อบกพร่องใน IDE แต่คุณอาจต้องการดูข้อมูลเหตุการณ์สําหรับแอปเวอร์ชันที่ใช้งานจริงซึ่งผู้ใช้ติดตั้ง
  2. แผงปัญหาจะแสดงเหตุการณ์ยอดนิยมที่ Crashlytics มีข้อมูล และจัดเรียงตามข้อขัดข้องที่มีผลกระทบมากที่สุด
  3. ดูเหตุการณ์ตามตัวแปรหรือกลุ่มเหตุการณ์ที่มีสแต็กเทรซคล้ายกัน การวิเคราะห์เหตุการณ์ตามตัวแปรช่วยให้คุณระบุสาเหตุของข้อขัดข้องได้
  4. แท็บสแต็กเทรซจะแสดงรายละเอียดเกี่ยวกับการเกิดเหตุการณ์ล่าสุดที่คุณคลิกในแผงปัญหา คุณสามารถดูสแต็กเทรซของเหตุการณ์และคลิกสแต็กเทรซเพื่อไปยังบรรทัดที่เกี่ยวข้องในโค้ดเบส หากโค้ดมีการเปลี่ยนแปลงนับตั้งแต่เกิดข้อขัดข้อง ให้คลิกแสดงความแตกต่างข้างข้อผิดพลาดในสแต็กเทรซเพื่อดูความแตกต่างระหว่างโค้ดปัจจุบันกับเวอร์ชันของโค้ดเบสที่ทำให้เกิดข้อขัดข้อง

    ตัวเลือกในการแสดงความแตกต่างในสแต็กเทรซ AQI

    นอกจากนี้ยังมีข้อมูลเกี่ยวกับประเภทอุปกรณ์ที่ได้รับผลกระทบ, เวอร์ชัน Android และเวลาที่เกิดเหตุการณ์ รวมถึงลิงก์ไปยังเหตุการณ์ในหน้าแดชบอร์ด Firebase Crashlytics หากต้องการเรียกดูข้อมูลของเหตุการณ์หลายรายการในกลุ่ม ให้ใช้ลูกศรซ้ายและขวา คลิกปิดปัญหาเพื่อปิดปัญหาจากแผงโดยตรง

  5. แท็บคีย์และบันทึกจะแสดงคู่คีย์-ค่าที่กำหนดเองและบันทึกสำหรับรายงาน Crashlytics แต่ละฉบับ
  6. แผงรายละเอียดจะแจกแจงจำนวนข้อขัดข้องตามประเภทอุปกรณ์และเวอร์ชัน Android เพื่อให้คุณระบุกลุ่มผู้ใช้ที่ได้รับผลกระทบมากที่สุดได้ รวมถึงแสดงเวอร์ชันแอปที่พบข้อขัดข้องและจํานวนผู้ใช้ที่ได้รับผลกระทบ
  7. อ่านและแนบหมายเหตุไปกับปัญหาเพื่อให้ปรากฏในคอนโซล Firebase และเพื่อนร่วมทีม หากต้องการเขียนโน้ตเกี่ยวกับปัญหา ให้เลือกปัญหาแล้วเปิดแผงโน้ต คุณต้องมีสิทธิ์เขียนในโปรเจ็กต์ Crashlytics จึงจะเขียนหมายเหตุได้ ปัญหาเกี่ยวกับโน้ตจะปรากฏขึ้นพร้อมไอคอน "โน้ต" ในแผงปัญหา
    แผงหมายเหตุข้อมูลเชิงลึกเกี่ยวกับคุณภาพของแอป
  8. ใช้ตัวกรองที่หลากหลายเพื่อเจาะลึกเหตุการณ์ชุดย่อยบางรายการ คุณสามารถเลือกหรือยกเลิกการเลือกเหตุการณ์ที่เป็นข้อขัดข้องร้ายแรง ข้อขัดข้องที่ไม่ร้ายแรง และ ANR รวมถึงกรองตามเวลา เวอร์ชันแอป สัญญาณ Crashlytics ยี่ห้อและรุ่นอุปกรณ์ และเวอร์ชันแพลตฟอร์ม Android โปรดทราบว่าสำหรับสถานะสัญญาณของ Crashlytics ระบบจะถือว่าปัญหากลับมาเกิดขึ้นอีกเมื่อปัญหานั้นปิดไปแล้วในอดีตและเกิดขึ้นอีกครั้งในแอปเวอร์ชันใหม่

นอกจากการไปยังส่วนต่างๆ จากสแต็กเทรซไปยังโค้ดแล้ว คุณยังกระโดดจากโค้ดไปยังสแต็กเทรซได้ด้วย ตอนนี้ Android Studio จะกำกับเนื้อหาบรรทัดโค้ดที่เกี่ยวข้องกับข้อขัดข้องด้วยไอคอนกล่องพักข้อขัดข้อง เพื่อให้คุณสังเกตและแก้ไขข้อบกพร่องได้ง่ายๆ

เมื่อวางเมาส์เหนือไอคอนข้อขัดข้อง ป๊อปอัปจะปรากฏขึ้นเพื่อแสดงจํานวนเหตุการณ์ที่เกี่ยวข้องกับโค้ดบรรทัดนั้นและความถี่ของเหตุการณ์

สรุปเหตุการณ์เมื่อคุณวางเมาส์เหนือไอคอนข้อขัดข้อง

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

รายการเหตุการณ์เมื่อคุณคลิกไอคอนข้อขัดข้อง

ตัวเลขที่แตกต่างกันระหว่าง Android Vitals กับ Crashlytics

โปรดทราบว่า Android Vitals และ Crashlytics อาจรายงานค่าที่แตกต่างกันสำหรับจํานวนผู้ใช้และเหตุการณ์ที่เชื่อมโยงกับการขัดข้องเดียวกัน ความคลาดเคลื่อนเหล่านี้เกิดขึ้นเนื่องจาก Play และ Crashlytics สามารถตรวจพบข้อขัดข้องในเวลาที่ต่างกันและสำหรับผู้ใช้คนละราย สาเหตุที่จำนวนของ Play และ Crashlytics อาจแตกต่างกันมีดังนี้

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

ตรวจสอบด้วยฟังก์ชันการทำงานที่จำกัดเมื่อออฟไลน์

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

ข้อมูลเชิงลึกเกี่ยวกับคุณภาพของแอปมีโหมดออฟไลน์

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