Exporter les données de surveillance des performances vers BigQuery

Vous pouvez exporter des données Performance Monitoring depuis des applications Apple et Android dans BigQuery pour une analyse plus approfondie. BigQuery vous permet d'analyser les données à l'aide de SQL BigQuery, de les exporter vers un autre fournisseur de services cloud et même de les utiliser pour vos modèles de ML personnalisés.

Activer l'exportation BigQuery

  1. Accédez à la page Intégrations dans la console Firebase, puis cliquez sur Associer dans la fiche BigQuery.

  2. Suivez les instructions à l'écran pour activer BigQuery.

    Lorsque vous activez l'exportation BigQuery pour Performance Monitoring, voici ce qui se passe:

    • Firebase exporte une copie de vos données existantes vers BigQuery. La propagation initiale des données à exporter peut prendre jusqu'à 48 heures.

    • Une fois l'ensemble de données créé, son emplacement ne peut plus être modifié, mais vous pouvez le copier dans un autre emplacement ou le déplacer manuellement (recréer) dans un autre emplacement. Pour en savoir plus, consultez la page Modifier l'emplacement d'un ensemble de données.

    • Firebase configure des synchronisations régulières de vos données depuis votre projet Firebase vers BigQuery. Ces opérations d'exportation quotidiennes se terminent généralement 24 heures après leur planification.

    • Par défaut, toutes les applications de votre projet sont associées à BigQuery. Toutes les applications que vous ajoutez ultérieurement au projet sont automatiquement associées à BigQuery. Vous pouvez gérer les applications qui envoient des données.

Pour désactiver l'exportation BigQuery, dissociez votre projet dans la console Firebase.

Quelles données sont exportées vers BigQuery ?

Pour chaque application du projet, l'exportation crée une table qui inclut tous les événements de performances enregistrés. Chaque ligne du tableau est un événement de performances unique qui peut être l'un des éléments suivants:

  • Trace de durée : traces qui collectent, par défaut, la métrique "duration" (durée), y compris le démarrage de l'application, l'application au premier plan et l'application en arrière-plan, ainsi que toutes les traces de code personnalisées instrumentées par le développeur

    • event_type correspond à DURATION_TRACE.
    • event_name est identique au nom de la trace.

  • Métrique de trace : métriques personnalisées associées à des traces de code personnalisées instrumentées par le développeur.

    • event_type correspond à TRACE_METRIC.
    • event_name est le nom de la métrique.
    • parent_trace_name est le nom de la trace qui contient cette métrique.

  • Trace d'écran : traces couvrant la durée de vie d'un écran (traces de rendu d'écran)

    • event_type correspond à SCREEN_TRACE.
    • event_name correspond au préfixe _st_, suivi du nom de l'écran réel.

  • Requête réseau : traces couvrant la durée de vie d'une requête réseau (traces de requête réseau HTTP)

    • event_type correspond à NETWORK_REQUEST.
    • event_name est le format catégorisé de l'URL de la requête réseau.

Chaque événement de performances contient les attributs de l'événement (comme le pays et l'opérateur de l'appareil client), ainsi que des informations spécifiques à l'événement :

  • Les traces de durée, les métriques de trace et les traces d'écran contiennent trace_info
  • Les métriques de trace contiennent trace_info.metric_info
  • Les traces d'écran contiennent trace_info.screen_info
  • Les traces réseau contiennent network_info

Schéma de données détaillé

Nom du champ Type Description
event_timestamp timestamp Horodatage depuis l'epoch du début de l'événement sur l'appareil client (début de la trace, début du réseau, etc.)
app_display_version chaîne Afficher la version de l'application (par exemple, "4.1.7")
  • Pour Android : VersionName
  • Pour iOS : CFBundleShortVersionString
app_build_version chaîne Version de compilation de l'application (par exemple, "1523456")
  • Pour Android : VersionCode
  • Pour iOS : CFBundleVersion
version de l'OS chaîne Version du système d'exploitation de l'appareil client
  • Pour Android : niveau d'API Android (par exemple, "26")
  • Pour iOS : version iOS (par exemple, "11.4")
device_name chaîne Nom de l'appareil client (par exemple, "Google Pixel")
country chaîne Code pays à deux lettres du pays où l'événement s'est déroulé (par exemple, "US" ou "ZZ" pour un pays inconnu)
transporteur chaîne Opérateur de l'appareil client
radio_type chaîne Type de radio actif au moment de l'événement (par exemple, "WIFI")
attributs_personnalisés ARRAY<RECORD> Tous les attributs personnalisés associés à cet événement
custom_attributes.key chaîne Clé de l'attribut personnalisé
custom_attributes.value chaîne Valeur de l'attribut personnalisé
event_type chaîne Type de l'événement. Valeurs possibles :
  • DURATION_TRACE : traces qui collectent, par défaut, la métrique "durée", qui inclut le démarrage de l'application, l'application au premier plan et l'application en arrière-plan, ainsi que toutes les traces de code personnalisé instrumentées par le développeur
  • SCREEN_TRACE : traces couvrant la durée de vie d'un écran (traces de rendu d'écran)
  • TRACE_METRIC : métriques personnalisées associées aux traces de code personnalisé instrumentées par le développeur
  • NETWORK_REQUEST : traces couvrant la durée de vie d'une requête réseau (traces de requête réseau HTTP)
event_name chaîne Nom de l'événement
  • Pour DURATION_TRACE : nom de la trace
  • Pour TRACE_METRIC : nom de la métrique personnalisée
  • Pour SCREEN_TRACE : _st_ suivi du nom de la trace
  • Pour NETWORK_REQUEST : format d'URL de la requête réseau
parent_trace_name chaîne Nom de la trace parente qui contient la métrique de trace
Présent uniquement pour TRACE_METRIC
trace_info ENREGISTREMENT Présent uniquement pour DURATION_TRACE, SCREEN_TRACE et TRACE_METRIC
trace_info.duration_us int64
  • Pour DURATION_TRACE et SCREEN_TRACE : durée ("duration") du début à la fin de la trace
  • Pour TRACE_METRIC : durée ("durée") du début à la fin de la trace parente
Unité : microseconde
trace_info.screen_info ENREGISTREMENT Uniquement présent pour SCREEN_TRACE
trace_info.screen_info.slow_frame_ratio float64 Ratio des images lentes pour cette trace d'écran, compris entre 0 et 1 (par exemple, une valeur de 0,05 signifie que 5% des images de cette instance d'écran ont mis plus de 16 ms à s'afficher)
trace_info.screen_info.frozen_frame_ratio float64 Ratio des images figées pour cette trace d'écran, compris entre 0 et 1 (par exemple, une valeur de 0,05 signifie que 5% des images de cette instance d'écran ont mis plus de 700 ms à s'afficher)
trace_info.metric_info ENREGISTREMENT Uniquement présent pour TRACE_METRIC
trace_info.metric_info.metric_value int64 Valeur de la métrique de trace
network_info ENREGISTREMENT Uniquement présent pour NETWORK_REQUEST
network_info.response_code int64 Code de réponse HTTP pour la réponse réseau (par exemple, 200, 404)
network_info.response_mime_type chaîne Type MIME de la réponse réseau (par exemple, "text/html")
network_info.request_http_method chaîne Méthode HTTP de la requête réseau (par exemple, "GET" ou "POST")
network_info.request_payload_bytes int64 Taille de la charge utile de la requête réseau
Unité: octet
network_info.response_payload_bytes int64 Taille de la charge utile de la réponse réseau
Unité : octet
network_info.request_completed_time_us int64 Microsecondes après event_timestamp lorsque l'envoi de la requête réseau est terminé
Unité : microseconde
network_info.response_initiated_time_us int64 Microsecondes après event_timestamp lorsque la réponse du réseau est lancée
Unité: microseconde
network_info.response_completed_time_us int64 Microsecondes après event_timestamp lorsque la réponse réseau est terminée
Unité : microseconde

Que pouvez-vous faire avec les données exportées ?

Les sections suivantes fournissent des exemples de requêtes que vous pouvez exécuter dans BigQuery sur vos données Performance Monitoring exportées.

Faire correspondre les données affichées dans la console

Le tableau de bord Firebase agrège les données quotidiennes dans le fuseau horaire America/Los_Angeles. Pour correspondre à ce qui s'affiche dans la console, les fonctions de date doivent définir explicitement America/Los_Angeles comme fuseau horaire. Sinon, la fonction de date utilisera par défaut UTC.

SELECT
  DATE(event_timestamp, 'America/Los_Angeles') AS daily_date,
  APPROX_QUANTILES(trace_info.duration_us, 100)[OFFSET(90)] / 1000000 AS p90_seconds,
FROM `TABLE_NAME`
WHERE
  DATE(event_timestamp, 'America/Los_Angeles')
    >= DATE_SUB( PARSE_DATE('%Y%m%d', 'YYYY-MM-DD'), INTERVAL 7 DAY)
  AND DATE(event_timestamp, 'America/Los_Angeles')
    <= PARSE_DATE('%Y%m%d', 'YYYY-MM-DD')
  AND event_name = '_app_start'
GROUP BY 1
ORDER BY 1 DESC;

Afficher la répartition de la latence moyenne de démarrage des applications par pays

SELECT AVG(trace_info.duration_us), country
FROM `TABLE_NAME`
WHERE _PARTITIONTIME > TIMESTAMP("YYYY-MM-DD")
AND event_type = "DURATION_TRACE"
AND event_name = "_app_start"
GROUP BY 2;

Vérifier le ratio de cadres figés en fonction de différentes conditions

Par exemple, vous pouvez vérifier le ratio de frames figés ainsi que le temps que les utilisateurs passent sur chaque écran de votre application avec différents types de radio (Wi-Fi, 4G, etc.).

SELECT
  AVG(trace_info.duration_us / 1000000) AS seconds_on_screen,
  AVG(trace_info.screen_info.frozen_frame_ratio) AS frozen_frame_ratio,
  event_name,
  radio_type
FROM `TABLE_NAME`
WHERE _PARTITIONTIME > TIMESTAMP("YYYY-MM-DD")
AND event_type = "SCREEN_TRACE"
GROUP BY event_name, radio_type
ORDER BY event_name, radio_type;

Calcul du taux de succès de cache (hits) pour le chargement de certains types de fichiers à partir du disque

Cette analyse suppose que vous avez instrumenté une trace de code personnalisée pour le chargement à partir du disque avec un attribut personnalisé nommé file-extension et une métrique personnalisée (une TRACE_METRIC) nommée cache-hit qui est définie sur 1 en cas de succès de cache et 0 en cas de défaut de cache.

Par exemple, vous pouvez calculer le taux de réussite du cache pour le chargement de fichiers PNG à partir du disque :

SELECT AVG(trace_info.metric_info.metric_value) AS cache_hit_rate
FROM `TABLE_NAME`
WHERE _PARTITIONTIME > TIMESTAMP("YYYY-MM-DD")
AND event_type = "TRACE_METRIC"
AND event_name = "cache-hit"
AND parent_trace_name = "loadFromDisk"
AND STRUCT("file-extension", "png") IN UNNEST(custom_attributes);

Vérifier l'heure de la journée à laquelle les utilisateurs envoient des requêtes réseau

Par exemple, vous pouvez vérifier à quelle heure de la journée les utilisateurs situés aux États-Unis envoient des requêtes réseau à partir de votre application :

SELECT
  count(1) AS hourly_count,
  EXTRACT(HOUR FROM event_timestamp) AS hour_of_day
FROM `TABLE_NAME`
WHERE _PARTITIONTIME > TIMESTAMP("YYYY-MM-DD")
AND event_type = "NETWORK_REQUEST"
AND country = "US"
GROUP BY 2 ORDER BY 2;

Emporter vos données Performance Monitoring partout

Vous souhaitez parfois accéder à vos données Performance Monitoring côté serveur ou les transférer vers une autre solution tierce. L'exportation de données n'entraîne actuellement aucuns frais.

Vous pouvez exporter vos données de plusieurs façons :

Tarifs

L'exportation de données depuis Performance Monitoring est gratuite, et BigQuery offre des limites d'utilisation généreuses sans frais. Pour en savoir plus, consultez la tarification BigQuery ou l'environnement de test BigQuery.