SLO-Daten abrufen

SLO-Daten werden in Zeitachsen gespeichert. Sie können SLO-Zeitachsen durch Angabe eines Zeitachsenselektors im Parameter filter für die Methode timeSeries.list oder mithilfe von Direct Filter Mode im Metrics Explorer abrufen.

SLO-basierte Benachrichtigungsrichtlinien

Wenn Sie eine Benachrichtigungsrichtlinie mithilfe der Cloud Monitoring API erstellen, geben Sie den Filter mithilfe eines Zeitachsenselektors als Feld in der Schwellenwertbedingung der Richtlinie an. Informationen zum Erstellen von SLO-basierten Benachrichtigungsrichtlinien mit der Monitoring API finden Sie unter Benachrichtigungsrichtlinie erstellen.

In Benachrichtigungsrichtlinien kann nur eine Teilmenge der Zeitachsenselektoren, die für SLOs verfügbar sind, verwendet werden. Außerdem nutzen SLO-basierte Benachrichtigungsrichtlinien, die mit der Google Cloud Console erstellt wurden, immer den Selektor select_slo_burn_rate.

Zeitachsenauswahl in einem Filter verwenden

Zum Abruf von Zeitachsendaten für SLOs muss Ihr Filter einen Zeitachsenselektor enthalten. SLO-Daten werden nicht mit Messwerttypen gespeichert und können nicht mit dem Filter abgerufen werden, der ein Paar aus Messwert- und überwachten Ressourcentypen angibt.

Namen und Argumente

Zeitachsenselektoren haben eins der folgenden Formate:

SELECTOR_NAME(SLO_NAME)
SELECTOR_NAME(SLO_NAME, LOOKBACK_PERIOD)

Die Selektoren haben Namen, die mit select_slo_ beginnen, und können ein oder zwei Argumente annehmen:

  • Das erste Argument des Selektors ist der Ressourcenname für ein SLO, der so aussieht:

    projects/PROJECT_ID/services/SERVICE_ID/serviceLevelObjectives/SLO_ID
    

    Der vorherige Ausdruck enthält drei Variablen:

    • PROJECT_ID: Name oder Nummer eines Google Cloud-Projekts.
    • SERVICE_ID: Name eines Dienstes.
    • SLO_ID: Kennung für ein SLO, das für den Dienst definiert ist.

    Informationen zum Suchen der Werte für die Felder SERVICE_ID und SLO_ID für Ihr Google Cloud-Projekt finden Sie unter Mit der API arbeiten.

  • Das zweite Argument, sofern es unterstützt wird, ist ein Lookback-Zeitraum. Informationen zu Lookback-Zeiträumen finden Sie unter Arten von Fehlerbudgetbenachrichtigungen. Gültige Zeiteinheiten sind "ns", "us", "ms", "s", "m", und "h".

Beispiel: Der select_slo_budget-Selektor verwendet ein SLO_NAME-Argument, sodass ein Filter mit diesem Selektor so aussieht:

select_slo_budget("projects/PROJECT_ID/services/SERVICE_ID/serviceLevelObjectives/SLO_ID")

Im Gegensatz dazu erfordert der Selektor select_slo_burn_rate die Argumente SLO_NAME und LOOKBACK_PERIOD, sodass ein Filter mit diesem Selektor so aussieht:

select_slo_burn_rate("projects/PROJECT_ID/services/SERVICE_ID/serviceLevelObjectives/SLO_ID", "3600s")

Eine Liste und eine Beschreibung aller Selektoren finden Sie unter Zeitachsenselektoren.

Daten mit einem Selektor abrufen

Sie können Zeitachsendaten beispielsweise mit dem APIs Explorer auf der Referenzseite der Methode timeSeries.list abfragen. Weitere Informationen zu diesem Tool finden Sie unter APIs Explorer.

Wenn Sie beispielsweise Informationen zum Budget eines SLO abrufen möchten, füllen Sie die folgenden Felder im Tool "APIs Explorer" aus:

  • Name: projects/PROJECT_ID
  • Filter: select_slo_budget("projects/PROJECT_ID/services/SERVICE_ID/serviceLevelObjectives/SLO_ID")
  • interval.startTime: 2021-10-07T13:00:20-04:00
  • interval.endTime: 2021-10-08T13:00:20-04:00

In einem System werden die folgenden Zeitachsendaten zurückgegeben, nachdem Variablen wie PROJECT_ID durch Werte ersetzt und die Methode ausgeführt wurden:

Auszug aus der abgerufenen Zeitachse

Zeitachsenselektoren

In diesem Abschnitt werden die verfügbaren Zeitachsenselektoren für SLOs aufgeführt und ihre Bedeutung beschrieben. Alle Selektoren können in Filtern mit der Methode timeSeries.list verwendet werden, um Zeitachsendaten abzurufen. Nicht alle davon werden in Benachrichtigungsrichtlinien unterstützt.

select_slo_burn_rate

Syntax: select_slo_burn_rate(SLO_NAME, LOOKBACK_PERIOD)

Die "Brennrate" des Zeitachsenselektors gibt das Verhältnis der aktuellen Fehlerrate (die Rate fehlerhafter Anfragen im Lookback-Zeitraum) zur nachhaltigen Fehlerrate für das SLO zurück. Die nachhaltige Fehlerrate ist die Rate, bei der das SLO genau erreicht wird.

Die Werte in dieser Zeitachse können zwischen 0 und unendlich liegen.

  • Der Wert 1 bedeutet, dass der Dienst die ideale Fehlerrate aufweist: nicht zu riskant, nicht zu konservativ.
  • Ein Wert über 1 bedeutet, dass die Fehlerrate über der nachhaltigen Rate liegt. Je höher der Wert ist, desto eher wird das SLO nicht mehr den Compliance-Vorgaben entsprechen.
  • Ein Wert unter 1 bedeutet, dass die aktuelle Fehlerrate unter der nachhaltigen Rate liegt.

Wir empfehlen die Verwendung von zwei Benachrichtigungsrichtlinien, um die Brennrate zu beobachten: eine Fast-Burn-Richtlinie, die Sie über Spitzen der Brennrate benachrichtigt, und eine Slow-Burn-Richtlinie, die über schrittweise Steigerungen informiert.

In der API oder der Console können Sie basierend auf diesem Zeitachsenselektor Benachrichtigungsrichtlinien erstellen und bearbeiten.

Alle SLO-basierten Benachrichtigungsrichtlinien, die mithilfe der Console erstellt wurden, verwenden diesen Selektor zum Abrufen der SLO-Daten.

select_slo_health

Syntax: select_slo_health(SLO_NAME)

Die Zeitachse "SLO-Status" beantwortet die Frage "Wie hoch war der Anteil der fehlerfreien Anfragen an der Gesamtzahl der Anfragen während eines bestimmten Ausrichtungszeitraums?". Der SLI für den Dienst definiert, was als fehlerfreie Anfrage zählt. Weitere Informationen zu SLIs finden Sie unter Übersicht.

Diese Zeitachse misst die Serviceleistung: Wenn alle Anfragen an den Dienst fehlerfrei sind, haben die Datenpunkte in dieser Zeitachse den Wert 1. Wenn die Zahl der fehlerhaften Anfragen steigt, sinken die Werte der Datenpunkte.

select_slo_compliance

Syntax: select_slo_compliance(SLO_NAME)

Die Zeitachse "SLO-Compliance" beantwortet die Frage "Wie hoch ist der Anteil der fehlerfreien Einheiten an der Gesamtzahl der Einheiten seit Beginn des Compliance-Zeitraums?". Das SLO definiert den Compliance-Zeitraum als gleitendes Fenster oder als Zeitraum im Kalender. Die Einheit kann eine Anfrage oder ein Zeitfenster sein. Weitere Informationen finden Sie unter Compliance bei anfrage- und zeitfensterbasierten SLOs.

Mit dieser Zeitachse verschaffen Sie sich einen allgemeinen Überblick, wie gut der Dienst dem SLO entspricht. Sie signalisiert keine dringenden betrieblichen Vorgänge.

Verwenden Sie diesen Zeitachsenselektor nicht in Benachrichtigungsrichtlinien.

select_slo_budget

Syntax: select_slo_budget(SLO_NAME)

Die Zeitachse "SLO-Budget" beantwortet die Frage: "Welcher Anteil des Fehlerbudgets war zum Zeitpunkt der Messung noch nicht ausgeschöpft?". Das Fehlerbudget kann in Anfragen oder Minuten gemessen werden. Die Berechnung des verbleibenden Budgets richtet sich danach, ob der Compliancezeitraum als Kalenderzeit oder als gleitendes Fenster gemessen wurde. Weitere Informationen finden Sie unter Fehlerbudgets.

Diese Zeitachse misst das Risiko der Zuverlässigkeit eines Dienstes. Wenn das Fehlerbudget kleiner als null wird, ist es möglicherweise nicht möglich, das SLO für den aktuellen Zeitraum zu erfüllen. Wenn ein SLO nicht eingehalten wird, kann dies konkrete Konsequenzen für die Produktionsumgebung einer Organisation haben, je nachdem, wie zuverlässig die Organisation ist.

Verwenden Sie diesen Zeitachsenselektor nicht in Benachrichtigungsrichtlinien.

select_slo_budget_fraction

Syntax: select_slo_budget_fraction(SLO_NAME)

Die Zeitachse "SLO-Budgetanteil" beantwortet die Frage: "Welcher Anteil des Fehlerbudgets als Bruchteil zwischen negativ unendlich und 1 verbleibt zum aktuellen Zeitpunkt?"

Verwenden Sie diesen Zeitachsenselektor nicht in Benachrichtigungsrichtlinien.

select_slo_budget_total

Syntax: select_slo_budget_total(SLO_NAME)

Die Zeitachse "SLO-Gesamtbudget" beantwortet die Frage: "Wie hoch ist das Gesamtfehlerbudget (in Anfragen oder Minuten), das vom Beginn des Compliancezeitraums bis zum aktuellen Zeitpunkt voraussichtlich verfügbar ist?" Das SLO definiert den Compliance-Zeitraum als gleitendes Fenster oder Bereich der Kalenderzeit.

Verwenden Sie diesen Zeitachsenselektor nicht in Benachrichtigungsrichtlinien.

select_slo_counts

Syntax: select_slo_counts(SLO_NAME)

Die Zeitachse "SLO zählt" beantwortet die Frage: "Wie viele gute und schlechte Anfragen gibt es in einem bestimmten Ausrichtungszeitraum?" Diese Auswahl stellt eine Zeitachse bereit, die den allgemeinen Zustand aufzeichnet und für die Aufnahme in Langzeitspeichersysteme geeignet ist.

Verwenden Sie diesen Zeitachsenselektor nicht in Benachrichtigungsrichtlinien.