Anormallikler

Google Play Developer Reporting API, metrik kümelerinde tespit edilen anormallikleri almanızı sağlar. Aynı metrik için önceki 28 güne ait değerler temel alınarak, metrik değeri beklenen metrik aralığını her aştığında anormallik oluşur. Ardışık günler için anormallikler tek bir anormallik sonucu olarak birleştirilir.

Bir metriğin değerindeki anormal artış yeterince uzun süre kalırsa algılama modeli, sonraki veri noktaları artık anormal kabul edilmeyene kadar beklenen değerleri uyarlar ve genişletir.

Anormallikleri alma

Anormallikler, anomalies.list yöntemiyle listelenebilir.

Basit istek:

Bu HTTP GET isteği, uygulama adı parametresini belirtir ve uygulamanız için tespit edilen anormalliklerin tam listesini döndürür.

GET https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/anomalies

Anormallik yanıtı:

Yanıt, anormalliğin tam olarak nerede gerçekleştiğini sorgulamaya yetecek kadar bilgi içeriyor:

{
  "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"
        }
      }
    },
  ]
}

Filtrelenen istek:

Yalnızca belirli bir zaman aralığında etkin olan anormallikleri döndürmek için filtre uygulanabilir. Bunu yapmak için istekteki filtre alanında activeBetween(start, end) işlevini belirtin. UNBOUNDED özel anahtar kelimesiyle aralığın her iki tarafında da sınırsız sınırlar belirtilebilir. Bir başlangıç veya bitiş sınırı belirtiyorsanız RFC 3339 biçimine (2022-02-22T04:00Z gibi) uymalıdır.

GET https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/anomalies?filter=activeBetween("2022-01-01T00:00:00Z", UNBOUNDED)

Filtrelenmiş yanıt:

Yanıt yalnızca belirtilen zaman aralığında etkin olan anormallikleri içerir:

{
  "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"
        }
      }
    },
  ]
}

Mevcut metrikler

Şu anda tüm metrik ve metrik grupları anormallik algılama özelliğini desteklememektedir. Şu anda desteklenen metriklerin listesini aşağıda görebilirsiniz:

Metrik ayarlandı	Desteklenen metrikler
vitals.anrrate	veri ücreti
vitals.crashrate	kilitlenme oranı
vitals.excessivewakeuprate	aşırı Uyandırma Oranı
vitals.stuckbackgroundwakelockrate	sıkışmışBgWakelockRate