Sự cố bất thường

API Google Play Developer Reporting cho phép bạn truy xuất các điểm bất thường trong bộ chỉ số. Hệ thống sẽ tạo một điểm bất thường mỗi khi giá trị của chỉ số vượt quá phạm vi dự kiến của chỉ số, dựa trên 28 ngày trước đó của giá trị cho chỉ số đó. Những điểm bất thường trong những ngày liên tiếp sẽ được hợp nhất thành một kết quả bất thường.

Nếu sự gia tăng giá trị bất thường trong một chỉ số đủ lâu, thì mô hình phát hiện sẽ điều chỉnh và mở rộng các giá trị dự kiến cho đến khi các điểm dữ liệu tiếp theo không bị coi là bất thường nữa.

Truy xuất điểm bất thường

Bạn có thể liệt kê các điểm bất thường bằng phương thức anomalies.list.

Yêu cầu đơn giản:

Yêu cầu HTTP GET này chỉ định tham số tên ứng dụng và trả về danh sách đầy đủ các điểm bất thường đã phát hiện cho ứng dụng của bạn.

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

Phản hồi bất thường:

Phản hồi bao gồm đủ thông tin để truy vấn chính xác nơi xảy ra điểm bất thường:

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

Yêu cầu được lọc:

Bạn có thể áp dụng bộ lọc để chỉ trả về các điểm bất thường đã hoạt động trong một khoảng thời gian cụ thể. Để thực hiện việc này, hãy chỉ định hàm activeBetween(start, end) trong trường bộ lọc trong yêu cầu. Bạn có thể chỉ định các giới hạn không giới hạn ở hai bên của dải ô bằng từ khoá đặc biệt UNBOUNDED. Nếu chỉ định giới hạn bắt đầu hoặc kết thúc thì bạn phải tuân theo định dạng RFC 3339, ví dụ: 2022-02-22T04:00Z.

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

Câu trả lời được lọc:

Phản hồi chỉ bao gồm những điểm bất thường đã hoạt động trong khoảng thời gian chỉ định:

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

Các chỉ số có sẵn:

Hiện tại, không phải chỉ số và tập hợp chỉ số nào cũng hỗ trợ tính năng phát hiện hoạt động bất thường. Sau đây là danh sách các chỉ số được hỗ trợ:

Tập hợp chỉ số	Chỉ số được hỗ trợ
vitals.anrrate	tỷ lệ thay đổi
vitals.crashrate	tỷ lệ sự cố
vitals.excessivewakeuprate	Tỷ lệ đánh thức quá nhiều lần
vitals.stuckbackgroundwakelockrate	Tỷ lệ lỗi khung thức