A API Google Play Developer Reporting permite recuperar anomalias detectadas em conjuntos de métricas. Uma anomalia é produzida sempre que o valor da métrica excede o intervalo esperado, com base nos últimos 28 dias de valores para essa mesma métrica. As anomalias por dias consecutivos são mescladas em um único resultado de anomalia.
Se o aumento anômalo no valor de uma métrica persistir por tempo suficiente, o modelo de detecção adaptará e ampliará os valores esperados até que os pontos de dados subsequentes não sejam mais considerados anômalos.
Como recuperar anomalias
As anomalias podem ser listadas com o método anomalies.list.
Solicitação simples:
Essa solicitação HTTP GET especifica o parâmetro de nome do aplicativo e retorna a
lista completa de anomalias detectadas para seu aplicativo.
GET https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/anomalies
Resposta da anomalia:
A resposta inclui informações suficientes para consultar exatamente onde a anomalia ocorreu:
{
"anomalies": [
{
"name": "apps/com.example.app/anomalies/12345"
"metric_set": "apps/com.example.app/anrRateMetricSet"
"timeline_spec": {
"aggregation_period": "DAILY"
"start_time": {
"year": 2022
"month": 1
"day": 23
"time_zone": {
"id": "America/Los_Angeles"
}
}
"end_time": {
"year": 2022
"month": 1
"day": 23
"time_zone": {
"id": "America/Los_Angeles"
}
}
}
"metric": {
"metric": "anrRate",
"decimal_value": {
"value": "3.1415926535"
}
}
},
{
"name": "apps/com.example.app/anomalies/12345"
"metric_set": "apps/com.example.app/crashRateMetricSet"
"timeline_spec": {
"aggregation_period": "DAILY"
"start_time": {
"year": 2021
"month": 12
"day": 10
"time_zone": {
"id": "America/Los_Angeles"
}
}
"end_time": {
"year": 2021
"month": 12
"day": 10
"time_zone": {
"id": "America/Los_Angeles"
}
}
}
"metric": {
"metric": "crashRate",
"decimal_value": {
"value": "2.7182818284"
}
}
},
]
}
Solicitação filtrada:
É possível aplicar um filtro para retornar apenas anomalias que estavam ativas em um período específico. Para fazer isso, especifique a função activeBetween(start, end)
no campo de filtro na solicitação. É possível especificar limites ilimitados em qualquer lado do intervalo com a palavra-chave especial UNBOUNDED. Se um limite de início ou fim for especificado, ele precisará seguir o formato RFC 3339, por exemplo, 2022-02-22T04:00Z.
GET https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/anomalies?filter=activeBetween("2022-01-01T00:00:00Z", UNBOUNDED)
Resposta filtrada:
A resposta inclui apenas anomalias que estavam ativas no período especificado:
{
"anomalies": [
{
"name": "apps/com.example.app/anomalies/12345"
"metric_set": "apps/com.example.app/anrRateMetricSet"
"timeline_spec": {
"aggregation_period": "DAILY"
"start_time": {
"year": 2022
"month": 1
"day": 23
"time_zone": {
"id": "America/Los_Angeles"
}
}
"end_time": {
"year": 2022
"month": 1
"day": 23
"time_zone": {
"id": "America/Los_Angeles"
}
}
}
"metric": {
"metric": "anrRate",
"decimal_value": {
"value": "3.1415926535"
}
}
},
]
}
Métricas disponíveis
No momento, nem todas as métricas e conjuntos de métricas são compatíveis com a detecção de anomalias. Veja a lista de métricas atualmente compatíveis:
| Conjunto de métricas | Métricas aceitas |
|---|---|
vitals.anrrate |
taxa anr. |
vitals.crashrate |
Taxa de falhas |
vitals.excessivewakeuprate |
Taxa excessiva de ativação |
vitals.stuckbackgroundwakelockrate |
taxa fixa do BgWakelock |