REST Resource: anomalies

منبع: ناهنجاری

نشان دهنده یک ناهنجاری شناسایی شده در یک مجموعه داده است.

سیستم‌های تشخیص ناهنجاری ما، نقاط داده‌ای را در یک سری زمانی که خارج از محدوده مورد انتظار مشتق شده از داده‌های تاریخی قرار می‌گیرند، علامت‌گذاری می‌کنند. اگرچه این محدوده‌های مورد انتظار دارای حد بالا و پایین هستند، ما فقط زمانی ناهنجاری‌ها را علامت‌گذاری می‌کنیم که داده‌ها به طور غیرمنتظره‌ای بدتر شده باشند، که معمولاً مربوط به موردی است که معیار از حد بالا عبور می‌کند.

چندین نقطه داده پیوسته در یک جدول زمانی خارج از محدوده مورد انتظار، در یک ناهنجاری واحد گروه‌بندی می‌شوند. بنابراین، یک ناهنجاری به طور مؤثر بخشی از جدول زمانی یک معیار را نشان می‌دهد. اطلاعات ذخیره شده در timelineSpec ، dimensions و metric می‌توان برای دریافت یک جدول زمانی کامل با ragne گسترده برای متن استفاده کرد.

مجوزهای مورد نیاز : برای دسترسی به این منبع، کاربر فراخوانی‌کننده به مجوز مشاهده اطلاعات برنامه (فقط خواندنی) برای برنامه نیاز دارد.

نمایش 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 )

معیاری که در آن ناهنجاری تشخیص داده شده است، به همراه مقدار ناهنجاری.

مشخصات خط زمانی

مشخصات پارامترهای تجمیع مرتبط با زمان در یک جدول زمانی.

جدول‌های زمانی یک دوره تجمیع ( DAILY ، HOURLY و غیره) دارند که نحوه تجمیع رویدادها در معیارها را تعریف می‌کند.

نقاط در یک جدول زمانی توسط DateTime شروع دوره تجمیع تعریف می‌شوند. مدت زمان به طور ضمنی در AggregationPeriod وجود دارد.

دوره‌های تجمیع ساعتی، هنگامی که توسط یک مجموعه معیار پشتیبانی می‌شوند، همیشه در UTC مشخص می‌شوند تا از ابهامات پیرامون انتقال زمان تابستانی جلوگیری شود، که در آن هنگام پذیرش DST یک ساعت حذف می‌شود و هنگام کنار گذاشتن DST تکرار می‌شود. به عنوان مثال، مهر زمانی '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: فیلدهای «دقیقه»، «ثانیه» و «نانوس» باید تنظیم نشده باشند. منطقه زمانی را می‌توان تنظیم نشده (پیش‌فرض UTC) گذاشت یا صریحاً روی «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».

در حالی که مقدار بُعد پایدار است، این برچسب مقدار در معرض تغییر است. فرض نکنید که رابطه (مقدار، برچسب ارزش) پایدار است. برای مثال، کد کشور ISO 'MK' اخیراً نام خود را به 'مقدونیه شمالی' تغییر داده است.

value فیلد Union. مقدار واقعی بُعد. وابسته به نوع. 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 فیلد Union. مقدار واقعی معیار. وابسته به نوع. value می‌تواند فقط یکی از موارد زیر باشد:
decimalValue

object ( Decimal )

مقدار واقعی، که به صورت یک عدد اعشاری نمایش داده می‌شود.

فیلد union confidence_interval . در صورت وجود، نشان‌دهنده‌ی یک بازه اطمینان برای مقدار است. confidence_interval فقط می‌تواند یکی از موارد زیر باشد:
decimalValueConfidenceInterval

object ( DecimalConfidenceInterval )

فاصله اطمینان مقداری که از نوع اعشاری type.Decimal است.

بازه اطمینان اعشاری

نشان دهنده فاصله اطمینان یک معیار است.

نمایش JSON 
{
  "lowerBound": {
    object (Decimal)
  },
  "upperBound": {
    object (Decimal)
  }
}
فیلدها
lowerBound

object ( Decimal )

حد پایین فاصله اطمینان.

upperBound

object ( Decimal )

حد بالای فاصله اطمینان.

روش‌ها

list

 ناهنجاری‌ها را در هر یک از مجموعه داده‌ها فهرست می‌کند.