Analysieren Sie vom System generierte Protokolle mit Application Insights

Sie können Ihre Canvas-Apps mit Application Insights, einer Funktion von Azure Monitor, verbinden. Application Insights enthält leistungsstarke Analysetools, mit denen Sie Probleme diagnostizieren und verstehen können, was Benutzer tatsächlich mit Ihren Apps tun. Sie können Informationen sammeln, um bessere Geschäftsentscheidungen zu treffen und die Qualität Ihrer Apps zu verbessern.

In dieser Schnellstartanleitung verwenden wir eine Canvas-App namens Kudos, um Konzepte systemgenerierter Protokolle in Canvas-Apps zu erkunden und sie auf Ihre Apps anzuwenden. Die Beispiel-App Kudos ist Teil mehrerer Apps für die Mitarbeiterbindung, die im Rahmen des Employee Experience Starter Kit zum Download bereit stehen.

Anforderungen

• Sie müssen Zugriff auf Azure-Portal haben.
• Sie müssen die Berechtigungen haben für das Erstellen von Azure-Ressourcen.

Optional

• Laden Sie die Kudos-App herunter vom Employee Experience Starter Kit. Sie können stattdessen auch eine vorhandene App verwenden.

Eine Application Insights Ressource erstellen

Bevor Sie systemgenerierte Protokolle von einer 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:

   

3. Eine Application Insights Ressource erstellen:

   

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.

   

5. Nach dem die Application Insights-Instanz erstellt wurde, kopieren Sie den Instrumentierungsschlüssel in der Instanzübersicht zur Verwendung in einem nächsten Schritt.

   

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 aus der Liste der Apps die Kudos-App und dann Bearbeiten aus:

   

   Hinweis

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

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

   

4. Speichern und Veröffentlichen Ihrer App.

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

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

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

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

   Die Benutzer-Ansicht zeigt die Nutzungsdetails der App wie:

   • Anzahl der Benutzer, die die App angesehen haben
   • Anzahl von Benutzersitzungen
   • Anzahl der protokollierten Ereignisse
   • Betriebssysteme und Browserversionsdetails der Benutzer
   • Region und Standort der Benutzer

   Weitere Informationen zur 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:

   

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

   

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. Die Trace-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. Ablaufverfolgungsnachrichten, die an Application Insights gesendet werden, haben einen von drei Schweregraden:

• Information
• Warnung
• Error

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 ausführen.

Erstellen Sie jetzt eine neue Komponente in Ihrer App, um Feedback zu jedem Bildschirm zu sammeln, und schreiben Sie die Ereignisse in Application Insights.

1. Melden Sie sich bei Power Apps an.

2. Wählen Sie im linken Navigationsbereich die Option Apps aus. Wählen Sie aus der Liste der Apps die Kudos-App und dann Bearbeiten aus.

   Hinweis

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

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

   

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

   

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

   

6. Wählen Sie Neue benutzerdefinierte Eigenschaft, um eine benutzerdefinierte Eigenschaft zu 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:

   

   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 Sie Weitere Aktionen (…) und wählen Sie dann Umbenennen, um die Komponente mit einem aussagekräftigen Namen wie FeedbackComponent umzubenennen.

    

11. Wählen Sie die Symbole aus, wählen Sie Weitere 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 your feedback!");
    

    

    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 your feedback!");
    

14. Fügen Sie die Komponente einem der Bildschirme in Ihrer App hinzu:

    

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.

    

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.

   

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

   

3. Geben Sie die folgende Abfrage ein und wählen Sie Ausführen aus, um das von Ihrer App erhaltene Feedback anzuzeigen:

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

   

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 Werte für jedes Ereignis aufgezeichnet, das an Application Insights gesendet wird, wie appId, appName und appSessionId.

   

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
   

   

   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 zu Protokollabfragen.

Nicht behandelte Fehler überwachen (experimentell)

[Dieser Abschnitt enthält eine Vorabversionsdokumentation und kann sich ändern.]

Sie können nicht immer alle Fehler vorhersehen und planen, die während der Ausführung Ihrer App auftreten können. Unbehandelte Power Fx-Formelfehler werden den Benutzern als Bannermeldungen gemeldet. Sie können auch Application Insights gemeldet werden, damit Sie deren Häufigkeit und Schwere verstehen können, ohne sich darauf verlassen zu müssen, dass die Benutzer Ihrer App Probleme melden. Sie können auch Echtzeitwarnungen einrichten, wenn Laufzeitfehler auftreten, um proaktiver vorzugehen.

Fehlerübergabe an Application Insights aktivieren

Sie müssen die Einstellung aktivieren, die es Power Apps erlaubt, nicht behandelte Laufzeitfehler an Azure Application Insights zu übergeben.

Um die Fehlerübergabe zu aktivieren, gehen Sie zu Einstellungen > Kommende Funktionen > Experimentell > Fehler an Azure Application Insights übergeben und lassen Sie dabei Ihre Canvas-App zur Bearbeitung offen. §Speichern und veröffentlichen Ihre Anwendung.

Fehlerereignisse in Application Insights

Unbehandelte Power Fx-Fehler, die bei Benutzern während der App-Laufzeit auftreten, werden der Tabelle Ablaufverfolgungen gemeldet. Unbehandelte Fehler können durch die Ereignismeldung „Unbehandelter Fehler“ identifiziert und von anderen Fehlerereignissen unterschieden werden. Die Dimension „severityLevel“ dieser Ereignisse ist 3 (TraceSeverity.Error).

Detaillierte Fehlermeldungen finden Sie in der Dimension „Fehler“ der Eigenschaft customDimension. In Situationen, in denen während desselben Vorgangs mehrere Fehler aufgetreten sind, werden die Fehler in der Dimension „Fehler“ eines einzelnen Ablaufverfolgungsereignisses konsolidiert. Die Fehlermeldungen sind die gleichen wie in Monitor während einer Live-Debugsitzung.

Die folgende Beispielabfrage identifiziert nicht behandelte Fehler und erweitert alle im Ablaufverfolgungsereignis enthaltenen Fehlermeldungen:

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

Korrelationsverfolgung (experimentell)

[Dieser Abschnitt enthält eine Vorabversionsdokumentation und kann sich ändern.]

Verbindungen mit externen Daten und Diensten sind für die meisten Apps von grundlegender Bedeutung. Durch die Korrelationsverfolgung werden Kontextinformationen generiert und weitergegeben, um vom System generierte Protokolle über eine Canvas-App und ihre Verbindungen hinweg zu verknüpfen, vorbehaltlich bestimmter Einschränkungen. Beispielsweise kann Ihre App einen benutzerdefinierten Konnektor aufrufen, der wiederum eine Azure-Funktion oder eine andere REST-API aufruft. Mithilfe der Korrelationsverfolgung können Sie in der App vorgenommene Aktionen mit den zugrunde liegenden API-Aufrufen über Ebenen hinweg korrelieren. Dies kann bei der Fehlerbehebung nützlich sein.

Die Korrelationsverfolgung der Canvas-App ist eine Implementierung der Kontextverfolgung und folgt der W3C-Spezifikation.

Korrelationsablaufverfolgung aktivieren

Um die Korrelationsverfolgungsfunktion zu aktivieren, gehen Sie zu Einstellungen > Kommende Funktionen > Experimentell > Azure Application Insights-Korrelationsverfolgung aktivieren, während Sie Ihre Canvas-App zur Bearbeitung geöffnet lassen. §Speichern und veröffentlichen Ihre Anwendung.

Einschränkungen

• Die Korrelationsverfolgung ist nur für benutzerdefinierte Connectors verfügbar. Andere Connector-Typen werden nicht unterstützt.
• HTTP-Anforderungen werden in Application Insights nur erfasst, wenn der verbundene Dienst auch mit Application Insights verbunden ist.

Korrelationsablaufverfolgung verwenden

Wenn die Korrelationsverfolgung aktiviert ist, wird ein neues, vom System generiertes Protokollereignis in der Tabelle Abhängigkeiten der Application Insights-Instanz der Canvas-App hinzugefügt. Dieses Ereignis wird zu dem Zeitpunkt aufgezeichnet, zu dem eine Antwort von einem Netzwerkaufruf empfangen wird. Abhängigkeitsereignisse erfassen Details des Netzwerkaufrufs, einschließlich der Anforderungs- und Antwortheader, des Antwortstatuscodes und der Dauer des Anrufs.

Wenn der verbundene Dienst auch mit Application Insights verbunden ist, wird ein zusätzliches vom System generiertes Protokollereignis, das die Anforderung erfasst, in der Tabelle Anforderungen der Application Insights-Instanz des Dienstes generiert. Einige Azure-Dienste, wie z. B. Azure Functions, können ohne Programmieraufwand über das Azure-Portal verbunden werden. Es können sowohl Canvas-Apps als auch mehrere Apps und verbundene Dienste mit derselben Application Insights-Instanz verbunden werden.

Netzwerkaufrufe für unterstützte Connectors können mit anderen vom System generierten Protokollen in der Dimension „operation_Id“ verknüpft werden. Die folgende Beispielabfrage zeigt einen Netzwerkaufruf, der zusammen mit Ablaufverfolgungsereignissen erfolgt, die während einer App-Sitzung ausgegeben werden.

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

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 im linken Navigationsbereich:

3. Wählen Sie im Abfragefenster für die Protokollanalyse das Menü Export aus.

4. Wählen Sie Option zum Exportieren nach Power BI (M-Abfrage) aus, um eine Power BI- Abfragedatei herunterzuladen:

   

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 das Menü Daten empfangen im Menüband Home und dann Leere Abfrage aus:

   

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

   

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.

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 Trace-Funktion protokollieren, werden diese auch in den benutzerdefinierten Dimensionen angezeigt.

Nicht unterstützte Szenarien

Application Insights unterstützt die folgenden Szenarien nicht.

• Offline-Player-Ereignisse werden nicht erfasst.
• Ereignisse in mobilen Apps (sowohl iOS als auch Android) werden nicht erfasst, wenn die App angehalten wird.
• GCC und nicht öffentliche Clouds werden nicht unterstützt.