Application Insights kullanarak bir tuval uygulamasının telemetrisini analiz etme

Uygulamanızı bir Azure Monitor özelliği olan Application Insights ile bağlayabilirsiniz. Application Insights, sorunları tanılamanıza ve uygulamanızda hangi kullanıcıların gerçekten ne yaptığını anlamanıza yardımcı olan güçlü çözümlemeler araçları içerir.

Uygulamanız, Application Insights'a bağlı olarak, daha iyi iş kararları vermenizde ve uygulamalarınızın kalitesini artırmanıza yardımcı olacak bilgiler toplayabilirsiniz.

Bu hızlı başlangıçta Kudos adlı tuval uygulaması yönetirsiniz. Bu, araştırmanıza, telemetri kavramlarını keşfetmenize ve kendi tuval uygulamalarınıza uygulamanıza yardımcı olur. Örnek Kudos uygulaması bir çalışan etkileşimi uygulamaları paketinin parçasıdır ve Employee Experience Starter Kit adresinden indirilebilir.

Ön koşullar

İsteğe Bağlı

Application Insights kaynağı oluştur

Bir uygulama için telemetri gönderebilmeniz için önce, olayları depolamak için bir Application Insights kaynak oluşturmanız gerekir.

  1. Azure portalında oturum açın.

  2. Application Insights arayın:

    Application Insights.

  3. Application Insights kaynağı oluşturun:

    Application Insights kaynağı ekleme.

  4. Uygun değerleri girin ve gözden geçir + oluştur seçeneğini belirleyin. Daha fazla bilgi için, oku Application Insights kaynak oluştur'u okuyun.

    Kaynak oluşturma.

  5. Application Insights örneği oluşturulduktan sonra , örneğe genel bakış görünümünü görürsünüz. İzleme anahtarı kopyalayın. Uygulamanızı yapılandırmak için bu anahtara ihtiyacınız vardır.

    İzleme Anahtarını kopyalama.

Uygulamanızı Application Insights'a bağlayın

  1. Power Apps'te oturum açın.

  2. Sol gezintide, Uygulamalar'ı seçin. Uygulama listesinden Kudos uygulamasını seçin ve sonra da Düzenle'yi seçin:

    Kudos uygulamasını düzenleme.

    Not

    Ayrıca yeni bir uygulama oluşturabilir veya mevcut uygulamayı düzenleyebilirsiniz.

  3. Sol gezinti ağacından uygulama nesnesini seçin ve sonra da İzleme anahtarını yapıştırın:

    İzleme Anahtarını ekleme.

  4. Uygulamanızı kaydedin ve yayımlayın.

  5. Yayımlanmış uygulamayı yürütün ve farklı ekranlara göz atın.

Farklı ekranlarda gezinirken, aşağıdakiler gibi kullanım ayrıntıları da dahil olmak üzere olaylar Application Insights'a otomatik olarak kaydedilir:

  • Uygulamaya erişim yeri.
  • Kullanılan cihazlar.
  • Kullanılan tarayıcı türleri.

Önemli

Olayları Application Insights'a göndermek için yayımlanmış uygulamayı yürütmeniz gerekir. Power Apps Studio uygulamasında uygulamanın önizlemesini görüntülediğinizde olaylar Application Insights'a gönderilmez.

Application Insights'ta olayları görüntüle

  1. Azure portalında oturum açın ve önceden oluşturduğunuz Application Insights kaynağı açın.

  2. Sol gezinti bölmesinde aşağı kaydırın ve kullanım bölümü altındaki kullanıcıları seçin.

    Not

    Kullanıcılar görünümü uygulamanın kullanım ayrıntılarını gösterir;

    • Uygulamayı görüntüleyen Kullanıcı sayısı.
    • Uygulama kullanıcılarına göre oturum sayısı.
    • Uygulama için günlüğe kaydedilen olay sayısı.
    • İşletim sistemleri ve kullanıcıların tarayıcı sürüm ayrıntıları.
    • Kullanıcıların bölgesi ve konumu.

    Daha fazla ayrıntı için Application Insights uygulamasında kullanıcıları, oturumları ve olay analizini okuyun .

  3. Belirli Ayrıntılara gitmek için kullanıcı oturumlarından birini seçin. Oturum uzunluğu ve ziyaret edilen ekranlar gibi bilgileri görebilirsiniz:

    Kullanıcıların kullanım ayrıntıları.

  4. Sol gezinti bölmesinde kullanım bölümü altındaki Olaylar görünümünü seçin. Tüm uygulama oturumlarında görüntülenen tüm ekranların bir özetini görebilirsiniz:

    Uygulamanın olay ayrıntıları.

İpucu

Kullanabileceğiniz ek Application Insights özelliklerin bazıları şunlardır:

Özel izleme olayları oluşturma

Senaryonuza özgü bilgileri çözümlemek için doğrudan Application Insights'e özel izlemeler yazabilir ve başlayabilirsiniz. İzleme işlevi aşağıdakileri toplamanıza olanak sağlar:

  • Ekranlardaki denetimler için parçalı kullanım bilgileri.
  • Uygulamanıza hangi belirli kullanıcılar erişiyor?
  • Hangi hataların ortaya çıkması.

İzleme, kullanıcılarınız uygulamanızda gezinirken ve farklı eylemler gerçekleştirdikçe bilgilerin bir izini gönderebileceğiniz için sorunları tanılamanıza de yardımcı olabilir.

Uygulamanızdan Application Insights'a Özel izleme bilgileri gönderirken izleme iletilerinin üç özellikleri vardır :

  • Bilgiler
  • Uyarı
  • Hata

Senaryonuza bağlı olarak, uygun önem derecesiyle bir izleme iletisi göndermeyi tercih edebilirsiniz. Verileri sorgulayabilir ve iletinin önem derecesine göre belirli eylemler alabilirsiniz.

Not

Herhangi bir personel verisi günlüklemeyi gerçekleştiriyorsanız, uygulamanız gerekebilecek GDPR gibi herhangi bir veri uyumluluk yükümlülüklerini dikkate almanız gerekir.

Şimdi uygulamanızı güncelleştirecek ve uygulamanın her ekranı için geri bildirim toplamak üzere yeni bir bileşen oluşturacaksınız. Olayları Application Insights'a yazacaksınız.

  1. Power Apps'a oturum açın.

  2. Sol gezintide, Uygulamalar'ı seçin. Uygulama listesinden Kudos uygulamasını seçin ve sonra da Düzenle'yi seçin:

    Not

    Ayrıca yeni bir uygulama oluşturabilir veya mevcut uygulamayı düzenleyebilirsiniz.

  3. Ağaç görünümünde bileşenler seçeneğini belirleyin :

    Bileşenler.

  4. Yeni bileşen'i seçin ve genişliği 200 ve yüksekliği 75 olarak yeniden boyutlandırın:

    Yükseklik ve genişlik.

  5. Menüden Ekle' i seçin ve Emoji-Kaş ve Emoji - Gülümseme eklemek için Simgeler'i seçin:

    Simge ekleme.

  6. Özel özellik oluşturmak için Yeni özel özellik'i seçin :

    Özel özellik oluşturma.

  7. Özellik adı ve görünen ad, FeedbackSceen gibi girin.

  8. Özellik Açıklaması girin.

  9. Özellik türünü, giriş ve veri türünü ekran olarak seçin:

    Özel özellik.

    Not

    Giriş özelliği, ekran adını ve bileşenin bileşenini yakalamanıza olanak sağlar; böylece bu bilgileri Application Insights'a günlüğe kaydedebilirsiniz.

  10. Ağaç görünümünde bileşeni seçin , daha fazla eylem (...) seçin ve sonra da bileşeni feedbackcomponent gibi anlamlı bir adla yeniden adlandırmak için Yeniden adlandır'ı seçin.

    Bileşeni ve simgeleri yeniden adlandırma.

  11. Simgeleri seçin, daha fazla eylem (...) seçin ve sonra simgeleri, FrownIcon ve SmileIcon gibi anlamlı adlarla yeniden adlandırmak için yeniden adlandır seçeneğini seçin.

  12. FrownIcon simgesini seçin , OnSelect özelliğini seçin ve ardından formül çubuğuna aşağıdaki ifadeyi girin:

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

    Asık surat simgesi formülü.

    Not

    Formül ifadesi olarak UserName, UserEmail, Screen ve Feedback (-1 değeriyle) Application Insights'a gönderilir.

  13. SmileIcon simgesini seçin , OnSelect özelliğini seçin ve ardından formül çubuğuna aşağıdaki ifadeyi girin:

    Trace(
       "App Feedback",
       TraceSeverity.Information,
           {
             UserName: User().FullName,
             UserEmail: User().Email,
             Screen: FeedbackComponent.FeedbackScreen.Name,
             FeebackValue: "1"
           }
         );
    Notify("Thanks for you feedback!");
    
  14. Bileşeni uygulamanızda ekranlardan birine ekleyin:

    Geri bildirim bileşeni ekleme.

  15. Uygulamanızı kaydedip yayımlamak için Kaydet'i ve ardından Yayımla'yı seçin.

  16. Yayımlanmış uygulamayı yürütün ve ekranlarından bir gülümseme ve çatma görüşü gönderin.

    Önemli

    Olayları Application Insights'a göndermek için yayımlanmış uygulamayı yürütmeniz gerekir. Power Apps Studio uygulamasında uygulamanın önizlemesini görüntülediğinizde olaylar Application Insights'a gönderilmez.

    Yayımlanan uygulamayı yürütme.

Application Insights'da Verileri çözümleme

Artık Application Insights'ta uygulamanızdan izleme işlevini kullanarak gönderdiğiniz verileri çözümlemeye başlayabilirsiniz.

  1. Azure portalında oturum açın ve önceden oluşturduğunuz Application Insights kaynağı açın:

    Application Insights öğesini seçme.

  2. İzleme altındaki günlükleri sol gezinti bölmesinde seçin:

    Günlükleri seçme.

  3. Aşağıdaki sorguyu girip Çalıştır’ı seçin. Uygulamanızdan alınan geri bildirim döndürülür:

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

    Uygulama geri bildirimini görüntüleme.

  4. Sonuçlarda bir satır seçin ve customDimensions alanını genişletin.

    Bileşeninizde gülümseme veya Kaş simgesi için OnSelect olayının Ekran, UserName, UserEmail ve FeedbackValue değerleri kaydedildi.
    Application Insights'a gönderilen her olay için AppID, appName ve appSessionId gibi bazı ek değerler de vardır.

    Özel boyutları genişletme.

  5. Aşağıdaki sorgu sorgusu ile JSON özel boyutlarının özelliklerini genişletebilir ve sonuçlar görünümündeki sütunları proje olarak görüntüleyebilirsiniz.

    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 sorgusunu genişletme.

    İpucu

    Günlük sorguları oldukça güçlüdür. Birden çok tabloya katılmak, büyük miktarlarda veri toplamak ve karmaşık işlemler gerçekleştirmek için bunları kullanabilirsiniz. Daha fazla bilgi için Günlük sorgularını okuyun.

Verileri Power BI'e dışa aktarma

Application Insights Veri ve sorgu sonuçlarınızı Power BI çözümleme ve veri sunusu için uygulamasına verebilirsiniz.

  1. Azure portalında oturum açın ve önceden oluşturduğunuz Application Insights kaynağı açın:

  2. İzleme altındaki günlükleri sol gezinti bölmesinde seçin:

  3. Günlük Analizi sorgu penceresinde, dışa aktar açılan menüsünü seçin.

  4. Uygulamasına Power BI'a aktar (M sorgusu) seçeneğini belirleyin. Bu işlem makinenize bir Power BI sorgu dosyası yükleyecek:

    Power BI sorgusunu dışarı aktarma.

  5. İndirilen dosyayı bir metin düzenleyicide açın ve sorguyu panoya kopyalayın.

  6. Power BI açın.

  7. Giriş şeridinde veri al açılır menüsünü seçin ve boş sorgu'u seçin.

    Power BI boş sorgusu.

  8. Sorgu penceresinde Gelişmiş Düzenleyici'yi seçin. Adım 5'ten penceresine sorguyu yapıştırın, Bitti'yi seçin ve ardından Kapat ve uygula öğesini seçin:

    Power BI gelişmiş sorgusu.

  9. Uygulamanızda alınan geri bildirimleri temsil etmek için Power BI uygulamasında grafikler ve görsel öğeler oluşturabilir ve bunlara veri tabanlı kararlar ve eylemler yapabilirsiniz.

    Grafikler ve görselleştirmeler.

Varsayılan İzleme olayı bağlamı ve boyutları

Her izleme olayında customDimensions özelliğine de bir dizi varsayılan boyutlar eklenir. Bu boyutlar, uygulamasında olayların oluştuğu uygulama ve uygulama oturumlarını tanımlamak için kullanılabilir. Diğer özel verileri izleme işlevini kullanarak günlüğe kaydederseniz, bunlar da özel boyutlarda görüntülenir.

Boyut Adı Temsil eder:
ms-appId Olayı gönderen uygulamanın uygulama kimliği.
ms-appName Olayı gönderen uygulamanın uygulama adı.
ms-appSessionId Uygulama oturum kimliği.

Desteklenmeyen senaryolar

App Insights aşağıdaki senaryoları desteklemez.

  • Çevrimdışı ve mobil uygulamalar/yürütücü olayları (hem Android hem iOS) yakalanmaz.
  • Ağ istekleri ve hataları yakalanmaz.
  • GCC ve ortak olmayan bulutlar desteklenmez.