Qu’est-ce que App Analytics ?
Aperçu
Cette fonctionnalité est en aperçu privé. Pour l’essayer, veuillez contacter votre interlocuteur Databricks.
App Analytics aide les propriétaires d’applications à comprendre quelles pages les visiteurs consultent, quelles actions ils effectuent et comment l’application se comporte dans leurs navigateurs. Utilisez la page Analytics de votre application Databricks pour explorer l’utilisation, analyser les performances du navigateur et inspecter les événements récents.
Le tableau de bord combine les événements envoyés par votre application et les informations d’accès à l’application collectées par Databricks. Vous n’avez pas besoin d’une bibliothèque client spécifique pour envoyer des événements d’analytique. N’importe quel producteur qui respecte le schéma d’événement peut les fournir.
Requirements
L’accès à App analytique et la configuration de la télémétrie sont soumis à des exigences distinctes.
Configurer la télémétrie
Activez la télémétrie de l’application et redéployez-la avant d’envoyer des événements d’analytique. Pour connaître les régions prises en charge, les exigences relatives à la table de destination et les autorisations de configuration, consultez Requirements et Enable app telemetry.
La télémétrie crée ou réutilise la table otel_logs dans le catalogue et le schéma que vous sélectionnez. Si vous configurez un préfixe de table, utilisez la table <prefix>_otel_logs correspondante.
Afficher l'analytique
La personne qui ouvre Analytique doit disposer des accès suivants :
CAN MANAGEsur l'application.USE CATALOGsur le catalogue,USE SCHEMAsur le schéma etSELECTsur la table des logs de télémétrie.- Accès SQL et
CAN USEsur le SQL warehouse utilisé pour interroger la table.
L'accès à l'application n'accorde pas automatiquement l'accès à sa table de télémétrie ou à son warehouse. Consultez la section Configurer les autorisations pour une application Databricks.
Ouvrez l'analytique et finalisez la configuration
- Ouvrez la page de détails de votre application.
- Sélectionnez Analytique dans la navigation de l’application.
- Sélectionnez un SQL Warehouse pour interroger la table de télémétrie.
- Si l’installation est incomplète, suivez la page d’intégration pour configurer la télémétrie, envoyer des événements et vérifier que les événements sont bien arrivés. Consultez Get started with App analytique.
Analytique affiche une page d’autorisation dédiée lorsque vous ne pouvez pas accéder à l’application ou à ses sources de données. Suivez les conseils pour la ressource qui nécessite un accès. Selon l’autorisation manquante, demandez l’accès à la table ou copiez la demande d’accès pour le propriétaire de la ressource. Une fois l’accès accordé, vérifiez à nouveau. Une erreur d’autorisation ne signifie pas que vous devez configurer à nouveau la télémétrie.
La page d’intégration et la page d’autorisation répondent à des conditions différentes. L’intégration vous aide à configurer la télémétrie et à recevoir vos premiers événements. La page d’autorisation vous aide à obtenir l’accès à des ressources qui sont peut-être déjà configurées.
Explorez le tableau de bord
Sélectionnez une période et un warehouse pour votre analyse. Les Overview et Web Vitals tab affichent des données historiques pour la plage sélectionnée. Utilisez refresh pour récupérer les résultats mis à jour.
Présentation
L'onglet Overview tab affiche le nombre de vues de pages, de sessions, d'actions suivies, de pages par session et de visualiseurs uniques. Il indique également le trafic au fil du temps, les pages fréquemment visitées et les actions fréquemment enregistrées.
La capture d’écran suivante montre les rubriques Top pages et Top actions , y compris l’action Analyze .
Les sessions et les spectateurs uniques mesurent des éléments différents :
- Sessions : fenêtres d'activité analytique identifiées par
session_id. Une session n'est pas une personne. Le schéma d'événements rendsession_idoptionnel. L'analyse basée sur les sessions dépend de leur fourniture par les producteurs. - Unique viewers : informations sur le visualiseur provenant des logs d'accès à l'application, distinctes du schéma d'événements analytique personnalisé. L'envoi d'événements analytique ne crée pas d'identité d'utilisateur.
Pour une action suivie, sélectionnez Analyze pour inspecter son volume, ses sessions, ses routes et les actions environnantes. Lorsque Genie Code est disponible, utilisez le transfert pour poursuivre l’investigation. Examinez le prompt préparé dans Genie Code avant de l’envoyer.
Web Vitals
Le tab Web Vitals affiche les mesures de performance du navigateur, les distributions des notes, les tendances et les résultats par route. Sélectionnez une métrique pour inspecter ses thresholds et la taille de son échantillon.
Le default percentile est le 75e percentile (p75) : 75 % des échantillons ont une valeur inférieure ou égale à celui-ci. Vous pouvez également sélectionner p50, p90 ou p99 dans la vue détaillée des métriques.
La capture d’écran suivante montre la vue détaillée pour Largest Contentful Paint (LCP).
Les Core Web Vitals sont le LCP, l’Interaction to Next Paint (INP) et le Cumulative Layout Shift (CLS). La page comprend également le First Contentful Paint (FCP) et le Time to First Byte (TTFB). Voir les règles Web Vital.
Traitez les résultats basés sur moins de 30 échantillons comme indicatifs. Une valeur affichée n’établit pas de tendance fiable.
Événements en direct
L’onglet Live Events récupère périodiquement les événements récents. Utilisez ses filtres pour inspecter les types d’événements, les noms et les routes, et ouvrez un événement pour afficher ses détails.
Cette vue utilise un tampon d'événements borné. Il ne s'agit pas d'un export exhaustif de la table de télémétrie. Pour une analyse historique au-delà des événements affichés, query directement la table.
Collecter des événements d’analytique
Votre application doit envoyer les types d’événements suivants pour alimenter l’utilisation et l’analyse des performances du navigateur :
Type d'événement | Ce qu'il enregistre |
|---|---|
| Interaction ou résultat nommé, tel qu’un export de rapport. |
| Une visite d’une route d’application. |
| Mesure des performances du navigateur. |
L’activation de la télémétrie n’instrumente pas automatiquement les routes ou les actions métiers de votre application. Ajoutez une instrumentation ou utilisez un producteur qui implémente le schéma d’événement. Consultez start avec App analytique.
Le diagramme suivant indique le chemin des événements d’analytique générés par l’application. L’information utilisateur utilise une source d’accès à l’application distincte.
- Le navigateur envoie un événement au backend de votre application.
- Le backend exporte un enregistrement de log OpenTelemetry (OTel) vers le collecteur exécuté aux côtés de l’application.
- Le collecteur écrit l’enregistrement dans
otel_logsdans Unity Catalog. - Analytics interroge la table à l'aide d'un SQL Warehouse.
Utilisez l’endpoint et le transport pris en charge par le runtime de votre application. N’exposez pas le collecteur directement aux navigateurs. Pour les variables d’environnement injectées, consultez Variables d’environnement de télémétrie de l’application.
Limitations et gestion des données
Les événements d’analytique prennent en charge l’analyse de produit. Il ne s’agit pas d’enregistrements de transactions faisant foi ni de logs de sécurité pour l’audit. La livraison est effectuée au mieux, de sorte que des événements peuvent être perdus ou livrés plus d’une fois.
Désinfectez les noms, les chemins et les propriétés des événements avant de les envoyer. N'incluez pas d'identifiants, de données personnelles ou de texte saisi par l'utilisateur. Le filtrage côté query ne supprime pas les données sensibles qu'un producteur a déjà écrites dans la table de télémétrie sous-jacente.
L’ingestion de télémétrie et les query de SQL Warehouse utilisent les Ressources de la plateforme. Pour plus de détails sur la facturation de la télémétrie, consultez la page Tarifs.