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, utiliser 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 est disponible uniquement dans les expressions MQL. Dans la console, utiliser 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) Approximativement égal à. A utiliser pour les correspondances partielles

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

Mettez à jour l'ensemble de valeurs en utilisant les 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 correspondance partielle pour les jeux de valeurs de trois dimensions (correspondance partielle pour trois ensembles de valeurs de dimension 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, utiliser 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. A utiliser pour exclure une valeur d'une dimension unique.
!~ (point d'exclamation suivi du tilde) Différent de. Utilisez cette option pour exclure plusieurs valeurs (lorsque l'expression utilise les caractères génériques ou des opérandes 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 mesure. Pour obtenir des modifications sur les requêtes d'alarme, reportez-vous à la section Creating a Basic Alarm.

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

      Certains espaces de noms de mesure comportent des champs supplémentaires ou d'autres dimensions. Par exemple, le 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 taille : qualificatif 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 en fonction d'une dimension propre à cette 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 une dimension en mettant à jour l'expression MQL, procédez comme suit :
      1. Sélectionnez Mode avancé.
      2. Modifiez le texte dans la zone Editeur de code de requête.

        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. Sélectionnez Mettre à jour le graphique.

  • 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> [...]

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

  • 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.