비정상 통계

Google Play Developer Reporting API를 사용하면 측정항목 세트에서 감지된 이상치를 검색할 수 있습니다. 측정항목 값이 이전 측정항목 28일을 기준으로 측정항목 예상 범위를 초과할 때마다 불일치가 발생합니다. 연속된 날짜 이상치는 단일 이상 결과에 병합됩니다.

측정항목 값의 비정상적인 증가가 충분히 오래 지속되면 감지 모델은 후속 데이터 포인트가 더 이상 이상하다고 간주되지 않을 때까지 예상 값을 조정하고 확장합니다.

이상치 검색

이상치를 anomalies.list 메서드로 나열할 수 있습니다.

간단한 요청:

이 HTTP GET 요청은 애플리케이션 이름 매개변수를 지정하고 애플리케이션에서 감지된 이상치의 전체 목록을 반환합니다.

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

이상 응답:

응답에는 이상치 발생 위치를 정확하게 쿼리할 수 있는 충분한 정보가 포함됩니다.

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

필터링된 요청:

특정 기간 동안 활성 상태인 이상만 반환하도록 필터를 적용할 수 있습니다. 이렇게 하려면 요청의 필터 필드에 activeBetween(start, end) 함수를 지정합니다. 특수 키워드 UNBOUNDED를 사용하여 범위 양쪽에 무제한 한도를 지정할 수 있습니다. 시작 또는 끝 바인딩을 지정하는 경우 RFC 3339 형식(예: 2022-02-22T04:00Z)을 따라야 합니다.

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

필터링된 응답:

응답에는 지정된 기간 동안 활성 상태인 이상만 포함됩니다.

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

사용 가능한 측정항목

현재 일부 측정항목과 측정항목 모음이 이상 감지를 지원하지 않습니다. 현재 지원되는 측정항목 목록은 다음과 같습니다.

측정항목 세트	지원되는 측정항목
vitals.anrrate	평균 요율
vitals.crashrate	비정상 종료 발생률
vitals.excessivewakeuprate	불필요한 wakeup 비율
vitals.stuckbackgroundwakelockrate	중단 BgWakelockRate