ความผิดปกติ

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	อัตรา Conversion
vitals.crashrate	อัตราการขัดข้อง
vitals.excessivewakeuprate	อัตราการปลุกระบบมากเกินไป
vitals.stuckbackgroundwakelockrate	อัตรา Wake Wglock