REST Resource: vitals.crashrate

Ressource : CrashRateMetricSet

Ressource singleton représentant l'ensemble des métriques de taux de plantages.

Cet ensemble de métriques contient des données sur les plantages combinées à des données d'utilisation pour produire une métrique normalisée indépendante du nombre d'utilisateurs.

Périodes d'agrégation acceptées :

  • DAILY : les métriques sont agrégées par intervalles de dates calendaires. En raison de contraintes historiques, le seul fuseau horaire accepté est America/Los_Angeles.
  • HOURLY : les métriques sont agrégées par intervalles d'une heure. Le fuseau horaire par défaut et le seul accepté est UTC.

Métriques acceptées :

  • crashRate (google.type.Decimal) : pourcentage d'utilisateurs distincts au cours de la période d'agrégation ayant subi au moins un plantage.
  • crashRate7dUserWeighted (google.type.Decimal) : valeur moyenne glissante de crashRate au cours des sept derniers jours. Les valeurs quotidiennes sont pondérées par le nombre d'utilisateurs distincts pour la journée. Non compatible avec la précision HOURLY.
  • crashRate28dUserWeighted (google.type.Decimal) : valeur moyenne glissante de crashRate au cours des 28 derniers jours. Les valeurs quotidiennes sont pondérées par le nombre d'utilisateurs distincts pour la journée. Non compatible avec la précision HOURLY.
  • userPerceivedCrashRate (google.type.Decimal) : pourcentage d'utilisateurs distincts au cours de la période d'agrégation ayant subi au moins un plantage lorsqu'ils se servaient activement de votre application (plantage repéré par l'utilisateur). Une application est considérée comme active si elle affiche une activité ou exécute un service de premier plan.
  • userPerceivedCrashRate7dUserWeighted (google.type.Decimal) : valeur moyenne glissante de userPerceivedCrashRate au cours des sept derniers jours. Les valeurs quotidiennes sont pondérées par le nombre d'utilisateurs distincts pour la journée. Non compatible avec la précision HOURLY.
  • userPerceivedCrashRate28dUserWeighted (google.type.Decimal) : valeur moyenne glissante de userPerceivedCrashRate au cours des 28 derniers jours. Les valeurs quotidiennes sont pondérées par le nombre d'utilisateurs distincts pour la journée. Non compatible avec la précision HOURLY.
  • distinctUsers (google.type.Decimal) : nombre d'utilisateurs distincts au cours de la période d'agrégation qui ont été utilisés comme valeur de normalisation pour les métriques crashRate et userPerceivedCrashRate. Un utilisateur est comptabilisé dans cette métrique s'il a utilisé l'application activement au cours de la période d'agrégation. Une application est considérée comme active si elle affiche une activité ou exécute un service de premier plan. Veillez à ne pas agréger davantage ce nombre, car les utilisateurs pourraient être comptabilisés plusieurs fois. La valeur est arrondie au multiple le plus proche de 10, 100, 1 000 ou 1 000 000, selon son ordre de grandeur.

Variables acceptées :

  • apiLevel (string) : niveau d'API d'Android exécuté sur l'appareil de l'utilisateur, par exemple 26.
  • versionCode (int64) : version de l'application exécutée sur l'appareil de l'utilisateur.
  • deviceModel (string) : identifiant unique du modèle d'appareil de l'utilisateur. L'identifiant est au format "deviceBrand/device", où deviceBrand correspond à Build.BRAND et device à Build.DEVICE (par exemple, google/coral).
  • deviceBrand (string) : identifiant unique de la marque de l'appareil de l'utilisateur, par exemple "google".
  • deviceType (string) : type (également appelé facteur de forme) de l'appareil de l'utilisateur, par exemple "PHONE".
  • countryCode (string) : pays ou région de l'appareil de l'utilisateur en fonction de son adresse IP, représenté par un code ISO 3166 à deux lettres (par exemple, "US" pour les États-Unis).
  • deviceRamBucket (int64) : RAM de l'appareil, en Mo, par buckets (par exemple, 1024 pour 1 à 1,5 Go, 4096 pour 4 à 6 Go).
  • deviceSocMake (string) : marque du système sur puce principal de l'appareil, par exemple "Samsung". Référence
  • deviceSocModel (string) : modèle du système sur puce principal de l'appareil, par exemple "Exynos 2100". Référence
  • deviceCpuMake (string) : marque du processeur de l'appareil, par exemple "Qualcomm".
  • deviceCpuModel (string) : modèle du processeur de l'appareil, par exemple "Kryo 240".
  • deviceGpuMake (string) : marque du GPU de l'appareil, par exemple "ARM".
  • deviceGpuModel (string) : modèle du GPU de l'appareil, par exemple "Mali".
  • deviceGpuVersion (string) : version du GPU de l'appareil, par exemple "T750".
  • deviceVulkanVersion (string) : version Vulkan de l'appareil, par exemple "4198400".
  • deviceGlEsVersion (string) : version OpenGL ES de l'appareil, par exemple "196610".
  • deviceScreenSize (string) : taille de l'écran de l'appareil, par exemple "NORMAL" ou "LARGE".
  • deviceScreenDpi (string) : densité d'écran de l'appareil, par exemple "mdpi" ou "hdpi".

Autorisations requises : pour accéder à cette ressource, l'utilisateur appelant doit disposer de l'autorisation Afficher les informations sur l'application (lecture seule) pour l'application.

Ensembles de métriques associés :

  • vitals.errors contient une version non normalisée (nombres absolus) des plantages.
  • vitals.errors contient des métriques normalisées sur les erreurs ANR, une autre métrique de stabilité.
Représentation JSON 
{
  "name": string,
  "freshnessInfo": {
    object (FreshnessInfo)
  }
}
Champs
name

string

Identifiant. Nom de la ressource.

Format: apps/{app}/crashRateMetricSet
freshnessInfo

object (FreshnessInfo)

Résumé sur la fraîcheur des données dans cette ressource.

Méthodes

get

 Décrit les propriétés de l'ensemble de métriques.

query

 Interroge les métriques de l'ensemble de métriques.