Analysieren Sie die Telemetrie einer Canvas-App mit Application Insights

Sie können Ihre App mit Application Insights verbinden, ein Funktion von Azure Monitor. Application Insights enthält leistungsstarke Analysetools, mit denen Sie Probleme diagnostizieren und verstehen können, was Benutzer tatsächlich mit Ihrer App tun.

Wenn Ihre App mit Applications Insights verbunden ist, können Sie Informationen sammeln, um bessere Geschäftsentscheidungen zu treffen und die Qualität Ihrer Apps zu verbessern.

In diesem Schnellstart erstellen Sie ein Canvas-App namens Kudos. Auf diese Weise können Sie Telemetriekonzepte erkunden, entdecken und auf Ihre eigenen Canvas-Apps anwenden. Die Beispiel-App Kudos ist Teil mehrerer Apps für die Mitarbeiterbindung, die im Rahmen des Mitarbeiter-Erfahrungs-Startersets zum Download bereit stehen.

Voraussetzungen

Optional

Eine Application Insights Ressource erstellen

Bevor Sie Telemetrie für eine App senden können, müssen Sie eine Application Insights Ressource zum Speichern der Ereignisse erstellen.

  1. Melden Sie sich beim Azure-Portal an.

  2. Suchen Sie nach Application Insights:

    Application Insights

  3. Eine Application Insights Ressource erstellen:

    Eine Application Insights-Ressource hinzufügen

  4. Geben Sie die entsprechenden Werte ein und wählen Sie Überprüfen + erstellen. Weitere Informationen finden Sie unter Erstellen Sie eine Application Insights Ressource.

    Eine Ressource erstellen

  5. Wenn die Application Insights Instanz erstellt wird, wird die Instanzübersicht angezeigt. Kopieren Sie den Instrumentierungsschlüssel. Sie benötigen diesen Schlüssel, um Ihre App zu konfigurieren.

    Instrumentierungsschlüssel kopieren

Verbindung Ihrer App mit Application Insights

  1. Melden Sie sich bei Power Apps an.

  2. Wählen Sie im linken Navigationsbereich die Option Apps aus. Wählen Sie von der Liste der Apps Kudos aus der Liste der Anlagen aus, und klicken Sie dann auf Bearbeiten.

    Kudos-App bearbeiten

    Hinweis

    Sie können auch eine neue App erstellen oder eine bestehende App bearbeiten.

  3. Wählen Sie das App Objekt aus der linken Navigationsbaumansicht und fügen Sie den Instrumentierungsschlüssel hinzu:

    Instrumentierungsschlüssel hinzufügen

  4. Speichern und Veröffentlichen Ihrer App.

  5. Abspielen der veröffentlichte App und durchsuchen der verschiedenen Bildschirme.

Beim Durchsuchen verschiedener Bildschirme werden Ereignisse automatisch protokolliert in Application Insights, einschließlich der Verwendungsdetails wie:

  • Von wo auf die App zugegriffen wird.
  • Welche Geräte werden verwendet.
  • Die verwendeten Browsertypen.

Wichtig

Sie müssen die veröffentlichte App abspielen, um Ereignisse an Application Insights zu senden. Ereignisse werden nicht an Application Insights gesendet, wenn Sie die App in Power Apps Studio Vorschau betrachten.

Ereignisse anzeigen in Application Insights

  1. Melden Sie sich beim Azure-Portal an und öffnen Sie die Application Insights Ressource, die Sie zuvor erstellt haben.

  2. Scrollen Sie im linken Navigationsbereich nach unten und wählen Sie Benutzer im Bereich Nutzung.

    Hinweis

    Benutzer Ansicht zeigt die Nutzungsdetails der App wie:

    • Anzahl der Benutzer, die die App angesehen haben.
    • Anzahl der Sitzungen der Benutzer für die App.
    • Anzahl der für die App protokollierten Ereignisse.
    • Betriebssysteme und Browserversionsdetails der Benutzer.
    • Region und Standort der Benutzer.

    Weitere Informationen finden Sie unter Benutzer-, Sitzungs- und Ereignisanalyse in Application Insights.

  3. Wählen Sie eine der Benutzersitzungen aus, um bestimmte Details zu untersuchen. Sie können Informationen wie die Sitzungslänge und die besuchten Bildschirme anzeigen:

    Nutzungsdetails für Benutzer

  4. Wählen Sie Ereignis Ansicht im linken Navigationsbereich unter Nutzung. Sie können eine Zusammenfassung aller Bildschirme anzeigen, die in allen App-Sitzungen angezeigt werden:

    Ereignisdetails für die App

Tipp

Einige der zusätzlichen Application Insights Funktionen, die Sie verwenden können, sind:

Erstellen Sie benutzerdefinierte Ablaufverfolgungsereignisse

Sie können benutzerdefinierte Rückverfolgungen direkt in Application Insights schreiben und beginnen, die Informationen, die für Ihr Szenario spezifisch sind, zu analysieren. Rückverfolgung Funktion ermöglicht es Ihnen zu sammeln:

  • Detaillierte Verwendungsinformationen für Steuerelemente auf den Bildschirmen.
  • Welche bestimmten Benutzer greifen auf Ihre App zu.
  • Welche Fehler treten auf.

Die Nachverfolgung kann auch bei der Diagnose von Problemen hilfreich sein, da Sie eine Spur von Informationen senden können, während Ihre Benutzer Ihre App durchsuchen und verschiedene Aktionen ausführen.

Es gibt drei Schweregrade für Nachverfolgungsnachrichten, wenn benutzerdefinierte Ablaufnachverfolgungsinformationen an Application Insights aus Ihrer App gesendet werden:

  • Informationen
  • Warnung
  • Fehler

Abhängig von Ihrem Szenario können Sie eine Nachverfolgungsnachricht mit dem entsprechenden Schweregrad senden. Sie können die Daten abfragen und bestimmte Aktionen basierend auf dem Schweregrad der Nachricht ausführen.

Hinweis

Wenn Sie Personaldaten protokollieren, müssen Sie alle Datenkonformitätsverpflichtungen wie DSGV berücksichtigen, die Sie möglicherweise auch implementieren müssen.

Sie aktualisieren jetzt Ihre App und erstellen eine neue Komponente, um Feedback zu jedem Bildschirm der App zu sammeln. Sie schreiben die Ereignisse an Application Insights.

  1. Melden Sie sich bei Power Apps an.

  2. Wählen Sie im linken Navigationsbereich die Option Apps aus. Wählen Sie von der Liste der Apps Kudos aus der Liste der Anlagen aus, und klicken Sie dann auf Bearbeiten.

    Hinweis

    Sie können auch eine neue App erstellen oder eine bestehende App bearbeiten.

  3. Wählen sie die Option Komponenten aus der Baumsicht:

    Komponenten

  4. Wählen Sie Neue Komponente und ändern Sie dann die Breite auf 200 und die Höhe auf 75:

    Höhe und Breite

  5. Wählen Sie Einfügen aus dem Menü und wählen Sie dann Symbole hinzufügen Emoji .- Stirnrunzeln und Emoji – Lächeln:

    Symbole hinzufügen

  6. Wählen Sie Neue benutzerdefinierte Eigenschaft, um eine benutzerdefinierte Eigenschaft zu erstellen:

    Benutzerdefinierte Eigenschaft erstellen

  7. Eigenschaft Name und Anzeigename sowie FeedbackSceen eingeben.

  8. Beschreibung der Eigenschaft eingeben.

  9. Wählen Sie Art der Eigenschaft als Eingang und Datentyp als Bildschirm:

    Benutzerdefinierte Eigenschaft

    Hinweis

    Mit der Eingabeeigenschaft können Sie den Bildschirmnamen und seine Komponente erfassen, um diese Informationen zu protokollieren in Application Insights.

  10. Wählen Sie die Komponente auf der Baumsicht, wählen Mehr Aktionen (..) und wählen Sie dann Umbenennen, um die Komponente mit einem aussagekräftigen Namen wie FeedbackComponente umzubenennen.

    Komponente und Symbole umbenennen

  11. Wählen Sie die Symbole aus, wählen Sie Mehr Aktionen (...) und wählen Sie dann Umbenennen, um die Symbole mit aussagekräftigen Namen umzubenennen, wie FrownIcon und SmileIcon.

  12. Wählen FrownIcon, wählen Sie die Eigenschaft OnSelect und geben Sie dann den folgenden Ausdruck in die Formelleiste ein:

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

    Formel für Stirnrunzeln-Symbol

    Hinweis

    Der Formelausdruck sendet Nutzername, Benutzer E-Mail, Bildschirm und Feedback (mit dem Wert -1) an Application Insights.

  13. Wählen Sie SmileIcon, wählen Sie die Eigenschaft OnSelect und geben Sie dann den folgenden Ausdruck in die Formelleiste ein:

    Trace(
       "App Feedback",
       TraceSeverity.Information,
           {
             UserName: User().FullName,
             UserEmail: User().Email,
             Screen: FeedbackComponent.FeedbackScreen.Name,
             FeebackValue: "1"
           }
         );
    Notify("Thanks for you feedback!");
    
  14. Fügen Sie die Komponente einem der Bildschirme in Ihrer App hinzu:

    Feedback-Komponente hinzufügen

  15. Wählen Sie dann Speichern und Veröffentlichen, um Ihre App zu speichern und zu veröffentlichen.

  16. Spielen Sie die veröffentlichte App ab und senden Sie ein Lächeln und ein Stirnrunzeln von Ihren Bildschirmen aus.

    Wichtig

    Sie müssen die veröffentlichte App abspielen, um Ereignisse an Application Insights zu senden. Ereignisse werden nicht an Application Insights gesendet, wenn Sie die App in Power Apps Studio Vorschau betrachten.

    Veröffentlichte App abspielen

Analysieren der Daten in Application Insights

Sie können nun mit der Analyse der von Ihnen gesendeten Daten beginnen mit der Nachverfolgen Funktion von Ihrer App in Application Insights.

  1. Melden Sie sich beim Azure-Portal an und öffnen Sie die Application Insights Ressource, die Sie zuvor erstellt haben:

    Application Insights auswählen

  2. Wählen Sie Protokolle unter Überwachung aus dem linken Navigationsbereich:

    Protokolle auswählen

  3. Geben Sie die folgende Abfrage ein, und wählen Sie Ausführen aus. Das von Ihrer App erhaltene Feedback wird zurückgegeben:

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

    App-Feedback anzeigen

  4. Wählen Sie eine Zeile in den Ergebnissen aus und erweitern Sie die das customDimensions Feld.

    Die Werte für Bildschirm, Nutzername, Benutzer E-Mail, und FeedbackValue für das OnSelect Ereignissymbol Lächeln oder Stirnrunzeln in Ihrer Komponente wurde aufgezeichnet.
    Es werden auch einige zusätzliche Werte für jedes Ereignis aufgezeichnet, das an Application Insights gesendet wird, wie appId, AppName, und appSessionId.

    Benutzerdefinierte Dimensionen erweitern

  5. Mit der folgenden Beispielabfrage können Sie die Eigenschaften der benutzerdefinierten JSON-Dimensionen erweitern und die Spalten in der Ergebnisansicht projizieren.

    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-Abfrage erweitern

    Tipp

    Protokollabfragen sind extrem mächtig. Sie können sie verwenden, um mehrere Tabellen zu verknüpfen, große Datenmengen zu aggregieren und komplexe Vorgänge auszuführen. Weitere Informationen erhalten Sie in diesem Element Protokollabfragen.

Exportieren von Daten nach Power BI

Sie können Ihre exportieren Application Insights Daten und Abfrageergebnisse an Power BI zur Analyse und Datenpräsentation senden.

  1. Melden Sie sich beim Azure-Portal an und öffnen Sie die Application Insights Ressource, die Sie zuvor erstellt haben:

  2. Wählen Sie Protokolle unter Überwachung aus dem linken Navigationsbereich:

  3. Wählen Sie im Abfragefenster für die Protokollanalyse die Option aus dem Dropdown-Menü Export.

  4. Wählen sie aus der Option Exportieren nach Power BI (M-Abfrage). Dies wird eine Power BI Abfragedatei auf Ihrem Computer herunterladen:

    Power BI-Abfrage exportieren

  5. Öffnen Sie die heruntergeladene Datei in einem Texteditor und kopieren Sie die Abfrage in die Zwischenablage.

  6. Öffnen Sie Power BI.

  7. Wählen Sie aus dem Dropdwon-Menü im Menüband Daten empfangen und wählen Sie Home und Leere Abfrage:

    Leere Power BI-Abfrage

  8. Wählen Sie Erweiterter Editor im Abfrageeditor. Fügen Sie die Abfrage aus Schritt 5 in das Fenster ein und wählen Sie Fertig und dann Schließen & Übernehmen:

    Erweiterte Power BI-Abfrage

  9. Sie können auch Diagramme und Visualisierungen in Power BI erstellen, um das in Ihrer App erhaltene Feedback darzustellen und datenbasierte Entscheidungen und Aktionen treffen.

    Diagramme und Visualisierungen

Standardkontext und -dimensionen des nachverfolgten Ereignisses

Eine Reihe von Standardabmessungen wird ebenfalls zur Eigenschaft customDimensions bei jedem nachverfolgten Ereignis hinzugefügt. Diese Dimensionen können verwendet werden, um die Anwendung und die Anwendungssitzungen zu identifizieren, in denen die Ereignisse aufgetreten sind. Wenn Sie zusätzliche benutzerdefinierte Daten mithilfe der Nachverfolgungsfunktion protokollieren, werden diese auch in den benutzerdefinierten Dimensionen angezeigt.

Dimensionsname Repräsentiert
ms-appId Die Anwendungs-ID der App, die das Ereignis gesendet hat.
ms-appName Der Anwendungs-Name der App, die das Ereignis gesendet hat.
ms-appSessionId Die Anwendungs-Sitzungs-ID.

Nicht unterstützte Szenarien

App Insights unterstützt die folgenden Szenarien nicht.

  • Offline- und mobile Apps/Player-Events (beide Android und iOS) werden nicht erfasst.
  • Netzwerkanforderungen und Fehler werden nicht erfasst.
  • GCC und nicht öffentliche Clouds werden nicht unterstützt.