REST Resource: anomalies

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

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

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

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

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

نمایندگی 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 ، و غیره) هستند که نحوه جمع‌آوری رویدادها را در معیارها مشخص می‌کند.

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

دوره‌های تجمع ساعتی، زمانی که توسط یک مجموعه متریک پشتیبانی می‌شود، همیشه در UTC مشخص می‌شود تا از ابهامات در مورد انتقال زمان تابستانی جلوگیری شود، جایی که در هنگام پذیرش DST یک ساعت حذف می‌شود و هنگام رها کردن DST تکرار می‌شود. برای مثال، مهر زمانی «2021-11-07 01:00:00 America/Los_Angeles» مبهم است زیرا می تواند با «07-11-2021 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 )

نقطه داده شروع خط زمانی (شامل). باید با دوره تجمیع به صورت زیر تراز شود:

  • ساعتی: فیلدهای «دقیقه»، «ثانیه» و «نانو» باید تنظیم نشده باشند. TimeZone را می توان تنظیم نشده رها کرد (به طور پیش فرض روی UTC) یا به صراحت روی "UTC" تنظیم کرد. تنظیم هر utcOffset یا شناسه منطقه زمانی دیگر منجر به خطای اعتبارسنجی می شود.
  • روزانه: فیلدهای «ساعت»، «دقیقه»، «ثانیه» و «نانو» باید تنظیم نشده باشند. مجموعه‌های متریک مختلف از مناطق زمانی مختلف پشتیبانی می‌کنند. برای استفاده از منطقه زمانی پیش‌فرض مشخص‌شده توسط مجموعه متریک، می‌توان تنظیم نشد.

منطقه زمانی نقطه پایان باید با منطقه زمانی نقطه شروع مطابقت داشته باشد.

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".

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

value فیلد اتحادیه ارزش واقعی ابعاد وابسته به نوع value فقط می تواند یکی از موارد زیر باشد:
stringValue

string

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

int64Value

string ( int64 format)

مقدار واقعی، به عنوان int64 نشان داده شده است.

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

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