REST Resource: vitals.crashrate

Recurso: CrashRateMetricSet

Recurso Singleton que representa o conjunto de métricas de taxa de falhas.

Esse conjunto de métricas contém dados de falhas combinados com dados de uso para produzir uma métrica normalizada independente das contagens de usuários.

Períodos de agregação compatíveis:

  • DAILY: as métricas são agregadas em intervalos de data no calendário. Devido a restrições históricas, o único fuso horário aceito é America/Los_Angeles.
  • HOURLY: as métricas são agregadas em intervalos de hora em hora. O fuso horário padrão e único é UTC.

Métricas compatíveis:

  • crashRate (google.type.Decimal): porcentagem de usuários diferentes no período de agregação que tiveram pelo menos uma falha.
  • crashRate7dUserWeighted (google.type.Decimal): valor médio contínuo de crashRate nos últimos sete dias. Os valores diários são ponderados pela contagem de usuários distintos no dia. Incompatível com a granularidade de HOURLY.
  • crashRate28dUserWeighted (google.type.Decimal): valor médio contínuo de crashRate nos últimos 28 dias. Os valores diários são ponderados pela contagem de usuários distintos no dia. Incompatível com a granularidade de HOURLY.
  • userPerceivedCrashRate (google.type.Decimal): porcentagem de usuários diferentes no período de agregação que tiveram pelo menos uma falha enquanto usavam o app (uma falha percebida pelo usuário). Considera-se que um aplicativo está em uso ativo se estiver exibindo qualquer atividade ou executando qualquer serviço em primeiro plano.
  • userPerceivedCrashRate7dUserWeighted (google.type.Decimal): valor médio contínuo de userPerceivedCrashRate nos últimos sete dias. Os valores diários são ponderados pela contagem de usuários distintos no dia. Incompatível com a granularidade de HOURLY.
  • userPerceivedCrashRate28dUserWeighted (google.type.Decimal): valor médio contínuo de userPerceivedCrashRate nos últimos 28 dias. Os valores diários são ponderados pela contagem de usuários distintos no dia. Incompatível com a granularidade de HOURLY.
  • distinctUsers (google.type.Decimal): contagem de usuários distintos no período de agregação que foram usados como valor de normalização para as métricas crashRate e userPerceivedCrashRate. Um usuário será contabilizado nessa métrica se ele tiver usado o app ativamente durante o período de agregação. Considera-se que um aplicativo está em uso ativo se estiver exibindo qualquer atividade ou executando qualquer serviço em primeiro plano. É preciso ter cuidado para não agregar ainda mais essa contagem, já que isso pode fazer com que os usuários sejam contados várias vezes. O valor é arredondado para o múltiplo mais próximo de 10, 100, 1.000 ou 1.000.000, dependendo da magnitude do valor.

Dimensões compatíveis:

  • apiLevel (string): o nível da API do Android executado no dispositivo do usuário, por exemplo, 26.
  • versionCode (int64): versão do app que estava em execução no dispositivo do usuário.
  • deviceModel (string): identificador exclusivo do modelo de dispositivo do usuário. A forma do identificador é "deviceBrand/device", em que deviceBrand corresponde a Build.BRAND e o dispositivo corresponde a Build.DEVICE, por exemplo, google/coral.
  • deviceBrand (string): identificador exclusivo da marca do dispositivo do usuário, por exemplo, google.
  • deviceType (string): o tipo (também conhecido como formato) do dispositivo do usuário, por exemplo, TELEFONE.
  • countryCode (string): o país ou a região do dispositivo do usuário com base no endereço IP, representado como um código ISO-3166 de duas letras (por exemplo, "US" para os Estados Unidos).
  • deviceRamBucket (int64): RAM do dispositivo, em MB, em buckets (3 GB, 4 GB etc.).
  • deviceSocMake (string): marca do sistema principal do dispositivo, por exemplo, Samsung. Referência
  • deviceSocModel (string): modelo do sistema principal no dispositivo, por exemplo, "Exynos 2100". Referência
  • deviceCpuMake (string): marca da CPU do dispositivo, por exemplo, Qualcomm.
  • deviceCpuModel (string): modelo da CPU do dispositivo, por exemplo, "Kryo 240".
  • deviceGpuMake (string): marca da GPU do dispositivo, por exemplo, ARM.
  • deviceGpuModel (string): modelo da GPU do dispositivo, por exemplo, Mali.
  • deviceGpuVersion (string): versão da GPU do dispositivo, por exemplo, Conexão T750.
  • deviceVulkanVersion (string): versão do Vulkan do dispositivo, por exemplo, "4198400".
  • deviceGlEsVersion (string): versão OpenGL ES do dispositivo, por exemplo, "196610".
  • deviceScreenSize (string): tamanho da tela do dispositivo, por exemplo, NORMAL, GRANDE.
  • deviceScreenDpi (string): densidade da tela do dispositivo, por exemplo, mdpi, hdpi.

Permissões necessárias: para acessar esse recurso, o usuário que faz a chamada precisa da permissão Ver informações do app (somente leitura).

Conjuntos de métricas relacionadas:

  • vitals.errors contém uma versão não normalizada (contagem absoluta) de falhas.
  • vitals.errors contém métricas normalizadas sobre ANRs, outra métrica de estabilidade.
Representação JSON
{
  "name": string,
  "freshnessInfo": {
    object (FreshnessInfo)
  }
}
Campos
name

string

O nome do recurso.

Formato: apps/{app}/crashRateMetricSet

freshnessInfo

object (FreshnessInfo)

Resumo sobre a atualização de dados neste recurso.

Métodos

get

Descreve as propriedades do conjunto de métricas.

query

Consulta as métricas no conjunto de métricas.