วิเคราะห์บันทึกที่ระบบสร้างขึ้นโดยใช้ Application Insights

คุณสามารถเชื่อมต่อแอปพื้นที่ทำงานของคุณกับ Application Insights คุณลักษณะของ Azure Monitor Application Insights มีเครื่องมือวิเคราะห์ที่มีประสิทธิภาพเพื่อช่วยให้คุณวินิจฉัยปัญหา และทำความเข้าใจกับสิ่งที่ผู้ใช้ทำกับแอปของคุณ คุณสามารถรวบรวมข้อมูลเพื่อช่วยในการตัดสินใจทางธุรกิจที่ดีขึ้น และปรับปรุงคุณภาพแอปของคุณ

ในการเริ่มต้นอย่างรวดเร็วนี้ เราใช้แอปพื้นที่ทำงานที่เรียกว่า Kudos เพื่อสำรวจแนวคิดของบันทึกที่ระบบสร้างขึ้นในแอปพื้นที่ทำงาน และนำไปใช้กับแอปของคุณ แอป Kudos ตัวอย่างเป็นส่วนหนึ่งของชุดของแอปการมีส่วนร่วมของพนักงานที่สามารถดาวน์โหลดได้จาก Employee Experience Starter Kit

ข้อกำหนดเบื้องต้น

• คุณต้องมีสิทธิ์เข้าถึง พอร์ทัล Azure
• คุณต้องมีสิทธิ์ในการ สร้างทรัพยากร Azure

ระบุหรือไม่ก็ได้

• ดาวน์โหลดและติดตั้งแอป Kudos จาก Employee Experience Starter Kit คุณสามารถใช้แอปที่มีอยู่แทนได้

สร้างทรัพยากร Application Insights

ก่อนที่คุณจะสามารถส่งบันทึกที่ระบบสร้างขึ้นจากแอป คุณจะต้องสร้างทรัพยากร Application Insights เพื่อจัดเก็บเหตุการณ์

1. ลงชื่อเข้าใช้ พอร์ทัล Azure

2. ค้นหา Application Insights:

   

3. สร้างทรัพยากร Application Insights:

   

4. ป้อนค่าที่เหมาะสมและเลือก ตรวจทาน+สร้าง

   สำหรับรายละเอียดเพิ่มเติม อ่านที่ สร้างทรัพยากร Application Insights

   

5. หลังจากอินสแตนซ์ Application Insights ถูกสร้างแล้ว ให้คัดลอก คีย์เครื่องมือวัด ในภาพรวมของอินสแตนซ์เพื่อใช้ในขั้นตอนต่อไป

   

เชื่อมต่อแอปของคุณกับ Application Insights

1. ลงชื่อเข้าใช้ Power Apps

2. เลือก แอป ในบานหน้าต่างการนำทางด้านซ้าย จากรายการแอป เลือกแอป Kudos จากนั้นเลือก แก้ไข:

   

   หมายเหตุ

   นอกจากนี้คุณยังสามารถ สร้าง แอปใหม่หรือ แก้ไข แอปใดๆ ที่มีอยู่แทน

3. เลือกออบเจ็กต์ แอป ในมุมมองลำดับชั้นการนำทางด้านซ้ายและวาง คีย์การใช้เครื่องมือ:

   

4. บันทึก และ เผยแพร่ แอปของคุณ

5. เล่น แอปที่เผยแพร่ และเรียกดูผ่านหน้าจอต่างๆ

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

• แอปเข้าถึงจากที่ใด
• อุปกรณ์ที่ใช้
• ชนิดของเบราว์เซอร์ที่ใช้

ดูเหตุการณ์ใน Application Insights

1. ลงชื่อเข้าใช้ พอร์ทัล Azure และเปิดทรัพยากร Application Insights ที่คุณสร้าง ก่อนหน้านี้

2. เลื่อนลงในบานหน้าต่างนำทางซ้ายและเลือก ผู้ใช้ ภายใต้ส่วน การใช้

   หมายเหตุ

   มุมมอง ผู้ใช้ แสดงรายละเอียดการใช้งานของแอป เช่น:

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

   เรียนรู้เพิ่มเติมเกี่ยวกับผู้ใช้ เซสชัน และการวิเคราะห์เหตุการณ์ใน Application Insights

3. เลือกหนึ่งในเซสชันผู้ใช้เพื่อดูรายละเอียดเฉพาะ คุณสามารถดูข้อมูล เช่น ความยาวเซสชัน และหน้าจอที่เข้าชม:

   

4. เลือกมุมมอง เหตุการณ์ ในบานหน้าต่างนำทางด้านซ้ายภายใต้ส่วน การใช้ คุณสามารถดูสรุปของหน้าจอทั้งหมดที่ดูผ่านทุกเซสชันของแอป:

   

สร้างเหตุการณ์การติดตามที่กำหนดเอง

คุณสามารถเขียนการติดตามแบบกำหนดเอง Application Insights ได้โดยตรง และเริ่มวิเคราะห์ข้อมูลที่เฉพาะเจาะจงกับสถานการณ์ของคุณ ฟังก์ชัน ติดตาม ช่วยให้คุณเก็บรวบรวม:

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

การติดตามยังสามารถช่วยวินิจฉัยปัญหาได้เนื่องจากคุณสามารถส่งข้อมูลในขณะที่ผู้ใช้เรียกดูแอปของคุณและดำเนินการต่างๆ ข้อความติดตามที่ส่งถึง Application Insights มีความรุนแรงหนึ่งในสาม:

• ข้อมูล
• คำเตือน
• Error

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

ตอนนี้สร้างองค์ประกอบใหม่ในแอปของคุณ เพื่อรวบรวมข้อคิดเห็นในแต่ละหน้าจอ และเขียนเหตุการณ์ไปยัง Application Insights

1. ลงชื่อเข้าใช้ Power Apps

2. เลือก แอป ในบานหน้าต่างการนำทางด้านซ้าย จากรายการแอป เลือกแอป Kudos จากนั้นเลือก แก้ไข

   หมายเหตุ

   นอกจากนี้คุณยังสามารถ สร้าง แอปใหม่ หรือ แก้ไข แอปที่มีอยู่แทน

3. เลือกตัวเลือก ส่วนประกอบ ใน มุมมองลำดับชั้น:

   

4. เลือก องค์ประกอบใหม่ จากนั้นปรับขนาดความกว้างเป็น 200 และความสูงเป็น 75:

   

5. เลือก แทรก จากเมนู จากนั้นเลือก ไอคอน เพื่อเพิ่ม Emoji - หน้าบึ้ง และ Emoji - ยิ้ม:

   

6. เลือก คุณสมบัติแบบกำหนดเองใหม่ เพื่อสร้างคุณสมบัติที่กำหนดเอง:

   

7. ป้อนคุณสมบัติ ชื่อ และ ชื่อที่แสดง เช่น FeedbackSceen

8. ป้อน คำอธิบาย คุณสมบัติ

9. เลือก ประเภทคุณสมบัติ เช่น ข้อมูลป้อนเข้า และ ประเภทข้อมูล เช่น หน้าจอ:

   

   หมายเหตุ

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

10. เลือกองค์ประกอบบน มุมมองแบบทรี เลือก การดำเนินการเพิ่มเติม (…) แล้วเลือก เปลี่ยนชื่อ เพื่อเปลี่ยนชื่อองค์ประกอบด้วยชื่อที่มีความหมายเช่น FeedbackComponent

    

11. เลือกไอคอน เลือก การดำเนินการเพิ่มเติม (…) แล้วเลือก เปลี่ยนชื่อ เพื่อเปลี่ยนชื่อไอคอนด้วยชื่อที่มีความหมายเช่น FrownIcon และ SmileIcon

12. เลือก FrownIcon เลือกคุณสมบัติ OnSelect และจากนั้นป้อนนิพจน์ต่อไปนี้ในแถบสูตร:

    Trace(
       "App Feedback",
       TraceSeverity.Information,
           {
             UserName: User().FullName,
             UserEmail: User().Email,
             Screen: FeedbackComponent.FeedbackScreen.Name,
             FeedbackValue: "-1"
           }
         );
    Notify("Thanks for your feedback!");
    

    

    หมายเหตุ

    นิพจน์สูตรส่ง ชื่อผู้ใช้ อีเมลผู้ใช้ หน้าจอภาพ และ ข้อคิดเห็น (ด้วยค่า -1) ไปยัง Application Insights

13. เลือก SmileIcon เลือกคุณสมบัติ OnSelect และจากนั้นป้อนนิพจน์ต่อไปนี้ในแถบสูตร:

    Trace(
       "App Feedback",
       TraceSeverity.Information,
           {
             UserName: User().FullName,
             UserEmail: User().Email,
             Screen: FeedbackComponent.FeedbackScreen.Name,
             FeebackValue: "1"
           }
         );
    Notify("Thanks for your feedback!");
    

14. เพิ่มส่วนประกอบลงในหน้าจอใดหน้าจอหนึ่งในแอปของคุณ:

    

15. เลือก บันทึก จากนั้นเลือก เผยแพร่ เพื่อบันทึกและเผยแพร่แอปของคุณ

16. เล่นแอปที่เผยแพร่แล้ว และส่งข้อคิดเห็นหน้ายิ้มและหน้าบึ้งจากหน้าจอของคุณ

    ข้อสำคัญ

    คุณต้องเล่นแอปที่เผยแพร่เพื่อส่งเหตุการณ์ไปยัง Application Insights เหตุการณ์จะไม่ถูกส่งไปที่ Application Insights เมื่อคุณดูตัวอย่างแอปใน Power Apps Studio

    

วิเคราะห์ข้อมูลใน Application Insights

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

1. ลงชื่อเข้าใช้ พอร์ทัล Azure และเปิดทรัพยากร Application Insights ที่คุณสร้าง ก่อนหน้านี้:

   

2. เลือก บันทึก ภายใต้ การตรวจสอบ ในบานหน้าต่างนำทางซ้าย:

   

3. ป้อนแบบสอบถามต่อไปนี้ แล้วเลือก รัน หากต้องการดูข้อคิดเห็นที่ได้รับจากแอปของคุณ:

   traces
   | where message == "App Feedback"
   | order by timestamp
   

   

4. เลือกแถวในผลลัพธ์และขยายฟิลด์ customDimensions

   ค่าสำหรับ หน้าจอภาพ ชื่อผู้ใช้ อีเมลผู้ใช้ และ FeedbackValue สำหรับเหตุการณ์ OnSelect ของไอคอนหน้ายิ้มหรือหน้าบึ้งในองค์ประกอบของคุณได้รับการบันทึกแล้ว ค่ายังถูกบันทึกไว้สำหรับแต่ละเหตุการณ์ที่ส่งไปยัง Application Insights เช่น appId appName และ appSessionId

   

5. ด้วยการสอบถามตัวอย่างต่อไปนี้ คุณสามารถขยายคุณสมบัติของมิติที่กำหนดเอง JSON และฉายคอลัมน์ในมุมมองผลลัพธ์

   traces
       | extend customdims = parse_json(customDimensions)
       | where message == "App Feedback"
       | project timestamp
           , message
           , AppName = customdims.['ms-appName']
           , AppId = customdims.['ms-appId']
           , FeedbackFrom = customdims.UserEmail
           , Screen = customdims.Screen
           , FeedbackValue = customdims.FeedbackValue
       | order by timestamp desc
   

   

   เคล็ดลับ

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

ตรวจสอบข้อผิดพลาดที่ไม่สามารถจัดการได้ (ทดลอง)

[ส่วนนี้ประกอบด้วยเอกสารรุ่นก่อนวางจำหน่าย และอาจจะมีการเปลี่ยนแปลงในอนาคต]

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

เปิดใช้งานข้อผิดพลาดในการส่งผ่านไปยัง Application Insights

คุณต้องเปิดใช้งานการตั้งค่าที่อนุญาตให้ Power Apps ส่งข้อผิดพลาดรันไทม์ที่ไม่ได้รักการจัดการไปยัง Azure Application Insights

การเปิดใช้งานข้อผิดพลาดการส่งผ่าน ให้ไปที่ การตั้งค่า > คุณลักษณะที่กำลังจะมาถึง > ทดลอง > ส่งผ่านข้อผิดพลาดไปยัง Azure Application Insights ขณะที่เปิดแอปพื้นที่ทำงานไว้สำหรับการแก้ไข บันทึก และ เผยแพร่ แอปของคุณ

เหตุการณ์ข้อผิดพลาดใน Application Insights

ข้อผิดพลาด Power Fx ที่ไม่ได้รับการจัดการที่ผู้ใช้พบขณะรันไทม์ของแอป จะถูกรายงานไปที่ตาราง การติดตาม ข้อผิดพลาดที่ไม่ได้รับการจัดการสามารถระบุและแยกแยะจากเหตุการณ์ข้อผิดพลาดอื่นๆ ได้ด้วยข้อความเหตุการณ์ "ข้อผิดพลาดที่ไม่ได้รับการจัดการ" มิติข้อมูล "severityLevel" ของเหตุการณ์เหล่านี้คือ 3 (TraceSeverity.Error)

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

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

traces
    | where message == "Unhandled error"
    | extend customdims = parse_json(customDimensions)
    | extend errors = parse_json(tostring(customdims.['errors']))
    | mv-expand errors
    | project timestamp
        , itemId //unique identifier for the trace event
        , AppName = customdims.['ms-appName']
        , AppId = customdims.['ms-appId']
        , errors = errors.['Message']
    | order by timestamp desc

การติดตามความสัมพันธ์ (ทดลอง)

[ส่วนนี้ประกอบด้วยเอกสารรุ่นก่อนวางจำหน่าย และอาจจะมีการเปลี่ยนแปลงในอนาคต]

การเชื่อมต่อกับข้อมูลและบริการภายนอกเป็นพื้นฐานของแอปส่วนใหญ่ การติดตามความสัมพันธ์สร้างและเผยแพร่ข้อมูลบริบทเพื่อรวมบันทึกที่ระบบสร้างขึ้นในแอปพื้นที่ทำงานและการเชื่อมต่อ ขึ้นอยู่กับ ข้อจำกัด บางอย่าง ตัวอย่างเช่น แอปของคุณอาจเรียกใช้ตัวเชื่อมต่อที่กำหนดเองซึ่งจะเรียกใช้ฟังก์ชัน Azure หรือ REST API อื่นๆ การติดตามความสัมพันธ์ช่วยให้คุณเชื่อมโยงการดำเนินการในแอปกับการเรียก API พื้นฐานในระดับต่างๆ สิ่งนี้มีประโยชน์ในการแก้ปัญหา

การติดตามความสัมพันธ์ของแอปพื้นที่ทำงานเป็นการดำเนินการติดตามบริบทและติดตาม ข้อมูลจำเพาะของ W3C

เปิดใช้งานการติดตามความสัมพันธ์

หากต้องการเปิดใช้งานคุณลักษณะการติดตามความสัมพันธ์ ให้ไปที่ การตั้งค่า > คุณสมบัติที่กำลังจะมาถึง > ทดลอง > เปิดใช้งานการติดตามสหสัมพันธ์ Azure Application Insights ขณะที่เปิดแอปพื้นที่ทำงานไว้เพื่อแก้ไข บันทึก และ เผยแพร่ แอปของคุณ

ข้อจำกัด

• การติดตามความสัมพันธ์สามารถใช้ได้กับตัวเชื่อมต่อแบบกำหนดเองเท่านั้น ไม่รองรับตัวเชื่อมต่อชนิดอื่นๆ
• คำขอ HTTP ถูกจับใน Application Insights เฉพาะในกรณีที่บริการที่เชื่อมต่อ ยังเชื่อมต่อกับ Application Insights

การใช้งานการติดตามความสัมพันธ์

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

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

การโทรผ่านเครือข่ายสำหรับตัวเชื่อมต่อที่สนับสนุนสามารถเข้าร่วมกับบันทึกอื่นๆ ที่ระบบสร้างขึ้นในมิติ "operation_Id" การสอบถามตัวอย่างต่อไปนี้แสดงการโทรผ่านเครือข่ายที่เกิดขึ้นพร้อมกับกิจกรรมการติดตาม ที่ปล่อยออกมาระหว่างเซสชันแอป

traces | union dependencies | union requests | union pageViews | union customEvents
| project timestamp
    , itemType
    , name
    , operation_Name
    , message
    , severityLevel
    , customDimensions
    , operation_Id
    , operation_ParentId
| where operation_Id == "0a7729e3e83c4e4d93cb4f51149f73b9" //placeholder operation_Id, replace
| order by timestamp asc

ส่งออกข้อมูลไปยัง Power BI

คุณสามารถส่งออกข้อมูล Application Insights ของคุณและผลลัพธ์การสอบถามไปยัง Power BI สำหรับการวิเคราะห์และการนำเสนอข้อมูล

1. ลงชื่อเข้าใช้ พอร์ทัล Azure และเปิดทรัพยากร Application Insights ที่คุณสร้าง ก่อนหน้านี้:

2. เลือก บันทึก ภายใต้ การตรวจสอบ ในบานหน้าต่างนำทางซ้าย:

3. จากหน้าต่างการสอบถามการวิเคราะห์บันทึก เลือกเมนู ส่งออก

4. เลือกตัวเลือก ส่งออกไปยัง Power BI (การสอบถาม M) เพื่อดาวน์โหลดไฟล์การสอบถาม Power BI:

   

5. เปิดไฟล์ที่ดาวน์โหลดในตัวแก้ไขข้อความและคัดลอกการสอบถามไปยังคลิปบอร์ด

6. เปิด Power BI

7. เลือกเมนู รับข้อมูล ใน Ribbon หน้าแรก แล้วเลือก การสอบถามเปล่า:

   

8. ในหน้าต่างการสอบถาม เลือก ตัวแก้ไขขั้นสูง วางการสอบถามลงในหน้าต่าง เลือก เสร็จสิ้น แล้วเลือก ปิดและนำไปใช้:

   

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

บริบทและมิติเหตุการณ์การติดตามเริ่มต้น

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

สถานการณ์ที่ไม่รองรับ

Application Insights ไม่รองรับสถานการณ์ต่อไปนี้

• เหตุการณ์ของโปรแกรมเล่นออฟไลน์จะไม่ถูกบันทึก
• เหตุการณ์ในแอปบนอุปกรณ์เคลื่อนที่ (ทั้ง iOS และ Android) จะไม่ถูกบันทึกเมื่อแอปถูกระงับ
• ไม่รองรับ GCC และระบบคลาวด์ที่ไม่ใช่แบบสาธารณะ