Oracle Cloud Infrastructure - Dokumentation

Dimensionen für eine Abfrage auswählen

Begrenzen Sie zurückgegebene Metrikdaten, indem Sie bei der Abfrage von Metrikdaten in Monitoring Dimensionen auswählen. Eine Dimension ist ein Qualifier, der in einer Metrikdefinition angegeben wird. In MQL gibt die Dimensionsauswahlkomponente Name/Wert-Paare für Dimensionen in geschweiften Klammern an.

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

Beispiele
Hinweis

Anführungszeichen um den Wert (wie in "FAULT-DOMAIN-1") können weggelassen werden, außer der Wert enthält Leerzeichen oder wird bei der Fuzzy-Suche verwendet.
Beispiel 1: Faultdomain
CpuUtilization[1m]{faultDomain = "FAULT-DOMAIN-1"}.mean()
Beispiel 2: Compartment
IopsRead[1m]{compartmentId="ocid1.compartment.oc1.phx..exampleuniqueID"}.grouping().max()
Beispiel 3: Ausprägung (mit Gruppierung)
CpuUtilization[1m]{shape="VM.Standard.E4.Flex"}.groupBy(availabilityDomain,poolId).mean()
Beispiel 4: Mehrere Name/Wert-Paare für Dimensionen: Faultdomain, Name und Ausprägung
CpuUtilization [1m]{faultDomain = "FAULT-DOMAIN-1", resourceDisplayName = "test", shape = "myshape"}.mean()
Die Dimensionen in dieser Abfrage werden mit einem AND-Operator verarbeitet. Die resultierenden Daten umfassen nur die Metrikstreams, die allen Dimensionen entsprechen.
Beispiel 5: Mehrere Werte für eine Dimension: Faultdomain 1 oder 2
CpuUtilization [1m]{faultDomain =~ "FAULT-DOMAIN-1|FAULT-DOMAIN-2"}.mean()
Die Dimensionswerte in dieser Abfrage werden mit einem OR-Operator bei der Fuzzy-Suche verarbeitet. (Die Fuzzy-Suche ist nur in MQL-Ausdrücken verfügbar. Verwenden Sie in der Konsole den Modus "Erweitert".) Die resultierenden Daten umfassen Metrikstreams, die mit einem der Werte übereinstimmen.
Fuzzy-Suche

Geben Sie ungefähre ("Fuzzy-")Übereinstimmungen mit Dimensionswerten in einem MQL-Ausdruck an.

Hinweis

Die Fuzzy-Suche ist nur in MQL-Ausdrücken verfügbar. Verwenden Sie in der Konsole den erweiterten Modus.

Verwenden Sie statt des Gleichheitszeichens (=) zwischen Dimensionsname und Werteset den folgenden Vergleichsoperator.

Vergleichsoperator Beschreibung
=~ (Gleichheitszeichen gefolgt von Tilde) Ungefähr gleich. Für Fuzzy-Übereinstimmungen verwenden

Bei einer Fuzzy-Suche setzen Sie das Werteset in Anführungszeichen: name = "val*" oder name = "value1|value2"

Aktualisieren Sie das Werteset mit mindestens einem der folgenden Zeichen.

Zeichen für Fuzzy-Übereinstimmung eines Werts Beschreibung
* (Sternchen) Platzhalter für null bis viele Zeichen.
| (Pipe) OR-Operand für Dimensionswerte.

Beispiel für einen Fuzzy-Abgleich für drei Dimensionswertesets (Test von Compute-Instanzen in Faultdomain 1 mit der Ausprägung myshape):

CpuUtilization [1m]{faultDomain =~ "FAULT-DOMAIN-1", resourceDisplayName =~ "test*", shape =~ "myshape"}.mean()
Werte ausschließen

Sie können Dimensionswerte in einem MQL-Ausdruck herausfiltern (ausschließen).

Hinweis

Das Ausschließen von Werten ist nur in MQL-Ausdrücken verfügbar. Verwenden Sie in der Konsole den erweiterten Modus.

Verwenden Sie anstelle des Gleichheitszeichens (=) zwischen Dimensionsnamen und Werteset einen der folgenden Vergleichsoperatoren.

Vergleichsoperator Beschreibung
!= (Ausrufezeichen gefolgt von Gleichheitszeichen) Ungleich. Dient zum Filtern eines einzelnen Dimensionswerts.
!~ (Ausrufezeichen gefolgt von Tilde) Ungleich. Mit dieser Option können Sie mehrere Dimensionswerte herausfiltern (wenn der Ausdruck Platzhalter oder OR-Operanden verwendet).

Wenn Sie den Vergleichsoperator !~ verwenden, aktualisieren Sie das Dimensionswerteset mit mindestens einem der folgenden Zeichen.

Zeichen für Fuzzy-Übereinstimmung eines Werts Beschreibung
* (Sternchen) Platzhalter für null bis viele Zeichen.
| (Pipe) OR-Operand für Dimensionswerte.

Beispiel 1 (Einzelwert): Allgemeine Abfrage der CPU-Auslastung, ausgenommen Faultdomain 1.

CpuUtilization [1m]{faultDomain != "FAULT-DOMAIN-1"}.mean()

Beispiel 2 (Mehrere Werte): Allgemeine Abfrage der CPU-Auslastung, ausgenommen Faultdomains 1 und 2.

CpuUtilization [1m]{faultDomain !~ "FAULT-DOMAIN-1|FAULT-DOMAIN-2"}.mean()

  • In diesem Abschnitt wird beschrieben, wie Sie Dimensionen auf der Seite Metrics Explorer auswählen. 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. Um Dimensionen im Basismodus (Standard) auszuwählen, geben Sie Werte für die folgenden Felder an:
      Hinweis

      Für einige Metrik-Namespaces werden zusätzliche oder andere Dimensionsfelder angezeigt. Beispiel: Für den Metrik-Namespace oci_autonomous_database wird ein Deployment-Typfeld angezeigt. Weitere Einzelheiten finden Sie in der servicespezifischen Dokumentation.
      • Dimensionsname: Ein in der Metrikdefinition angegebener Qualifier. Beispiel: Die Dimension resourceId wird in der Metrikdefinition für CpuUtilization angegeben.

        Um eine bestimmte Ressource im ausgewählten Compartment auszuwählen, filtern Sie die Ergebnisse nach einer ressourcenspezifischen Dimension. Beispiel: resourceDisplayName.

        Hinweis

        Lange Listen von Dimensionen werden abgeschnitten.

        • Um Dimensionen nach Name anzuzeigen, geben Sie mindestens ein Zeichen in das Feld ein. In einer aktualisierten (abgeschnittenen) Liste werden übereinstimmende Dimensionsnamen angezeigt.
        • Informationen zum Abrufen aller Dimensionen für eine Metrik finden Sie unter Metrikdefinitionen auflisten.
      • Dimensionswert: Der Wert, den Sie für die angegebene Dimension verwenden möchten, z.B. die Ressourcen-ID für eine Instanz.
      • Weitere Dimension: Fügt ein weiteres Name/Wert-Paar für eine Dimension hinzu.
    4. So wählen Sie Dimensionen durch Aktualisieren des MQL-Ausdrucks aus:
      1. Wählen Sie Erweiterter Modus aus.
      2. Bearbeiten Sie den Text im Feld Abfragecodeeditor.

        Dimensionsbeispiel in einem MQL-Ausdruck:

        CpuUtilization[1m]{faultDomain = "FAULT-DOMAIN-1"}.mean()

        In diesem Beispiel begrenzt die Abfrage die zurückgegebenen Daten auf Faultdomain 1. Das Diagramm aus Beispiel für Abfrage und Metrikdiagramm zeigt jetzt vier Metrikstreams. Jeder Metrikstream entspricht einer Instanz in Faultdomain 1.Nach einer einzelnen Faultdomain gefilterte 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 Dimensionen (Teil des MQL-Ausdrucks) auszuwählen.

    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 Dimensionen (Teil des MQL-Ausdrucks) auszuwählen. Ein Beispiel finden Sie unter SummarizeMetricsDataDetails.