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

تتيح لك واجهة برمجة التطبيقات 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	معدل
vitals.crashrate	نسبة الأعطال
vitals.excessivewakeuprate	معدل التنشيط الزائد
vitals.stuckbackgroundwakelockrate	متوقف معدل التنشيط