Oracle Cloud Infrastructure - Dokumentation

groupBy(x) in einer Abfrage verwenden

Verwenden Sie das optionale Element groupBy(x) bei der Abfrage von Metrikdaten in Monitoring.

Aggregieren Sie die Abfrageergebnisse nach Gruppe, um einen Wert für jede Gruppe darzustellen. Diese Option gibt den kombinierten Wert aller Metrikstreams in jeder angegebenen Gruppe für die ausgewählte Statistik zurück. Der kombinierte Wert jeder Gruppe wird als eine einzelne Zeile im Metrikdiagramm dargestellt. Diese Option ist hilfreich, wenn Sie Trends nach Gruppe und nicht nach einzelner Ressource identifizieren möchten.

Informationen zur Fehlerbehebung bei Abfragen finden Sie unter Fehlerbehebung bei Abfragen.

Beispiele

Beispiel 1: Nach Faultdomain gruppieren
CpuUtilization[1m].groupBy(faultDomain).mean()
Beispiel 2: Nach Ressourcengruppe gruppieren
CpuUtilization[1m].groupBy(resourceGroup).mean()

  • In diesem Abschnitt wird beschrieben, wie Sie groupBy(x) auf der Seite Metrics Explorer verwenden. groupBy(x) ist nur im erweiterten Modus (MQL) verfügbar. Informationen zum Bearbeiten von Alarmabfragen finden Sie unter Grundlegenden Alarm erstellen.

    1. Erstellen Sie auf der Seite Metrik-Explorer eine allgemeine Abfrage.
    2. Wenn die Abfrage nicht geöffnet ist, öffnen Sie sie, indem Sie Abfragen bearbeiten auswählen.
    3. Wählen Sie Erweiterter Modus aus.
    4. Bearbeiten Sie den Text im Feld Abfragecodeeditor.

      Der folgende MQL-Beispielausdruck gruppiert nach Faultdomain:

      CpuUtilization[1m].groupBy(faultDomain).mean()

      Das Diagramm aus Beispiel für Abfrage und Metrikdiagramm zeigt jetzt drei Metrikstreams. Jeder Metrikstream entspricht einer Faultdomain und aggregiert alle Compute-Instanzen in dieser Faultdomain.

      Nach Faultdomain aggregierte Metrikstreams.

    5. Wählen Sie Diagramm aktualisieren aus.

  • Verwenden Sie den Befehl oci monitoring metric-data summarize-metrics-data und die erforderlichen Parameter, um Metrikdaten abzufragen. Verwenden Sie den Parameter --query-text, um das Element groupBy(x) (Teil des MQL-Ausdrucks) zu verwenden.

    oci monitoring metric-data summarize-metrics-data --query-text <mql_expression> [...]

    Eine vollständige Liste der Parameter und Werte für CLI-Befehle finden Sie in der Befehlszeilenreferenz für Monitoring.

  • Führen Sie den Vorgang SummarizeMetricsData aus, um Metrikdaten abzufragen. Verwenden Sie das Attribut query, um das Element groupBy(x) (Teil des MQL-Ausdrucks) zu verwenden.