Бөлісу құралы:


Қолдану арқылы жүйеде жасалған журналдарды талдаңыз Application Insights

Кенеп қолданбаларын Application Insights, Azure Monitor мүмкіндігіне қосуға болады. Application Insights мәселелерді диагностикалауға және пайдаланушылардың қолданбаларыңызбен шын мәнінде не істейтінін түсінуге көмектесетін қуатты аналитикалық құралдарды қамтиды. Жақсырақ бизнес шешімдерін қабылдауға және қолданбалардың сапасын жақсартуға көмектесу үшін ақпаратты жинауға болады.

Алғышарттар

Ескертпе

Телеметрия ақпаратын көру үшін жалға алушы әкімшісі Canvas қолданбасының түсініктемелерін қосуы керек. Power Platform басқару орталығында әкімші ретінде жүйеге кіріңіз. Параметрлер>Жалгерлердің параметрлері>Кенвас қолданбасының түсініктемелері тармағына өтіңіз. Canvas қолданбасының түсініктемелері тақтасында ауыстырып-қосқышты Қосулы күйіне орнатып, өзгертулерді сақтаңыз. Қосымша ақпаратты Жалға алушы параметрлері бөлімінен қараңыз.

Application Insights ресурсын жасау

Қолданбадан жүйе жасаған журналдарды жібермес бұрын, оқиғаларды сақтау үшін Application Insights ресурс жасау керек.

Azure порталында үшін Application Insights жұмыс кеңістігіне негізделген ресурс жасаңыз.

Бағдарламаны Application Insights жүйесіне қосу

Ескертпе

  • Қосылым жолын көрсеткенде, деректерді жалға берушілер арқылы жіберуге болатынын ескеріңіз. Бақылау оқиғалары қолданбаңыз үшін орнатқан қосылым жолына сәйкес келетін App Insights ресурсына жіберіледі, тіпті мақсатты App Insights данасы қолданбадан басқа қатысушыда болса да.
  • Қолданыстағы .msapp файлдарын импорттау кезінде сақ болыңыз, себебі App Insights үшін қосылым жолдары болуы мүмкін. Дұрыс App Insights қосылым жолы пайдаланылып жатқанын тексеру үшін импорттан кейін қолданбаны қолмен ашыңыз.
  1. Power Apps жүйесіне кіріңіз.

  2. өңдеу үшін қолданбаны ашыңыз.

  3. Сол жақ шарлау тармағы көрінісінде Қолданба нысанын таңдап, ресурсыңыздан Байланыс жолын Application Insights қойыңыз:

    Қосылым жолын қосыңыз.

  4. Қолданбаңызды сақтаңыз және жариялаңыз .

  5. Жарияланған қолданбаны ойнаңыз және әртүрлі экрандарды шолыңыз.

Қолданба экрандарын шолу кезінде оқиғалар автоматты түрде Application Insights жүйесіне тіркеледі, соның ішінде келесідей пайдалану мәліметтері:

  • Қолданбаға қайдан қол жеткізуге болады
  • Қандай құрылғылар қолданылады
  • Қолданылатын шолғыш түрлері

Маңызды

Оқиғаларды Application Insights жүйесіне жіберу үшін жарияланған бағдарламаны ойнату қажет. Бағдарламаны Power Apps Studio жүйесінде алдын ала қарау кезінде оқиғалар Application Insights жүйесіне жіберілмейді.

Оқиғаларды Application Insights жүйесінде қарау

  1. Azure порталына кіріңіз және Application Insights ресурсты ашыңыз бұрын.

  2. Сол жақ шарлау тақтасында төмен жылжып, Пайдалану бөлімі астындағы Пайдаланушылар тармағын таңдаңыз.

    Ескертпе

    Пайдаланушылар көрініс қолданбаны пайдалану мәліметтерін көрсетеді, мысалы:

    • Қолданбаны көрген пайдаланушылар саны
    • Пайдаланушы сеанстарының саны
    • Тіркелген оқиғалар саны
    • Пайдаланушылардың операциялық жүйелері және шолғыш нұсқасы туралы мәліметтер
    • Пайдаланушылардың аймағы және орналасқан жері

    Пайдаланушылар, сеанстар және оқиғаларды талдау туралы толығырақ ақпаратты Application Insights бөлімінен қараңыз.

  3. Нақты бөлшектерді егжей-тегжейлі қарау үшін пайдаланушы сеанстарының біреуін таңдаңыз. Сеанс ұзақтығы және кірілген экрандар сияқты ақпаратты көре аласыз:

    Пайдаланушылар үшін пайдалану мәліметтері.

  4. Сол жақ шарлау тақтасындағы Пайдалану бөлімінің астындағы Оқиғалар көрінісін таңдаңыз. Сіз барлық бағдарламалар сеанстарында қаралған барлық экрандардың қысқаша мазмұнын көре аласыз:

    Қолданбаға арналған оқиға мәліметтері.

Шайпұл

Қосымша Application Insights мүмкіндіктер қол жетімді, мысалы:

Жеке бақылау оқиғаларын жасау

Жеке бақылау жолдарын тікелей Application Insights жүйесіне жазып, сценарийге тән ақпаратты талдауды іске қосуға болады. Trace функциясы мыналарды жинауға мүмкіндік береді:

  • Экрандардағы басқару элементтерін пайдалану туралы түйіршіктелген ақпарат
  • Қолданбаңызға қандай нақты пайдаланушылар кіріп жатыр
  • Қандай қателер пайда болады

Бақылау сонымен қатар мәселелерді диагностикалауға көмектеседі, өйткені пайдаланушылар сіздің бағдарламаңызды қарап, түрлі әрекеттерді орындаған кезде ақпарат журналын жіберуге болады. Application Insights ке жіберілген бақылау хабарлары үш маңыздылықтың біріне ие:

  • Ақпарат
  • Ескерту
  • Қате

Сценарийіңізге байланысты сіз тиісті ауырлық деңгейімен бақылау хабарын жіберуді таңдауға болады. Деректерді сұрауға және ауырлық дәрежесіне негізделген нақты әрекеттерді орындауға болады.

Ескертпе

Егер сіз қандай да бір жеке деректерді тіркейтін болсаңыз, әртүрлі құпиялылық заңдары мен ережелеріне қатысты міндеттемелеріңізді біліңіз. Қосымша ақпарат алу үшін Microsoft Trust Center және Service Trust Portal бөлімін қараңыз.

Енді әр экранда пікір жинау үшін қолданбаңызда жаңа құрамдас жасаңыз және оқиғаларды Application Insights мекенжайына жазыңыз.

  1. Power Apps жүйесіне кіріңіз.

  2. Сол жақ шарлау тақтасында Қолданбалар тармағын таңдаңыз. Қолданбалар тізімінен Dos қолданбасын таңдап, Өңдеу таңдаңыз.

    Ескертпе

    Сондай-ақ жаңа қолданбаны жаса аласыз немесе оның орнына өңдеу бар қолданбаны жасай аласыз.

  3. Ағаш көрінісіндеКомпоненттеропциясын таңдаңыз:

    Компоненттер.

  4. Жаңа құрамдас таңдаңыз, содан кейін енін 200-ге және биіктігін 75-ке өзгертіңіз:

    Биіктігі мен ені.

  5. Мәзірден Кірістіру пәрменін таңдап, одан кейін Белгішелер пәрменін таңдаңыз - Қабағын бұру және Emoji - Smile

    Белгішелерді қосыңыз.

  6. Теңшелетін сипатты жасау үшін Жаңа теңшелетін сипатты таңдаңыз:

    Теңшелетін сипатты жасаңыз.

  7. Аты және Көрсетілетін атау мысалы, Кері байланыс экраны сипатын енгізіңіз.

  8. Сипаттама сипатын енгізіңіз.

  9. Сипаттар түрі as Кіріс және Дерек түрі as Экран ретінде таңдаңыз:

    Арнайы сипат.

    Ескертпе

    Кіріс сипаты экранның атауын және оның компонентін түсіруге мүмкіндік береді, осылайша сіз мына ақпаратты Application Insights жүйесіне тіркей аласыз.

  10. Құрамдас бөлікті Ағаш көрінісі таңдаңыз, Қосымша әрекеттер (), содан кейін Осындай мағыналы құрамдастың атауын өзгерту таңдаңыз. ретінде Кері байланыс құрамдас бөлігі.

    Компонент пен белгішелердің атын өзгерту.

  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, Экран және Кері байланыс (мәні бар <> дейін. 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 жүйесіне жіберу үшін жарияланған бағдарламаны ойнату қажет. Бағдарламаны Power Apps Studio жүйесінде алдын ала қарау кезінде оқиғалар Application Insights жүйесіне жіберілмейді.

    Жарияланған қолданбаны ойнату.

Application Insights жүйесінде деректерді талдау

Енді ішіндегі қолданбаңыздағы Бақылау Application Insightsфункциясын пайдаланып жіберген деректерді талдауды бастай аласыз.

  1. Azure порталына жүріп, бұрын Application Insights жасағанресурсты ашыңыз:

     Application Insightsтаңдаңыз.

  2. Сол жақ шарлау тақтасындағы ЖурналдарМониторинг тармағын таңдаңыз:

    Журналдар таңдаңыз.

  3. Келесі сұрауды енгізіп, қолданбадан алынған пікірді көру үшін Іске қосу пәрменін таңдаңыз:

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

    Қолданбаның пікірін көру.

  4. Нәтижелердегі жолды таңдап, customDimensions өрісін кеңейтіңіз.

    Экран, ПайдаланушыАты, UserEmail және Кері байланыс үшін мәндер Құрамдасыңыздағы 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
    

    CustomDimensions сұрауын кеңейту.

    Шайпұл

    Журнал сұраулары өте күшті. Сіз оларды бірнеше кестелерге қосылуға, үлкен көлемде деректерді жинауға және күрделі операцияларды жасауға пайдалана аласыз. Журнал сұраулары туралы қосымша мәліметтер.

Өңделмеген қателерді бақылау (эксперименттік)

[Бұл бөлім шығарылым алдындағы құжаттаманы қамтиды және ол өзгертілуі мүмкін.]

Маңызды

  • Бұл — эксперименттік мүмкіндік.
  • Тәжірибелік мүмкіндіктер өндірісті пайдалану үшін арналмаған және функционалдық шектеулі болуы мүмкін. Бұл мүмкіндіктер ресми жарияланудан бұрын қолжетімді, сондықтан тұтынушылар ерте қатынаса алады және кері байланыс бере алады.

Қолданба жұмыс істеп тұрған кезде орын алуы мүмкін барлық қателерді әрқашан болжай алмайсыз және жоспарлай алмайсыз. Өңделмеген Power Fx формула қателері пайдаланушыларға баннер хабарлары ретінде хабарланады. Мәселелерді хабарлау үшін қолданбаңыздың пайдаланушыларына сенбестен олардың жиілігі мен ауырлығын түсінуге көмектесу үшін олар туралы Application Insights хабарлауға болады. Сондай-ақ, белсенді тәсілді қолдану үшін орындалу қателері орын алған кезде нақты уақыттағы ескертулерді орнатуға болады.

Application Insights жүйесіне қате жіберуді қосу

Power Apps өңделмеген орындалу қателерін Azure Application Insights жүйесіне жіберуге мүмкіндік беретін параметрді қосу керек.

Ескерту

Бұл параметрді қосу Application Insights журналдарын сақтауға байланысты қосымша шығындарды тудыруы мүмкін.

Қатені жіберуді қосу үшін Параметрлер > Алдағы мүмкіндіктер > Эксперименталды > Қателерді 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 журналдарын сақтауға байланысты қосымша шығындарды тудыруы мүмкін.

Корреляцияны қадағалау мүмкіндігін қосу үшін Параметрлер > Алдағы мүмкіндіктер > Тәжірибелік > Бағдарлама canva файлдарын өңдеу үшін ашық болған кезде Azure Application Insights корреляциялық бақылауды қосу тармағына өтіңіз. Қолданбаңызды сақтаңыз және жариялаңыз.

Azure Application Insights корреляциялық бақылауды қосыңыз.

Шектеулер

  • Корреляцияны бақылау тек теңшелетін қосқыштар үшін қол жетімді. Басқа қосқыш түрлеріне қолдау көрсетілмейді.
  • 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 опциясын таңдаңыз:

     Power BI сұрауды экспорттау.

  5. Жүктелген файлды мәтіндік өңдегіште ашып, сұрауды аралық сақтағышқа көшіріңіз.

  6. Power BI ашу.

  7. Басты бет таспасындағы Деректерді алу мәзірін таңдап, Бос сұрау таңдаңыз:

    Power BI бос сұрау.

  8. Сұрау терезесінде Қосымша өңдегіш таңдаңыз. Сұрауды терезеге қойыңыз, Дайын таңдаңыз, содан кейін Жабу & Қолдану:

    Power BI алдын ала сұрау.

Сонымен қатар бағдарламада алынған кері байланысты көрсету үшін Power BI жүйесіндегі диаграммалар мен көрнекілендірулерді жасауға, сондай-ақ деректерге негізделген шешімдер мен әрекеттерді орындауға болады.

Диаграммалар мен көрнекіліктер.

Әдетте бақылау оқиғасының мәтінмәні мен өлшемдері

Әдепкі өлшемдер жиыны сонымен қатар әрбір Trace оқиғасында customDimensions сипатта қосылады. Бұл өлшемдерді оқиғалар пайда болған бағдарлама және бағдарлама сеанстарын анықтау үшін пайдалануға болады. Бақылау функциясын пайдаланып қосымша реттелетін деректерді тіркесеңіз, олар теңшелетін өлшемдерде де пайда болады.

Өлшем аты Ұсыныстар
ms-appId Оқиғаны жіберген бағдарламаның бағдарлама идентификаторы.
ms-appname Оқиғаны жіберген бағдарламаның бағдарлама атауы.
ms-appSessionId Бағдарлама сеансының идентификаторы. Кейбір сценарийлерде бұл мән толтырылмауы мүмкін. Қолжетімді болғанда, бұл мән стандартты Application Insights sessionID өлшеміін қайта анықтайды.
ms-tenantID Бағдарлама жарияланған қатысушының бір мәнді идентификаторы.
ms-environmentId Бағдарлама жарияланған ортаның атауы.
userId Сеанспен байланыстырылған пайдаланушы үшін бірегей идентификатор.
ms-duration Пайдаланушының бір экраннан екіншісіне өту уақытын өлшейтін есептелген мән. Бұл мән стандартты Application Insights PageView ұзақтығы өлшемін қайта анықтайды.
sessionId Бір бағдарлама сеансымен байланыстырылған барлық оқиғаларды түзету үшін пайдалануға болатын сеанс идентификаторы. Бұл мән әрқашан бар және бірегей сеанс санын түсіну үшін ұсынылады. Бұл мән ойнатқыштың сеанс идентификаторынан алынады және бағдарламаны ойнату кезінде сеанс мәліметтерін қарау кезінде көрсетіледі. Сеанс идентификаторы кейде әдепкі, кездейсоқ және бірегей Application Insights құрылған мән болуы мүмкін. Бұл әдепкі мән сенімді емес және бағдарламаға қатысты ешқандай параметрлермен сәйкес келмейді.
Ұзақтық Пайдаланушының бір экраннан екіншісіне өту уақытын өлшейтін есептелген мән. Бұл мән ms-duration өлшемі хабарлаған ұзақтықпен бірдей.
ms-isTest Сеанс Test Studio сынақ жүгірткішімен байланыстырылғанын көрсетеді.
ms-currentScreenName Пайдаланушы шарлайтын беттің атауы (бет шарлау оқиғалары үшін берілген).
ms-targetScreenName Пайдаланушы шарлап жатқан беттің атауы (бет шарлау оқиғалары үшін берілген).

Қолдау көрсетілмейтін сценарийлер

Application Insights бағдарламасы келесі сценарийлерге қолдау көрсетпейді.

  • Офлайн ойнатқыш оқиғалары түсірілмейді.
  • Қолданба тоқтатылған кезде мобильді қолданба ( iOS және Android) оқиғалары түсірілмейді.