Catch up on highlights from Firebase at Google I/O 2023. Learn more

Filtrer les données à l'aide d'attributs

Avec la surveillance des performances, vous pouvez utiliser des attributs pour segmenter les données de performances et vous concentrer sur les performances de votre application dans différents scénarios réels.

Après avoir cliqué sur un nom de trace dans le tableau des traces (situé au bas du tableau de bord des performances ), vous pouvez explorer les métriques qui vous intéressent. Utilisez le bouton Filter (en haut à gauche de l'écran) pour filtrer les données par attribut, par exemple :

une image des données Firebase Performance Monitoring filtrées par attribut

  • Filtrez par version de l'application pour afficher les données d'une version antérieure ou de votre dernière version
  • Filtrez par appareil pour savoir comment les appareils plus anciens gèrent votre application
  • Filtrez par pays pour vous assurer que l'emplacement de votre base de données n'affecte pas une région spécifique

Pour une analyse encore plus puissante basée sur les attributs, exportez vos données de performances vers BigQuery .

Attributs par défaut

La surveillance des performances collecte automatiquement une variété d'attributs par défaut en fonction du type de trace.

En plus de ces attributs par défaut, vous pouvez également créer des attributs personnalisés sur vos traces de code personnalisées pour segmenter les données par catégories spécifiques à votre application. Par exemple, dans un jeu, vous pouvez segmenter les données par niveau de jeu.

Attributs par défaut pour les applications Apple et Android

Toutes les traces pour les applications Apple et Android collectent les attributs suivants par défaut :

  • Version de l'application
  • Pays
  • Niveau du système d'exploitation
  • Appareil
  • Radio
  • Transporteur

De plus, les traces de requête réseau collectent également l'attribut suivant :

  • Type MIME

Collecte des données utilisateur

Créer des attributs personnalisés

Vous pouvez créer des attributs personnalisés sur n'importe laquelle de vos traces de code personnalisé instrumenté.

Utilisez l'API Performance Monitoring Trace ( Swift | Obj-C ) pour ajouter des attributs personnalisés aux traces de code personnalisées.

Pour utiliser des attributs personnalisés, ajoutez du code à votre application qui définit l'attribut et l'associe à une trace de code personnalisé spécifique. Vous pouvez définir l'attribut personnalisé à tout moment entre le démarrage et l'arrêt de la trace.

Notez ce qui suit :

  • Les noms des attributs personnalisés doivent répondre aux exigences suivantes :

    • Pas d'espaces de début ou de fin, pas de caractère de soulignement ( _ ) de début
    • Sans espaces
    • La longueur maximale est de 32 caractères
    • Les caractères autorisés pour le nom sont AZ , az et _ .
  • Chaque trace de code personnalisé peut enregistrer jusqu'à 5 attributs personnalisés.

  • Veuillez vous assurer que les attributs personnalisés ne contiennent aucune information permettant d'identifier personnellement un individu auprès de Google.

    En savoir plus sur cette directive

Rapide

Remarque : Ce produit Firebase n'est pas disponible sur les cibles macOS, Mac Catalyst et watchOS.
let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.setValue("A", forAttribute: "experiment")

// Update scenario.
trace.setValue("B", forAttribute: "experiment")

// Reading scenario.
let experimentValue:String? = trace.valueForAttribute("experiment")

// Delete scenario.
trace.removeAttribute("experiment")

// Read attributes.
let attributes:[String, String] = trace.attributes;

Objectif c

Remarque : Ce produit Firebase n'est pas disponible sur les cibles macOS, Mac Catalyst et watchOS.
FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace setValue:@"A" forAttribute:@"experiment"];

// Update scenario.
[trace setValue:@"B" forAttribute:@"experiment"];

// Reading scenario.
NSString *experimentValue = [trace valueForAttribute:@"experiment"];

// Delete scenario.
[trace removeAttribute:@"experiment"];

// Read attributes.
NSDictionary <NSString *, NSString *> *attributes = [trace attributes];