REST Resource: anomalies

المورد: Anomaly

تمثّل هذه السمة قيمة شاذة تم رصدها في مجموعة بيانات.

تضع أنظمة رصد القيم الشاذة علامة على نقاط البيانات في سلسلة زمنية تقع خارج النطاق المتوقّع المستمدّ من البيانات السابقة. على الرغم من أنّ هذه النطاقات المتوقّعة تتضمّن حدًا أعلى وحدًا أدنى، لا نضع علامة على القيم الشاذة إلا عندما تصبح البيانات أسوأ بشكل غير متوقّع، وهو ما يحدث عادةً عندما يتجاوز المقياس الحدّ الأعلى.

سيتم تجميع نقاط بيانات متجاورة متعددة في مخطط زمني خارج النطاق المتوقّع في شذوذ واحد. وبالتالي، يمثّل الشذوذ بشكل فعّال جزءًا من المخطط الزمني لمقياس معيّن. يمكن استخدام المعلومات المخزّنة في timelineSpec وdimensions وmetric لاسترداد مخطط زمني كامل بنطاق موسّع للسياق.

الأذونات المطلوبة: للوصول إلى هذا المرجع، يحتاج المستخدم الذي يجري الاتصال إلى إذن عرض معلومات التطبيق (للقراءة فقط) للتطبيق.

تمثيل JSON 
{
  "name": string,
  "metricSet": string,
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    {
      object (DimensionValue)
    }
  ],
  "metric": {
    object (MetricValue)
  }
}
الحقول
name

string

المعرّف. اسم الشذوذ

التنسيق: apps/{app}/anomalies/{anomaly}
metricSet

string

مورد مجموعة المقاييس الذي تم رصد القيمة الشاذة فيه
timelineSpec

object (TimelineSpec)

مواصفات المخطط الزمني التي تغطي فترة القيم الشاذة
dimensions[]

object (DimensionValue)

مجموعة السمات التي تم رصد القيمة الشاذة فيها.
metric

object (MetricValue)

المقياس الذي تم رصد القيمة الشاذة فيه، بالإضافة إلى القيمة الشاذة

TimelineSpec

مواصفات مَعلمات التجميع المرتبطة بالوقت في المخطط الزمني

تتضمّن المخططات الزمنية فترة تجميع (DAILY أو HOURLY أو غير ذلك) تحدّد كيفية تجميع الأحداث في المقاييس.

يتم تحديد النقاط في المخطط الزمني من خلال DateTime لبداية فترة التجميع. تكون المدة مضمّنة في AggregationPeriod.

يتم دائمًا تحديد فترات تجميع البيانات كل ساعة بالتوقيت العالمي المنسّق (UTC) عند توفّرها في مجموعة مقاييس، وذلك لتجنُّب أي غموض بشأن عمليات الانتقال إلى نظام التوقيت الصيفي، حيث يتم تخطّي ساعة واحدة عند اعتماد نظام التوقيت الصيفي، وتكرارها عند التوقف عن استخدامه. على سبيل المثال، الطابع الزمني ‎2021-11-07 01:00:00 America/Los_Angeles غير واضح لأنّه يمكن أن يتوافق مع ‎2021-11-07 08:00:00 UTC أو ‎2021-11-07 09:00:00 UTC.

تتطلّب فترات التجميع اليومية تحديد منطقة زمنية تحدّد اللحظات الدقيقة لبداية اليوم ونهايته. لا تتوافق بعض مجموعات المقاييس مع جميع المناطق الزمنية، لذا احرص على التحقّق من المناطق الزمنية المتوافقة مع مجموعة المقاييس التي تريد طلبها.

تمثيل JSON 
{
  "aggregationPeriod": enum (AggregationPeriod),
  "startTime": {
    object (DateTime)
  },
  "endTime": {
    object (DateTime)
  }
}
الحقول
aggregationPeriod

enum (AggregationPeriod)

اختياريّ. نوع فترة التجميع لنقاط البيانات في المخطط الزمني

يتم تحديد الفواصل الزمنية حسب التاريخ والوقت في بداية الفاصل الزمني.
startTime

object (DateTime)

اختياريّ. نقطة البيانات الأولى في المخطط الزمني (شاملة). يجب أن تكون محاذية لفترة التجميع على النحو التالي:

  • HOURLY: يجب عدم ضبط الحقول "minutes" و"seconds" و"nanos". يمكن ترك timeZone بدون ضبط (يتم ضبطه تلقائيًا على التوقيت العالمي المنسّق) أو ضبطه بشكل صريح على "التوقيت العالمي المنسّق". سيؤدي ضبط أي utcOffset أو معرّف منطقة زمنية آخر إلى حدوث خطأ في التحقّق.
  • DAILY: يجب إلغاء ضبط الحقول "hours" و"minutes" و"seconds" و"nanos". تتيح مجموعات المقاييس المختلفة مناطق زمنية مختلفة. يمكن تركها بدون ضبط لاستخدام المنطقة الزمنية التلقائية المحدّدة من خلال مجموعة المقاييس.

يجب أن تتطابق المنطقة الزمنية لنقطة النهاية مع المنطقة الزمنية لنقطة البداية.
endTime

object (DateTime)

اختياريّ. نقطة البيانات النهائية للمخطط الزمني (غير مشمولة) راجِع startTime للاطّلاع على القيود. يجب أن تتطابق المنطقة الزمنية لنقطة النهاية مع المنطقة الزمنية لنقطة البداية.

DimensionValue

تمثّل قيمة سمة واحدة.

تمثيل JSON 
{
  "dimension": string,
  "valueLabel": string,

  // Union field value can be only one of the following:
  "stringValue": string,
  "int64Value": string
  // End of list of possible types for union field value.
}
الحقول
dimension

string

اسم السمة
valueLabel

string

اختياريّ. تصنيف سهل الاستخدام للقيمة، ويكون دائمًا باللغة الإنجليزية. على سبيل المثال، "إسبانيا" لرمز البلد "ES".

في حين أنّ قيمة السمة ثابتة، فإنّ تصنيف القيمة هذا قابل للتغيير. لا تفترض أنّ العلاقة بين (القيمة، قيمةLabel) ثابتة. على سبيل المثال، تم تغيير اسم رمز البلد وفقًا لمعيار ISO ‏"MK" مؤخرًا إلى "مقدونيا الشمالية".
حقل الربط value القيمة الفعلية للسمة. يعتمد على النوع. يمكن أن يكون التعليق value إحدى القيم التالية فقط:
stringValue

string

القيمة الفعلية، ويتم تمثيلها كسلسلة.
int64Value

string (int64 format)

القيمة الفعلية، ممثّلة كعدد صحيح 64 بت

MetricValue

تمثّل قيمة مقياس.

تمثيل JSON 
{
  "metric": string,

  // Union field value can be only one of the following:
  "decimalValue": {
    object (Decimal)
  }
  // End of list of possible types for union field value.

  // Union field confidence_interval can be only one of the following:
  "decimalValueConfidenceInterval": {
    object (DecimalConfidenceInterval)
  }
  // End of list of possible types for union field confidence_interval.
}
الحقول
metric

string

اسم المقياس.
حقل الربط value القيمة الفعلية للمقياس. يعتمد على النوع. يمكن أن يكون التعليق value إحدى القيم التالية فقط:
decimalValue

object (Decimal)

القيمة الفعلية، ممثَّلة كرقم عشري
حقل الربط confidence_interval تمثّل فاصل ثقة للقيمة، إذا تم توفيره. يمكن أن يكون التعليق confidence_interval إحدى القيم التالية فقط:
decimalValueConfidenceInterval

object (DecimalConfidenceInterval)

فاصل الثقة لقيمة من النوع type.Decimal.

DecimalConfidenceInterval

تمثّل هذه السمة فاصل الثقة لأحد المقاييس.

تمثيل JSON 
{
  "lowerBound": {
    object (Decimal)
  },
  "upperBound": {
    object (Decimal)
  }
}
الحقول
lowerBound

object (Decimal)

الحدّ الأدنى لفاصل الثقة
upperBound

object (Decimal)

الحدّ الأعلى لفاصل الثقة

الطُرق

list

 تعرض هذه البطاقة القيم الشاذة في أيّ من مجموعات البيانات.