REST Resource: anomalies

المورد: قيمة شاذة

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

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

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

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

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

string

اسم القيمة الشاذة.

التنسيق: التطبيقات/{app}/القيم الشاذة/{anomaly}
metricSet

string

مورد مجموعة المقاييس حيث تم اكتشاف قيمة شاذة
timelineSpec

object (TimelineSpec)

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

object (DimensionValue)

مجموعة من الأبعاد تم فيها اكتشاف قيمة شاذة
metric

object (MetricValue)

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

مواصفات المخطط الزمني

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

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

يتم تحديد النقاط في المخطط الزمني من خلال تاريخ البدء في فترة التجميع. المدة هي ضمنية في AggregationPeriod.

يتم دائمًا تحديد فترات التجميع كل ساعة عند دعمها بواسطة مجموعة من المقاييس، وذلك بالتوقيت العالمي المتَّفق عليه لتجنُّب الغموض في عمليات تبديل التوقيت الصيفي، حيث يتم تخطي ساعة عند استخدام التوقيت الصيفي، وتكرارها عند ترك التوقيت الصيفي. على سبيل المثال، الطابع الزمني "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)

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

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

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

object (DateTime)

نقطة نهاية البيانات للمخطط الزمني (حصري). راجع starttime لمعرفة القيود. يجب أن تتطابق المنطقة الزمنية لنقطة النهاية مع المنطقة الزمنية لنقطة البداية.

قيمة السمة

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

تمثيل 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".

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

string

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

string (int64 format)

القيمة الفعلية، ممثلة بتنسيق int64.

قيمة المقياس

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

تمثيل 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.

الفاصل العشري للثقة

يمثل فاصل الثقة للمقياس.

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

object (Decimal)

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

object (Decimal)

الحد الأقصى لفاصل الثقة.

الطُرق

list

 يسرد الحالات غير الطبيعية في أي من مجموعات البيانات.