الِقَيم الشاذة

تتيح لك واجهة برمجة التطبيقات 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	anrRate
vitals.crashrate	crashRate
vitals.excessivewakeuprate	excessiveWakeupRate
vitals.stuckbackgroundwakelockrate	stuckBgWakelockRate