Анализирайте генерираните от системата регистрационни файлове с помощта на Application Insights

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

Предварителни изисквания

• Трябва да имате достъп до портала на Azure.
• Трябва да имате разрешенията за създаване на ресурси на Azure.

Създаване на ресурс на Application Insights

Преди да можете да изпращате генерирани от системата регистрационни файлове от приложение, трябва да създадете Application Insights ресурс за съхраняване на събитията.

Създайте ресурс , базиран на работно пространство за Application Insights в портала на Azure.

Свързване на приложението ви към Application Insights

1. Влезте в Power Apps.

2. Отворете приложение за редактиране.

3. Изберете обекта на приложението в левия изглед на навигационното дърво и поставете низа за връзка от вашия 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. Въведете име на свойство и показвано име , като например 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 иобратната връзка (със стойност-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).

Подробни съобщения за грешки се предоставят в величината "грешки" на свойството 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 за различните нива. Това може да бъде полезно при отстраняване на неизправности.

Проследяването на корелацията на приложението Canvas е реализация на проследяване на контекста и следва спецификацията на W3C.

Активиране на проследяването на корелацията

За да активирате функцията за проследяване на корелация, отидете на Настройки > Предстоящи функции > Експериментални > Активиране на проследяване Application Insights на корелацията на Azure , като същевременно държите приложението за платно отворено за редактиране. Запазете и публикувайте приложението си.

Ограничения

• Проследяването на корелацията е налично само за персонализирани конектори. Други типове конектори не се поддържат.
• HTTP заявките се улавят Application Insights само ако свързаната услуга също е свързана към Application Insights.

Използване на проследяването на корелацията

Когато е разрешено, проследяването на корелацията добавя ново генерирано от системата събитие в регистрационния файл в таблицата със зависимости на екземпляра на Application Insights приложението за платно. Това събитие се записва в момента на получаване на отговор от мрежово повикване. Събитията на зависимост улавят подробности за мрежовото повикване, включително заглавките на заявката и отговора, кода на състоянието на отговора и продължителността на повикването.

Ако свързаната услуга също е свързана Application Insights, допълнително генерирано от системата събитие в регистрационния файл, улавящо заявката, се генерира в таблицата с заявки на екземпляра на услугата Application Insights . Някои услуги на Azure, като например функциите на Azure, могат да бъдат свързани без никакво кодиране от портала на 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. Изберете менюто Получаване на данни в лентата Началои след това изберете Празна заявка :

   

8. В прозореца на заявката изберете Разширен редактор. Поставете заявката в прозореца, изберете Готово и след това изберете Затвори и приложи:

   

Можете също да създавате диаграми и визуализации в Power BI да представят обратна връзка, получена във вашето приложение, както и да взема решения и действия, базирани на данни.

Контекст и измерения на проследяване на събитията по подразбиране

Набор от величини по подразбиране също се добавя към свойството customDimensions за всяко събитие за проследяване. Тези величини могат да бъдат използвани за идентифициране на приложението и сесиите на приложението, в които са се случили събитията. Ако регистрирате допълнителни персонализирани данни с помощта на функцията за проследяване, те ще се показват и в персонализираните величини.

Неподдържани сценарии

Application Insights не поддържа следните сценарии.

• Събитията на офлайн играчите не се заснемат
• Събитията от мобилното приложение (и двете iOS и Android) не се записват, когато приложението е спряно.