異常

Google Play Developer Reporting API を使用すると、指標セットで検出された異常を取得できます。異常は、指標値が同じ指標の過去 28 日間の値に基づいて、指標の想定範囲を超えたときに生成されます。連続する日の異常は、1 つの異常結果に統合されます。

指標の値の異常な増加が十分に長く続くと、検出モデルが適応し、後続のデータポイントが異常と見なされなくなるまで、想定値を広げます。

異常の取得

異常は 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	anrRate
vitals.crashrate	crashRate
vitals.excessivewakeuprate	excessiveWakeupRate
vitals.stuckbackgroundwakelockrate	stuckBgWakelockRate