REST Resource: anomalies

Ressource: Anomalie

Stellt eine Anomalie dar, die in einem Dataset erkannt wurde.

Unsere Anomalieerkennungssysteme melden Datenpunkte in einer Zeitachse, die außerhalb des erwarteten Bereichs liegen, der aus historischen Daten abgeleitet wird. Obwohl diese erwarteten Bereiche eine Ober- und eine Untergrenze haben, werden Anomalien nur dann gemeldet, wenn sich die Daten unerwartet schlechter entwickelt haben. Dies entspricht in der Regel dem Fall, dass der Messwert die Obergrenze überschreitet.

Mehrere zusammenhängende Datenpunkte auf einer Zeitachse außerhalb des erwarteten Bereichs werden in einer einzelnen Anomalie gruppiert. Daher stellt eine Anomalie ein Segment der Zeitachse eines Messwerts dar. Die in timelineSpec, dimensions und metric gespeicherten Informationen können verwendet werden, um eine vollständige Zeitachse mit erweiterter Rag für den Kontext abzurufen.

Erforderliche Berechtigungen: Für den Zugriff auf diese Ressource benötigt der aufrufende Nutzer die Berechtigung App-Informationen ansehen (schreibgeschützt).

JSON-Darstellung 
{
  "name": string,
  "metricSet": string,
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    {
      object (DimensionValue)
    }
  ],
  "metric": {
    object (MetricValue)
  }
}
Felder
name

string

Name der Anomalie.

Format: apps/{app}/anomalies/{anomaly}
metricSet

string

Messwertsatz-Ressource, bei der die Anomalie erkannt wurde.
timelineSpec

object (TimelineSpec)

Zeitachsenspezifikation für den Anomaliezeitraum.
dimensions[]

object (DimensionValue)

Kombination von Dimensionen, bei denen eine Anomalie erkannt wurde.
metric

object (MetricValue)

Messwert, bei dem die Anomalie und der Anomaliewert erkannt wurden.

Zeitachse

Angabe der zeitbezogenen Aggregationsparameter einer Zeitachse.

Zeitachsen haben einen Aggregationszeitraum (DAILY, HOURLY usw.), der definiert, wie Ereignisse in Messwerten zusammengefasst werden.

Die Punkte in einer Zeitachse werden durch die Startzeit von DateTime des Zusammenfassungszeitraums bestimmt. Die Dauer ist im AggregationPeriod implizit.

Stündliche Aggregationszeiträume werden, sofern von einem Messwertsatz unterstützt, immer in UTC angegeben, um Mehrdeutigkeiten bei der Umstellung auf die Sommerzeit zu vermeiden. Dabei wird bei der Umstellung auf die Sommerzeit eine Stunde ausgelassen. Beispielsweise ist der Zeitstempel „2021-11-07 01:00:00 America/Los_Angeles“ mehrdeutig, da er „2021-11-07 08:00:00 UTC“ oder „2021-11-07 09:00:00 UTC“ entsprechen kann.

Für tägliche Zusammenfassungszeiträume muss eine Zeitzone angegeben werden, die die genauen Zeitpunkte für Beginn und Ende des Tages bestimmt. Nicht alle Messwertgruppen unterstützen alle Zeitzonen. Prüfen Sie daher, welche Zeitzonen von der gewünschten Messwertgruppe unterstützt werden.

JSON-Darstellung 
{
  "aggregationPeriod": enum (AggregationPeriod),
  "startTime": {
    object (DateTime)
  },
  "endTime": {
    object (DateTime)
  }
}
Felder
aggregationPeriod

enum (AggregationPeriod)

Typ des Zusammenfassungszeitraums der Datenpunkte auf der Zeitachse.

Intervalle werden mit dem Datum und der Uhrzeit zu Beginn des Intervalls gekennzeichnet.
startTime

object (DateTime)

Startdatenpunkt der Zeitachse (einschließlich). Muss auf den Zusammenfassungszeitraum ausgerichtet sein:

  • HOURLY: Die Felder „minutes“, „seconds“ und „nanos“ müssen zurückgesetzt werden. Die Zeitzone kann nicht festgelegt werden (Standardeinstellung ist UTC) oder explizit auf „UTC“ festgelegt werden. Das Festlegen einer anderen utcOffset- oder Zeitzonen-ID führt zu einem Validierungsfehler.
  • DAILY: Die Felder „hours“, „minutes“, „seconds“ und „nanos“ müssen gelöscht werden. Unterschiedliche Messwerte unterstützen unterschiedliche Zeitzonen. Sie kann nicht festgelegt werden, um die vom Messwert festgelegte Standardzeitzone zu verwenden.

Die Zeitzone des Endpunkts muss mit der Zeitzone des Startpunkts übereinstimmen.
endTime

object (DateTime)

Endender Datenpunkt der Zeitachse (exklusiv). Siehe startTime für Einschränkungen. Die Zeitzone des Endpunkts muss mit der Zeitzone des Startpunkts übereinstimmen.

DimensionValue

Der Wert einer einzelnen Dimension

JSON-Darstellung 
{
  "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.
}
Felder
dimension

string

Name der Dimension.
valueLabel

string

Optional. Menschenfreundliches Label für den Wert, immer auf Englisch. Beispiel: „Spanien“ für den Ländercode „ES“.

Der Dimensionswert ist zwar stabil, aber dieses Label kann sich ändern. Gehen Sie nicht davon aus, dass die Beziehung (value, valueLabel) stabil ist. Beispielsweise hat der ISO-Ländercode „MK“ kürzlich seinen Namen in „Nordmazedonien“ geändert.
Union-Feld value. Tatsächlicher Wert der Dimension. Typabhängig. Für value ist nur einer der folgenden Werte zulässig:
stringValue

string

Tatsächlicher Wert, dargestellt als String.
int64Value

string (int64 format)

Tatsächlicher Wert, dargestellt int64.

MetricValue

Der Wert eines Messwerts.

JSON-Darstellung 
{
  "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.
}
Felder
metric

string

Name des Messwerts.
Union-Feld value. Tatsächlicher Wert des Messwerts. Typabhängig. Für value ist nur einer der folgenden Werte zulässig:
decimalValue

object (Decimal)

Tatsächlicher Wert, angegeben als Dezimalzahl.
Union-Feld confidence_interval. Wenn angegeben, stellt ein Konfidenzintervall für den Wert dar. Für confidence_interval ist nur einer der folgenden Werte zulässig:
decimalValueConfidenceInterval

object (DecimalConfidenceInterval)

Konfidenzintervall eines Werts vom Typ type.Decimal.

Dezimalkonfidenzintervall

Das Konfidenzintervall eines Messwerts.

JSON-Darstellung 
{
  "lowerBound": {
    object (Decimal)
  },
  "upperBound": {
    object (Decimal)
  }
}
Felder
lowerBound

object (Decimal)

Die Untergrenze des Konfidenzintervalls.
upperBound

object (Decimal)

Die Obergrenze des Konfidenzintervalls.

Methoden

list

 Listet Anomalien in einem der Datasets auf.