Sự cố bất thường

API Báo cáo của Nhà phát triển Google Play cho phép bạn truy xuất các điểm bất thường được phát hiện trong các tập hợp chỉ số. Hệ thống sẽ tạo ra 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 các giá trị cho cùng một chỉ số. Các điểm bất thường trong những ngày liên tiếp được hợp nhất thành một kết quả bất thường duy nhất.

Nếu giá trị của một chỉ số tăng bất thường trong một thời gian đủ dài, 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 còn được 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 được 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 về điểm bất thường:

Phản hồi này chứa đủ thông tin để truy vấn chính xác vị trí 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ề những đ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 giới hạn không ràng buộc ở cả hai phía của phạm vi bằng từ khoá đặc biệt UNBOUNDED. Nếu chỉ định ranh giới bắt đầu hoặc kết thúc, thì ranh giới đó 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)

Phản hồi đã lọc:

Phản hồi chỉ bao gồm những điểm bất thường đang hoạt động trong phạm vi thời gian được 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ố hiện có

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

Bộ chỉ số	Chỉ số được hỗ trợ
vitals.anrrate	anrRate
vitals.crashrate	crashRate
vitals.excessivewakeuprate	excessiveWakeupRate
vitals.stuckbackgroundwakelockrate	stuckBgWakelockRate