Données RUM recueillies (Android)
Présentation
Le SDK RUM Android génère des événements auxquels des métriques et attributs sont associés. Les métriques sont des valeurs quantifiables servant à effectuer des mesures associées à un événement. Les attributs sont des valeurs non quantifiables servant à filtrer les données de métriques dans les analyses.
Chaque événement RUM contient tous les attributs par défaut, comme le type d’appareil (device.type) et des informations sur l’utilisateur telles que son nom (usr.name) et son pays (geo.country).
Il existe d’autres métriques et attributs propres à un type d’événement donné. Par exemple, la métrique view.time_spent est associée aux événements de type « vue » et l’attribut resource.method aux événements de type « ressource ».
| Type d’événement | Rétention | Description |
|---|
| Session | 30 jours | Une session représente le parcours d’un utilisateur réel sur votre application mobile. Elle débute lorsque l’utilisateur lance l’application et se poursuit tant qu’il reste actif. Lors du parcours de l’utilisateur, tous les événements RUM générés au sein de la session partagent le même attribut session.id. Remarque : la session se réinitialise après 15 minutes d’inactivité. Si l’application est arrêtée par le système d’exploitation, vous pouvez réinitialiser la session pendant que l’application est exécutée en arrière-plan. |
| Vue | 30 jours | Une vue représente un écran unique (ou un segment d’écran) de votre application mobile. Une vue est lancée et mise en pause lorsque les callbacks onActivityResumed et onActivityPaused sont effectués via l’interface ActivityLifecycleCallbacks. Chaque occurrence est considérée comme une vue distincte. Tant que l’utilisateur reste sur une vue, des attributs d’événement RUM (Erreurs, Ressources et Actions) sont joints à la vue, avec un view.id unique. |
| Ressource | 15 jours | Une ressource représente les requêtes réseau envoyées par votre application mobile à des hosts first party, des API et des fournisseurs tiers. Toutes les requêtes générées lors d’une session utilisateur sont jointes à la vue, avec un resource.id unique. |
| Error | 30 jours | Une erreur représente une exception ou une défaillance générée par l’application mobile et jointe à la vue à son origine. |
| Action | 30 jours | Une action représente une activité utilisateur dans votre application mobile (par exemple, le lancement de l’application ou une action de toucher, de balayage ou de retour). Chaque action possède un action.id unique joint à la vue à son origine. |
| Tâche longue | 15 jours | Un événement de tâche longue est généré lorsqu’une tâche bloque dans l’application le thread principal pendant une durée supérieure au seuil défini. |
Le schéma suivant présente la hiérarchie des événements RUM :
Attributs par défaut
La solution RUM recueille automatiquement des attributs communs pour tous les événements, ainsi que des attributs propres à chaque événement, tel qu’indiqué ci-dessous. Vous pouvez également choisir d’enrichir les données de vos sessions utilisateur en surveillant d’autres événements ou en ajoutant des attributs personnalisés aux événements par défaut, selon vos besoins en analytique métier et en surveillance de votre application.
Attributs communs de base
| Nom de l’attribut | Type | Description |
|---|
date | nombre entier | Le début de l’événement en millisecondes (format epoch). |
type | chaîne | Le type de l’événement (par exemple, view ou resource). |
service | chaîne | Le nom de service unifié de cette application utilisé pour corréler les sessions utilisateur. |
application.id | chaîne | L’ID d’application Datadog. |
Appareil
Les attributs sur l’appareil suivants sont joints automatiquement à tous les événements recueillis par Datadog :
| Nom de l’attribut | Type | Description |
|---|
device.type | chaîne | Le type d’appareil indiqué par l’appareil (User-Agent système) |
device.brand | chaîne | La marque d’appareil indiquée par l’appareil (User-Agent système) |
device.model | chaîne | Le modèle d’appareil indiqué par l’appareil (User-Agent système) |
device.name | chaîne | Le nom d’appareil indiqué par l’appareil (User-Agent système) |
connectivity.status | chaîne | Le statut de l’accessibilité au réseau de l’appareil (connected, not connected ou maybe). |
connectivity.interfaces | chaîne | La liste des interfaces réseau disponibles (par exemple, bluetooth, cellular, ethernet ou wifi). |
connectivity.cellular.technology | chaîne | Le type de technologie radio utilisée pour la connexion cellulaire. |
connectivity.cellular.carrier_name | chaîne | Le nom de l’opérateur de la carte SIM. |
Système d’exploitation
Les attributs sur le système d’exploitation suivants sont joints automatiquement à tous les événements recueillis par Datadog :
| Nom de l’attribut | Type | Description |
|---|
os.name | chaîne | Le nom du système d’exploitation indiqué par l’appareil (User-Agent système). |
os.version | chaîne | La version du système d’exploitation indiquée par l’appareil (User-Agent système). |
os.version_major | chaîne | La version majeure du système d’exploitation indiquée par l’appareil (User-Agent système). |
Géolocalisation
Les attributs ci-dessous sont liés à la géolocalisation des adresses IP :
Remarque : si vous souhaitez arrêter de recueillir les attributs de géolocalisation, modifiez le paramètre correspondant dans les détails de votre application.
| Nom complet | Type | Description |
|---|
geo.country | chaîne | Le nom du pays. |
geo.country_iso_code | chaîne | Le code ISO du pays (par exemple, US pour les États-Unis ou FR pour la France). |
geo.country_subdivision | chaîne | Le nom du premier niveau de division du pays (par exemple, California aux États-Unis ou le département de la Sarthe en France). |
geo.continent_code | chaîne | Le code ISO du continent (EU, AS, NA, AF, AN, SA ou OC). |
geo.continent | chaîne | Le nom du continent (Europe, Australia, North America, Africa, Antarctica, South America ou Oceania). |
geo.city | chaîne | Le nom de la ville (par exemple, San Francisco, Paris ou New York). |
Attributs utilisateur globaux
Vous pouvez activer la surveillance des informations utilisateur de façon globale, afin de recueillir et d’appliquer des attributs utilisateur à tous vos événements RUM.
| Nom de l’attribut | Type | Description |
|---|
user.id | chaîne | L’identifiant de l’utilisateur. |
usr.name | chaîne | Le nom de l’utilisateur. |
usr.email | chaîne | L’adresse e-mail de l’utilisateur. |
Métriques et attributs spécifiques à un événement
Les métriques sont des valeurs quantifiables servant à effectuer des mesures associées à un événement. Les attributs sont des valeurs non quantifiables servant à filtrer les données de métriques dans les analyses.
Métriques des sessions
| Métrique | Type | Description |
|---|
session.time_spent | nombre (ns) | Durée d’une session |
session.view.count | nombre | Nombre total de vues recueillies lors de la session. |
session.error.count | nombre | Nombre total d’erreurs recueillies lors de la session. |
session.resource.count | nombre | Nombre total de ressources recueillies lors de la session. |
session.action.count | nombre | Nombre total d’erreurs recueillies lors de la session. |
session.long_task.count | nombre | Nombre total de tâches longues recueillies lors de la session. |
Attributs des sessions
| Nom de l’attribut | Type | Description |
|---|
session.id | chaîne | L’identifiant unique de la session. |
session.type | chaîne | Le type de la session (user). |
session.is_active | booléen | Indique si la session est actuellement active. Une session prend fin lorsqu’un utilisateur quitte l’application ou ferme la fenêtre du navigateur. Elle expire après 4 heures d’activité ou 15 minutes d’inactivité. |
session.initial_view.url | chaîne | L’URL de la vue initiale de la session. |
session.initial_view.name | chaîne | Le nom de la vue initiale de la session. |
session.last_view.url | chaîne | L’URL de la dernière vue de la session. |
session.last_view.name | chaîne | Le nom de la dernière vue de la session. |
session.ip | chaîne | L’adresse IP de la session extraite à partir de la connexion TCP de l’admission. Si vous souhaitez arrêter de recueillir cet attribut, modifiez le paramètre correspondant dans les détails de votre application. |
session.useragent | chaîne | Les informations de l’Agent utilisateur système interprétant les informations de l’appareil. |
Métriques des vues
Les événements RUM de type Action, Erreur, Ressource et Tâche longue contiennent des informations sur la vue RUM active au moment de la collecte :
| Métrique | Type | Description |
|---|
view.time_spent | nombre (ns) | Le temps passé sur la vue. |
view.long_task.count | nombre | Nombre total de tâches longues recueillies pour cette vue. |
view.error.count | nombre | Nombre total d’erreurs recueillies pour cette vue. |
view.resource.count | nombre | Nombre total de ressources recueillies pour cette vue. |
view.action.count | nombre | Nombre total d’actions recueillies pour cette vue. |
view.is_active | booléen | Statut d’activité de la vue correspondant à cet événement. |
Attributs des vues
| Nom de l’attribut | Type | Description |
|---|
view.id | chaîne | L’ID unique de la vue initiale correspondant à l’événement. |
view.url | chaîne | Nom canonique de la classe correspondant à l’événement. |
view.name | chaîne | Nom personnalisable de la vue correspondant à l’événement. |
Métriques des ressources
| Métrique | Type | Description |
|---|
duration | nombre (ns) | Durée totale de chargement de la ressource. |
resource.size | nombre (octets) | Taille de la ressource. |
resource.connect.duration | nombre (ns) | Durée d’établissement d’une connexion au serveur (connectEnd - connectStart). |
resource.ssl.duration | nombre (ns) | Durée d’établissement de la liaison TLS. Si la dernière requête ne suit pas le protocole HTTPS, cette métrique n’apparaît pas (connectEnd - secureConnectionStart). |
resource.dns.duration | nombre (ns) | Durée de résolution du nom DNS de la dernière requête (domainLookupEnd - domainLookupStart). |
resource.redirect.duration | nombre (ns) | Temps passé sur les requêtes HTTP ultérieures (redirectEnd - redirectStart). |
resource.first_byte.duration | nombre (ns) | Temps écoulé avant la réception du premier octet de la réponse (responseStart - RequestStart). |
resource.download.duration | nombre (ns) | Durée de téléchargement de la réponse (responseEnd - responseStart). |
Attributs des ressources
| Attribut | Type | Description |
|---|
resource.id | chaîne | L’identifiant unique de la ressource. |
resource.type | chaîne | Le type de ressource à recueillir (par exemple, xhr, image, font, css ou js). |
resource.method | chaîne | La méthode HTTP (par exemple, POST, GET PATCH ou DELETE). |
resource.status_code | nombre | Le code de statut de la réponse. |
resource.url | chaîne | L’URL de la ressource. |
resource.provider.name | chaîne | Le nom du fournisseur de ressources. Valeur par défaut : unknown. |
resource.provider.domain | chaîne | Le domaine du fournisseur de ressources. |
resource.provider.type | chaîne | Le type de fournisseur de ressources (par exemple, first-party, cdn, ad ou analytics). |
Attributs d’erreur
Les erreurs frontend sont recueillies par le service Real User Monitoring (RUM). Le message d’erreur et la stack trace sont inclus lorsque cela est possible.
| Attribut | Type | Description |
|---|
error.source | chaîne | L’origine de l’erreur (par exemple, webview, logger ou network). |
error.type | chaîne | Le type d’erreur (ou le code dans certains cas). |
error.message | chaîne | Un message d’une ligne lisible et concis décrivant l’événement. |
error.stack | chaîne | La stack trace ou toutes informations complémentaires relatives à l’erreur. |
error.issue_id | chaîne | La stack trace ou toutes informations complémentaires relatives à l’erreur. |
Erreurs réseau
Les erreurs réseau comprennent des informations sur la requête HTTP ayant échoué. Les facettes suivantes sont également recueillies :
| Attribut | Type | Description |
|---|
error.resource.status_code | nombre | Le code de statut de la réponse. |
error.resource.method | chaîne | La méthode HTTP (par exemple, POST ou GET). |
error.resource.url | chaîne | L’URL de la ressource. |
error.resource.provider.name | chaîne | Le nom du fournisseur de ressources. Valeur par défaut : unknown. |
error.resource.provider.domain | chaîne | Le domaine du fournisseur de ressources. |
error.resource.provider.type | chaîne | Le type de fournisseur de ressources (par exemple, first-party, cdn, ad ou analytics). |
Métriques de durée des actions
| Métrique | Type | Description |
|---|
action.loading_time | nombre (ns) | La durée de chargement de l’action. |
action.long_task.count | nombre | Nombre total de tâches longues recueillies pour cette action. |
action.resource.count | nombre | Nombre total de ressources recueillies pour cette action. |
action.error.count | nombre | Nombre total d’erreurs recueillies pour cette action. |
Attributs d’action
| Attribut | Type | Description |
|---|
action.id | chaîne | UUID de l’action utilisateur. |
action.type | chaîne | Le type de l’action utilisateur (par exemple, tap ou application_start). |
action.name | chaîne | Nom de l’action utilisateur. |
action.target.name | chaîne | Élément avec lequel l’utilisateur a interagi. Uniquement pour les actions recueillies automatiquement. |
Stockage des données
Avant que les données ne soient importées dans Datadog, elles sont stockées en clair dans le répertoire cache de votre application. Ce répertoire est protégé par le bac à sable d’applications Android. Ainsi, sur la plupart des appareils, ces données ne peuvent pas être lues par d’autres applications. Toutefois, si l’appareil mobile est en mode root, ou si l’intégrité du kernel Linux a été compromise, il est possible que les données stockées soient lisibles.
Prise en charge du mode Direct Boot
Si votre application prend en charge le mode Direct Boot, notez que les données capturées avant le déverrouillage de l’appareil ne seront pas enregistrées, étant donné que l’espace de stockage chiffré n’est pas encore disponible.
Pour aller plus loin
Documentation, liens et articles supplémentaires utiles:
