Documentation Oracle Cloud Infrastructure

Sélection de dimensions pour une requête

Limitez les données de mesure renvoyées en sélectionnant des dimensions lors de l'interrogation des données de mesure dans Monitoring. Une dimension est un qualificatif fourni dans une définition de mesure. Dans MQL, le composant de sélection de dimension indique des paires nom-valeur pour les dimensions, entourées par des accolades.

Pour le dépannage des requêtes, reportez-vous à Dépannage des requêtes.

Exemples
Remarque

Les guillemets autour de la valeur (comme dans "FAULT-DOMAIN-1") peuvent être omis sauf si la valeur contient des espaces ou si elle est utilisée dans la correspondance partielle.
Exemple 1. Domaine de pannes
CpuUtilization[1m]{faultDomain = "FAULT-DOMAIN-1"}.mean()
Exemple 2. Compartiment
IopsRead[1m]{compartmentId="ocid1.compartment.oc1.phx..exampleuniqueID"}.grouping().max()
Exemple 3. Forme (avec regroupement)
CpuUtilization[1m]{shape="VM.Standard.E4.Flex"}.groupBy(availabilityDomain,poolId).mean()
Exemple 4. Plusieurs paires nom-valeur de dimension : domaine de pannes, nom et forme
CpuUtilization [1m]{faultDomain = "FAULT-DOMAIN-1", resourceDisplayName = "test", shape = "myshape"}.mean()
Les dimensions de cette requête sont traitées avec un opérateur AND. Les données obtenues incluent uniquement les flux de données de mesure qui correspondent à toutes les dimensions.
Exemple 5. Plusieurs valeurs pour une dimension : domaine de pannes 1 ou 2
CpuUtilization [1m]{faultDomain =~ "FAULT-DOMAIN-1|FAULT-DOMAIN-2"}.mean()
Les valeurs de dimension de cette requête sont traitées avec un opérateur OR, à l'aide de la correspondance partielle. (La correspondance partielle n'est disponible que dans les expressions MQL. Dans la console, utilisez le mode avancé.) Les données obtenues incluent les flux de données de mesure qui correspondent à l'une ou l'autre des valeurs.
Correspondance partielle

Indiquez des correspondances approximatives ("partielles") avec des valeurs de dimension dans une expression MQL.

Remarque

La correspondance partielle n'est disponible que dans les expressions MQL. Dans la console, utilisez le mode avancé.

A la place du signe égal (=) entre le nom et l'ensemble de valeurs de dimension, utilisez l'opérateur de comparaison suivant.

Opérateur de comparaison Description
=~ (signe égal suivi du tilde) Presque égal à. Utiliser pour les correspondances partielles

Pour une correspondance partielle, entourez l'ensemble de valeurs de guillemets : name = "val*" ou name = "value1|value2"

Mettez à jour l'ensemble de valeurs à l'aide des caractères suivants.

Caractère de correspondance partielle de valeur Description
* (astérisque) Caractère générique, indiquant zéro à plusieurs caractères.
|(barre verticale) Opérande OR pour les valeurs de dimension.

Exemple de mise en correspondance partielle pour trois ensembles de valeurs de dimension (instances de calcul de test dans le domaine de pannes 1 qui utilisent la forme myshape) :

CpuUtilization [1m]{faultDomain =~ "FAULT-DOMAIN-1", resourceDisplayName =~ "test*", shape =~ "myshape"}.mean()
Exclusion de valeurs

Filtrez (excluez) des valeurs de dimension dans une expression MQL.

Remarque

L'exclusion de valeurs n'est disponible que dans les expressions MQL. Dans la console, utilisez le mode avancé.

A la place du signe égal (=) entre le nom et l'ensemble de valeurs de dimension, utilisez l'un des opérateurs de comparaison suivants.

Opérateur de comparaison Description
!= (point d'exclamation suivi du signe égal) Différent de. Permet d'exclure une valeur de dimension unique.
!~ (point d'exclamation suivi du tilde) Différent de. Utilisez cette option pour exclure plusieurs valeurs de dimension (lorsque l'expression utilise des caractères génériques ou des opérateurs OR).

Si vous utilisez l'opérateur de comparaison !~, mettez à jour l'ensemble de valeurs de dimension à l'aide des caractères suivants.

Caractère de correspondance partielle de valeur Description
* (astérisque) Caractère générique, indiquant zéro à plusieurs caractères.
|(barre verticale) Opérande OR pour les valeurs de dimension.

Exemple 1 (valeur unique) : requête de base pour l'utilisation de l'UC, excluant le domaine de pannes 1.

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

Exemple 2 (plusieurs valeurs) : requête de base pour l'utilisation de l'UC, excluant les domaines de pannes 1 et 2.

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

  • Cette section explique comment sélectionner des dimensions sur la page explorateur de mesures. Pour obtenir des informations sur les modifications de requête d'alarme, reportez-vous à Création d'une alerte de base.

    1. Créez une requête de base sur la page explorateur de mesures.
    2. Si la requête n'est pas ouverte, ouvrez-la en cliquant sur Modifier les requêtes.
    3. Pour sélectionner des dimensions en mode de base (mode par défaut), indiquez des valeurs pour les champs suivants :
      Remarque

      Des champs de dimension supplémentaires ou autres apparaissent pour certains espaces de noms de mesure. Par exemple, un champ de type de déploiement apparaît pour l'espace de noms de mesure oci_autonomous_database. Pour plus d'informations, reportez-vous à la documentation propre au service.
      • Nom de la dimension : attribut indiqué dans la définition de mesure. Par exemple, la dimension resourceId est spécifiée dans la définition de mesure pour CpuUtilization.

        Pour sélectionner une ressource spécifique dans le compartiment sélectionné, filtrez les résultats selon une dimension propre à la ressource, telle que resourceDisplayName.

        Remarque

        Les longues listes de dimensions sont tronquées.

        • Pour afficher les dimensions par nom, saisissez des caractères dans la zone. Une liste actualisée (tronquée) contient les noms de dimension correspondants.
        • Afin d'extraire toutes les dimensions pour une mesure, reportez-vous à Liste des définitions de mesure.
      • Valeur de dimension : valeur à utiliser pour la dimension spécifiée, par exemple l'identificateur de ressource d'une instance.
      • Dimension supplémentaire : ajoute une autre paire nom-valeur pour une dimension.
    4. Pour sélectionner des dimensions en mettant à jour l'expression MQL, procédez comme suit :
      1. Cliquez sur Mode avancé.
      2. Edit the text in the Query code editor box.

        Exemple de dimension dans une expression MQL :

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

        Dans cet exemple, la requête limite les données renvoyées au domaine de pannes 1. Le graphique de l'exemple de requête et de graphique de mesures présente désormais quatre flux de données de mesure. Chaque flux de données de mesure correspond à une instance du domaine de pannes 1.Flux de données de mesure filtrés sur un seul domaine de pannes.

    5. Cliquez sur Mettre le graphique à jour.

  • Utilisez la commande oci monitoring metric-data summarize-metrics-data et les paramètres requis pour interroger les données de mesure. Utilisez le paramètre --query-text pour sélectionner des dimensions (partie de l'expression MQL).

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

    Pour obtenir la liste complète des paramètres et des valeurs des commandes d'interface de ligne de commande, reportez-vous à Référence de ligne de commande pour Monitoring.

  • Exécutez l'opération SummarizeMetricsData pour interroger des données de mesure. Utilisez l'attribut query pour sélectionner des dimensions (partie de l'expression MQL). Pour obtenir un exemple, reportez-vous à SummarizeMetricsDataDetails.