Données RUM recueillies (iOS)
Présentation
Le SDK RUM iOS 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 rappels viewDidAppear(animated:) et viewDidDisappear(animated:) sont effectués sur la classe UIViewController. Chaque UIViewController est considéré 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 | 30 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. |
| Erreur | 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 l’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 | 30 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 :
Lancement de l’application
À son initialisation, le SDK RUM pour iOS crée une vue intitulée ApplicationLaunch. Cette vue commence au même moment que le processus iOS et peut être utilisée pour suivre le temps de lancement de votre application.
La vue ApplicationLaunch inclut l’ensemble des logs, actions et ressources créés avant le premier appel de startView. Utilisez la durée de cette vue pour déterminer le temps écoulé avant la première vue. Cette vue possède une action, application_start, dont la durée correspond au temps écoulé entre le lancement du processus et l’appel de applicationDidBecomeActive.
Si iOS décide de préchauffer votre application, la vue ApplicationLaunch commence alors à l’initialisation du SDK RUM pour iOS, et l’événement application_start n’enregistre aucune durée.
Attributs par défaut
Par défaut, la solution RUM recueille 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 ajoutant d’autres événements 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. |
application.name | chaîne | Le nom de l’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, 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 |
|---|
usr.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
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 de vue
| 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 | URL de la classe UIViewController 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 |
|---|
resource.duration | nombre | 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) | Temps passé à établir la liaison TLS. |
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) | Le 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 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 générées par cette action. |
action.error.count | nombre | Nombre total d’erreurs générées par 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 (Library/Caches) du bac à sable de votre application. Aucune autre application installée sur l’appareil ne peut lire ces données.
Pour aller plus loin
Documentation, liens et articles supplémentaires utiles:
