Аналізуйте журнали, створені системою, за допомогою Application Insights

Ви можете підключити свої програми на полотні до Application Insights функції Azure Monitor. Application Insights Містить потужні інструменти аналітики, які допоможуть вам діагностувати проблеми та зрозуміти, що користувачі насправді роблять із вашими додатками. Ви можете збирати інформацію, яка допоможе вам приймати кращі бізнес-рішення та покращувати якість ваших додатків.

вимоги

• Необхідно мати доступ до порталу Azure.
• Ви повинні мати дозволи на створення ресурсів Azure.

Створення ресурсу Application Insights

Перш ніж надсилати згенеровані системою журнали з програми, потрібно створити Application Insights ресурс для зберігання подій.

Створіть ресурс на основі робочої області для Application Insights порталу Azure.

Підключіть програму до Application Insights

1. Увійти до Power Apps.

2. Відкрийте програму для редагування.

3. Виберіть об'єкт App у лівому перегляді дерева навігації та вставте рядок Connection зі свого Application Insights ресурсу:

   

4. Збережіть і опублікуйте свій додаток.

5. Грайте в опубліковану програму та переглядайте різні екрани.

Коли ви переглядаєте екрани програм, автоматично реєструються події, включаючи Application Insights відомості про використання, такі як:

• Звідки можна отримати доступ до додатка
• Які пристрої використовуються
• Типи браузерів, що використовуються

Переглянути події у Application Insights

1. Увійдіть на портал Azure і відкрийте ресурс, Application Insights який ви створили раніше.

2. Прокрутіть униз на панелі навігації ліворуч і виберіть Користувачі в розділі Використання .

   Нотатка

   У режимі перегляду «Користувачі » відображаються відомості про використання програми, наприклад:

   • Кількість користувачів, які переглянули додаток
   • Кількість сеансів користувачів
   • Кількість зареєстрованих подій
   • Операційні системи користувачів і відомості про версію браузера
   • Регіон та місцезнаходження користувачів

   Докладніше про аналізи користувачів, сеансів і подій у Application Insights.

3. Виберіть один із сеансів користувача, щоб деталізувати певні відомості. Можна переглянути таку інформацію, як тривалість сеансу та які екрани відвідувалися:

   

4. Виберіть режим перегляду Події на панелі навігації ліворуч у розділі Використання . Тут можна переглянути зведення всіх екранів, що відображалися в усіх сеансах програми.

   

Створення настроюваних подій трасування

Настроювані події трасування можна писати безпосередньо до Application Insights та почати аналіз інформації, яка відповідає Вашому сценарію. Функція Trace дозволяє збирати:

• Детальна інформація про використання елементів керування на екранах
• Які конкретні користувачі мають доступ до вашого додатка
• Які помилки виникають

Крім того, трасування може допомогти діагностувати проблеми, оскільки можна надсилати потік інформації по мірі того, як користувачі переглядають програму та виконують різні дії. Надіслані повідомлення трасування мають Application Insights одну з трьох категорій серйозності:

• Докладно
• Попередження
• Помилка

Залежно від сценарію можна надіслати повідомлення трасування з відповідною серйозністю. Ви можете запитувати дані та вживати конкретних дій залежно від рівня серйозності.

Тепер створіть новий компонент у своїй програмі, щоб збирати відгуки на кожному екрані та записувати події до Application Insights них.

1. Увійти до Power Apps.

2. Виберіть Програми на лівій панелі навігації. Зі списку програм виберіть програму Kudos , а потім натисніть Редагувати.

   Нотатка

   Ви також можете створити нову програму або відредагувати наявну.

3. Виберіть параметр «Компоненти »на панелі «Дерево»:

   

4. Виберіть Новий компонент, а потім змініть розмір ширини до 200 і висоти до 75:

   

5. Виберіть Вставити в меню, а потім виберіть Піктограми , щоб додати Емодзі - Похмурий погляд і Емодзі - Посмішка:

   

6. Виберіть Нова спеціальна властивість, щоб створити спеціальну властивість .

   

7. Введіть властивість Name та Display name , наприклад 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!");
    

    

    Нотатка

    Вираз формули надсилає UserName , UserEmail , Screen та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 .

   Було записано значення для Screen, UserName , UserEmail та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).

Докладні повідомлення про помилки надаються у розмірі "errors" властивості customDimension . У ситуаціях, коли під час однієї операції сталося кілька помилок, помилки об’єднуються в розмірі "errors" однієї події трасування. Повідомлення про помилки збігаються з повідомленнями в програмі Monitor під час сеансу налагодження в реальному часі.

Наведений нижче приклад запиту виявляє необроблені помилки та розгортає всі повідомлення про помилки, включені в подію трасування:

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

Трасування зв'язувань (експериментальні)

[Цей розділ містить попередню документацію, яку буде змінено.]

Підключення до зовнішніх даних і служб є незмінним для більшості програм. Відстеження кореляцій генерує та поширює контекстну інформацію для об'єднання згенерованих системою журналів у програмі canvas та її з'єднаннях із певними обмеженнями. Наприклад, ваша програма може викликати налаштовуваний зєднувач, який у свою чергу викликає функцію Azure або інший REST API. Відстеження кореляції дає змогу співвідносити дії, виконані в додатку, з базовими викликами API на різних рівнях. Це може бути корисним під час усунення несправностей.

Відстеження кореляції в додатку Canvas є реалізацією відстеження контексту та відповідає специфікації W3C.

Увімкнути трасування зв’язування

Щоб увімкнути функцію відстеження кореляції, перейдіть до розділу Налаштування > Майбутні функції > Експериментальний > Увімкніть відстеження Application Insights кореляції в Azure , залишаючи програму полотна відкритою для редагування. Збережіть і опублікуйте додаток.

Обмеження

• Трасування кореляції доступне лише для користувальницьких з'єднувачів. Інші типи з'єднувачів не підтримуються.
• HTTP-запити вловлюються Application Insights тільки в тому випадку, якщо до підключеного сервісу Application Insightsтакож підключено.

Використання трасування зв’язування

Якщо цей параметр увімкнено, відстеження кореляції додає нову подію журналу, створену системою, у таблицю залежностей екземпляра програми canvas Application Insights . Ця подія фіксується в момент надходження відповіді від мережевого дзвінка. Події залежностей фіксують докладні відомості про мережевий виклик, включно з заголовками запитів і відповідей, кодом стану відповіді та тривалістю виклику.

Якщо підключена Application Insights ще й підключена послуга, то в таблиці запитів екземпляра Application Insights сервісу генерується додаткова згенерована системою подія журналу, яка фіксує запит. Деякі служби Azure, такі як Azure Functions, можна підключати без будь-якого кодування з порталу Azure. До одного Application Insights екземпляра можна підключити як програму canvas, так і кілька програм і підключені служби.

Мережеві виклики для підтримуваних з'єднувачів можна об'єднувати з іншими журналами, створеними системою, у розмірі «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. Виберіть меню Отримати дані на стрічці Домашня сторінка, а потім виберіть пункт Пустий запит:

   

8. У вікні запиту виберіть Розширений редактор. Вставте запит у вікно, виберіть «Готово», а потім натисніть «Закрити та застосувати»:

   

Крім того, в Power BI можна створювати діаграми та графічні відображення, щоб представляти отримані у програмі відгуки, а також приймати рішення та виконувати дії на основі даних.

Контекст та розміри події трасування за замовчуванням

Набір розмірів за умовчанням також додається до властивості customDimensions під час кожної події трасування. Ці розміри можна використовувати для визначення сеансів програм і програм, в яких відбувалися події. Якщо ви введете додаткові спеціальні дані за допомогою функції трасування, вони також відображатимуться в спеціальних розмірах.

Не підтримувані сценарії

Application Insights не підтримує наведені далі сценарії.

• Події гравців офлайн не фіксуються.
• Події (обидва iOS та мобільні Android додатки) не фіксуються, коли додаток призупинено.