Phân tích nhật ký do hệ thống tạo bằng cách sử dụng Application Insights

Bạn có thể kết nối ứng dụng canvas của mình với Application Insights, một tính năng của Azure Monitor. Application Insights bao gồm các công cụ phân tích mạnh mẽ để giúp bạn chẩn đoán sự cố và hiểu những gì người dùng thực sự làm với ứng dụng của bạn. Bạn có thể thu thập thông tin để giúp bạn đưa ra các quyết định kinh doanh tốt hơn và cải thiện chất lượng ứng dụng của mình.

Trong phần bắt đầu nhanh này, chúng tôi sử dụng ứng dụng canvas có tên Kudos để khám phá các khái niệm về nhật ký do hệ thống tạo trong ứng dụng canvas và áp dụng chúng cho ứng dụng của bạn. Ứng dụng Kudos mẫu là một phần của bộ ứng dụng gắn kết nhân viên có sẵn để tải xuống từ  Bộ công cụ khởi đầu trải nghiệm nhân viên.

Điều kiện tiên quyết

• Bạn phải có quyền truy cập vào Cổng thông tin Azure.
• Bạn phải có quyền tạo tài nguyên Azure.

Không bắt buộc

• Tải xuống và cài đặt ứng dụng Kudos từ Bộ công cụ khởi đầu trải nghiệm nhân viên. Bạn cũng có thể sử dụng ứng dụng hiện có.

Tạo tài nguyên Application Insights

Trước khi có thể gửi nhật ký do hệ thống tạo từ một ứng dụng, bạn cần tạo tài nguyên Application Insights để lưu trữ các sự kiện.

1. Đăng nhập vào  Cổng thông tin Azure.

2. Tìm kiếm Application Insights:

   

3. Tạo tài nguyên Application Insights:

   

4. Nhập các giá trị thích hợp và chọn Đánh giá + tạo.

   Để biết thêm chi tiết, đọc Tạo tài nguyên Application Insights.

   

5. Sau khi Application Insights phiên bản được tạo, hãy sao chép Khóa thiết bị trong phần tổng quan về phiên bản để sử dụng trong bước sắp tới.

   

Kết nối ứng dụng với Application Insights

1. Đăng nhập vào Power Apps.

2. Chọn Ứng dụng ở ngăn điều hướng bên trái. Từ danh sách ứng dụng, hãy chọn ứng dụng Kudos rồi chọn Chỉnh sửa:

   

   Lưu ý

   Bạn cũng có thể tạo một ứng dụng mới hoặc chỉnh sửa bất kỳ ứng dụng hiện có nào.

3. Chọn đối tượng Ứng dụng trong chế độ xem dạng cây điều hướng bên trái và dán Khóa thiết bị:

   

4. Lưu và Phát hành ứng dụng.

5. Chơi ứng dụng đã xuất bản và duyệt qua các màn hình khác nhau.

Khi bạn duyệt qua màn hình ứng dụng, các sự kiện sẽ tự động được ghi vào Application Insights, bao gồm các chi tiết sử dụng như:

• Ứng dụng được truy cập từ đâu
• Những thiết bị nào được sử dụng
• Các loại trình duyệt được sử dụng

Xem sự kiện trong Application Insights

1. Đăng nhập vào  Cổng thông tin Azure và mở tài nguyên Application Insights mà bạn tạo từ trước.

2. Cuộn xuống trong ngăn điều hướng bên trái và chọn Người dùng bên dưới phần Sử dụng.

   Lưu ý

   Chế độ xem Người dùng hiển thị thông tin chi tiết về cách sử dụng ứng dụng, chẳng hạn như:

   • Số lượng người dùng đã xem ứng dụng
   • Số phiên người dùng
   • Số sự kiện được ghi lại
   • Chi tiết về phiên bản trình duyệt và hệ điều hành của người dùng
   • Khu vực và vị trí của người dùng

   Tìm hiểu thêm về phân tích người dùng, phiên và sự kiện trong Application Insights.

3. Chọn một trong các phiên người dùng để đi sâu vào chi tiết. Bạn có thể xem thông tin như thời lượng phiên và màn hình đã truy cập:

   

4. Chọn chế độ xem Sự kiện trong ngăn điều hướng bên trái trong phần Cách sử dụng . Bạn có thể xem tóm tắt tất cả các màn hình đã xem trong tất cả các phiên ứng dụng:

   

Tạo sự kiện truy vết tùy chỉnh

Bạn có thể viết truy vết tùy chỉnh trực tiếp vào Application Insights và bắt đầu phân tích thông tin cụ thể cho kịch bản của bạn. Chức năng Dấu vết cho phép bạn thu thập:

• Thông tin sử dụng chi tiết cho các điều khiển trên màn hình
• Những người dùng cụ thể nào đang truy cập ứng dụng của bạn
• Xảy ra lỗi gì

Truy vết cũng có thể giúp chẩn đoán các vấn đề vì bạn có thể gửi một dấu vết thông tin khi người dùng duyệt qua ứng dụng của bạn và thực hiện các hành động khác nhau. Tin nhắn theo dõi được gửi tới Application Insights có một trong ba mức độ nghiêm trọng:

• Thông tin
• Cảnh báo
• Lỗi

Tùy thuộc vào kịch bản của bạn, bạn có thể chọn gửi thông báo truy vết với mức độ nghiêm trọng phù hợp. Bạn có thể truy vấn dữ liệu và thực hiện các hành động cụ thể dựa trên mức độ nghiêm trọng.

Bây giờ, hãy tạo một thành phần mới trong ứng dụng của bạn để thu thập phản hồi trên mỗi màn hình và ghi các sự kiện vào Application Insights.

1. Đăng nhập vào Power Apps.

2. Chọn Ứng dụng ở ngăn điều hướng bên trái. Từ danh sách ứng dụng, hãy chọn ứng dụng Kudos rồi chọn Chỉnh sửa.

   Lưu ý

   Thay vào đó, bạn cũng có thể tạo một ứng dụng mới hoặc chỉnh sửa một ứng dụng hiện có.

3. Chọn tùy chọn Thành phần trên Dạng xem cây:

   

4. Chọn Thành phần mới rồi thay đổi kích thước chiều rộng thành 200 và chiều cao thành 75:

   

5. Chọn Chèn từ menu và sau đó chọn Biểu tượng để thêm Biểu tượng cảm xúc - Nhăn mặt và Biểu tượng cảm xúc - Cười:

   

6. Chọn Thuộc tính tùy chỉnh mới để tạo một thuộc tính tùy chỉnh:

   

7. Nhập thuộc tính Tên và Tên hiển thị như FeedbackSceen.

8. Nhập thuộc tính Mô tả.

9. Chọn Loại thuộc tính là Đầu vào và Kiểu dữ liệu là Màn hình:

   

   Lưu ý

   Thuộc tính đầu vào cho phép bạn chụp tên màn hình và thành phần của nó để bạn có thể ghi thông tin này vào Application Insights.

10. Chọn thành phần trên Chế độ xem dạng cây, chọn Tác vụ khác (…) và sau đó chọn Đổi tên để đổi tên thành phần bằng một tên có ý nghĩa như FeedbackComponent.

    

11. Chọn các biểu tượng, chọn Tác vụ khác (…), sau đó chọn Đổi tên thành đổi tên các biểu tượng bằng những tên có ý nghĩa, chẳng hạn như FrownIcon và SmileIcon.

12. Chọn FrownIcon, chọn thuộc tính OnSelect rồi nhập biểu thức sau vào thanh công thức:

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

    

    Lưu ý

    Biểu thức công thức gửi UserName, UserEmail, Screen và Feedback (với giá trị -1) tới Application Insights.

13. Chọn SmileIcon, chọn thuộc tính OnSelect rồi nhập biểu thức sau vào thanh công thức:

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

14. Thêm thành phần vào một trong các màn hình trong ứng dụng của bạn:

    

15. Chọn Lưu rồi chọn Phát hành để lưu và phát hành ứng dụng.

16. Phát ứng dụng đã phát hành và gửi phản hồi mặt cười hoặc nhăn mày từ màn hình của bạn.

    Quan trọng

    Bạn phải phát ứng dụng đã phát hành để gửi sự kiện tới Application Insights. Sự kiện không được gửi đến Application Insights khi bạn xem trước ứng dụng trong Power Apps Studio.

    

Phân tích dữ liệu trong Application Insights

Bây giờ, bạn có thể bắt đầu phân tích dữ liệu bạn đã gửi bằng cách sử dụng hàm Truy vết từ ứng dụng của bạn trong Application Insights.

1. Đăng nhập vào  Cổng thông tin Azure và mở tài nguyên Application Insights mà bạn tạo từ trước:

   

2. Chọn Nhật ký trong Giám sát trong ngăn điều hướng bên trái:

   

3. Nhập truy vấn sau và chọn Chạy để xem phản hồi nhận được từ ứng dụng của bạn:

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

   

4. Chọn một hàng trong kết quả và mở rộng trường customDimensions.

   Các giá trị cho Screen, UserName, UserEmail và FeedbackValue cho sự kiện OnSelect của biểu tượng cười và nhăn mặt trong thành phần của bạn đã được ghi lại. Các giá trị cũng được ghi lại cho mỗi sự kiện được gửi tới Application Insights, chẳng hạn như appId, appName và appSessionId.

   

5. Với truy vấn ví dụ sau, bạn có thể mở rộng các thuộc tính của kích thước tùy chỉnh JSON và chiếu các cột trong dạng xem kết quả.

   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
   

   

   Tiền bo

   Truy vấn nhật ký là vô cùng hiệu quả. Bạn có thể sử dụng chúng để nối nhiều bảng, tổng hợp lượng lớn dữ liệu và thực hiện các hoạt động phức tạp. Tìm hiểu thêm về truy vấn nhật ký.

Giám sát các lỗi chưa xử lý (thử nghiệm)

[Phần này chứa tài liệu hướng dẫn trước khi phát hành và có thể thay đổi.]

Không phải lúc nào bạn cũng có thể dự đoán và lập kế hoạch cho tất cả các lỗi có thể xảy ra khi ứng dụng của bạn đang chạy. Các lỗi công thức Power Fx chưa được xử lý sẽ được báo cáo cho người dùng dưới dạng thông báo biểu ngữ. Bạn cũng có thể báo cáo các vấn đề này cho Application Insights để giúp bạn hiểu tần suất và mức độ nghiêm trọng của chúng mà không cần dựa vào việc người dùng ứng dụng của bạn báo cáo vấn đề. Bạn cũng có thể thiết lập cảnh báo theo thời gian thực khi xảy ra lỗi thời gian chạy để có cách tiếp cận chủ động hơn.

Cho phép chuyển lỗi cho Application Insights

Bạn cần bật cài đặt cho phép Power Apps chuyển các lỗi thời gian chạy chưa được xử lý sang Azure Application Insights.

Để bật tùy chọn chuyển lỗi, hãy chuyển đến Thiết đặt > Tính năng sắp tới > Thử nghiệm > Chuyển lỗi cho Azure Application Insights trong khi vẫn mở ứng dụng canvas để chỉnh sửa. Lưu và xuất bản ứng dụng của bạn.

Sự kiện lỗi trong Application Insights

Power Fx lỗi chưa được xử lý mà người dùng gặp phải trong thời gian chạy ứng dụng sẽ được báo cáo vào bảng dấu vết . Bạn có thể xác định và phân biệt các lỗi chưa được xử lý với các sự kiện lỗi khác bằng thông báo sự kiện "Lỗi chưa được xử lý". Thứ nguyên "mức độ nghiêm trọng" của những sự kiện này là 3 (TraceSeverity.Error).

Thông báo lỗi chi tiết được cung cấp trong thứ nguyên "lỗi" của thuộc tính customDimension. Trong trường hợp xảy ra nhiều lỗi trong cùng một thao tác, các lỗi sẽ được hợp nhất theo chiều "lỗi" của một sự kiện theo dõi duy nhất. Các thông báo lỗi giống như được báo cáo trong Monitor trong phiên gỡ lỗi trực tiếp.

Truy vấn mẫu sau đây xác định các lỗi chưa được xử lý và mở rộng tất cả các thông báo lỗi có trong sự kiện theo dõi:

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

Theo dõi sự tương quan (thử nghiệm)

[Phần này chứa tài liệu hướng dẫn trước khi phát hành và có thể thay đổi.]

Kết nối với dịch vụ và dữ liệu bên ngoài là yếu tố căn bản đối với hầu hết các ứng dụng. Theo dõi tương quan tạo và truyền bá thông tin ngữ cảnh để kết hợp các nhật ký do hệ thống tạo trên một ứng dụng canvas và các kết nối của ứng dụng đó, tuân theo một số hạn chế nhất định. Ví dụ: ứng dụng của bạn có thể gọi một trình kết nối tùy chỉnh để lần lượt gọi Azure Function hoặc REST API khác. Theo dõi tương quan cho phép bạn liên hệ các hành động được thực hiện trong ứng dụng với lệnh gọi API cơ bản giữa các cấp. Điều này có thể hữu ích khi khắc phục sự cố.

Theo dõi tương quan của ứng dụng canvas là triển khai theo dõi bối cảnh và tuân theo đặc tả W3C.

Bật tính năng theo dõi sự tương quan

Để bật tính năng theo dõi sự tương quan, hãy truy cập Thiết đặt > Tính năng sắp tới > Thử nghiệm> Bật tính năng theo dõi sự tương quan của Azure Application Insights trong khi vẫn mở ứng dụng canvas để chỉnh sửa. Lưu và xuất bản ứng dụng của bạn.

Giới hạn

• Theo dõi tương quan chỉ có sẵn cho các trình kết nối tùy chỉnh. Các loại trình kết nối khác không được hỗ trợ.
• Yêu cầu HTTP chỉ được ghi lại Application Insights nếu dịch vụ được kết nối cũng được kết nối với Application Insights.

Sử dụng tính năng theo dõi sự tương quan

Khi được bật, tính năng theo dõi tương quan sẽ thêm một sự kiện nhật ký mới do hệ thống tạo vào bảng phụ thuộc của phiên bản Application Insights ứng dụng canvas. Sự kiện này được ghi lại tại thời điểm nhận được phản hồi từ cuộc gọi mạng. Các sự kiện phụ thuộc ghi lại thông tin chi tiết của lệnh gọi mạng, bao gồm tiêu đề yêu cầu và phản hồi, mã trạng thái phản hồi và thời lượng của lệnh gọi.

Nếu dịch vụ được kết nối cũng được kết nối với Application Insights, thì một sự kiện nhật ký bổ sung do hệ thống tạo để ghi lại yêu cầu sẽ được tạo trong bảng yêu cầu của dịch vụ Application Insights . Một số dịch vụ Azure, chẳng hạn như Azure Functions, có thể được kết nối mà không cần bất kỳ mã hóa nào từ cổng Azure. Cả ứng dụng canvas hoặc nhiều ứng dụng và dịch vụ được kết nối đều có thể được kết nối với cùng một phiên bản Application Insights .

Cuộc gọi mạng dành cho các trình kết nối được hỗ trợ có thể được kết hợp với các nhật ký khác do hệ thống tạo trên kích thước "Operation_Id". Truy vấn mẫu sau đây cho thấy cuộc gọi mạng được thực hiện cùng với các sự kiện theo dõi được phát ra trong phiên ứng dụng.

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

Xuất dữ liệu sang Power BI

Bạn có thể xuất dữ liệu Application Insights và kết quả truy vấn vào Power BI để phân tích và trình bày dữ liệu.

1. Đăng nhập vào  Cổng thông tin Azure và mở tài nguyên Application Insights mà bạn tạo từ trước:

2. Chọn Nhật ký trong Giám sát trong ngăn điều hướng bên trái:

3. Từ cửa sổ truy vấn phân tích nhật ký, hãy chọn menu Xuất .

4. Chọn tùy chọn Xuất sang Power BI (M query) để tải xuống tệp truy vấn Power BI :

   

5. Mở tệp đã tải xuống trong trình soạn thảo văn bản và sao chép truy vấn vào bảng tạm.

6. Mở Power BI.

7. Chọn menu Nhận dữ liệu trong dải băng Trang chủ, sau đó chọn Truy vấn trống:

   

8. Trong cửa sổ truy vấn, chọn Trình chỉnh sửa nâng cao. Dán truy vấn vào cửa sổ, chọn Xong rồi chọn Đóng & Áp dụng:

   

Bạn cũng có thể tạo biểu đồ và trực quan hóa trong Power BI để thể hiện phản hồi nhận được trong ứng dụng của bạn, cũng như đưa ra các quyết định và hành động dựa trên dữ liệu.

Ngữ cảnh và kích thước sự kiện Truy vết mặc định

Một tập hợp các kích thước mặc định cũng được thêm vào thuộc tính customDimensions trên từng sự kiện Truy vết. Các kích thước này có thể được sử dụng để xác định các phiên ứng dụng và ứng dụng mà các sự kiện đã xảy ra. Nếu bạn ghi nhật ký dữ liệu tùy chỉnh bổ sung bằng chức năng Theo dõi, chúng cũng sẽ xuất hiện trong thứ nguyên tùy chỉnh.

Kịch bản không được hỗ trợ

Application Insights không hỗ trợ các kịch bản sau.

• Các sự kiện của người chơi ngoại tuyến không được ghi lại.
• Các sự kiện trong ứng dụng dành cho thiết bị di động (cả iOS và Android) không được ghi lại khi ứng dụng bị tạm ngưng.
• GCC và nền tảng điện toán đám mây phi công cộng không được hỗ trợ.