Documentation sur Oracle Cloud Infrastructure

Sélection de dimensions pour une interrogation

Limitez les données de mesure retournées en sélectionnant des dimensions lors de l'interrogation des données de mesure dans le service de surveillance. Une dimension est un qualificatif fourni dans une définition de mesure. Dans MQL, le composant de sélection de dimension spécifie des paires nom-valeur pour les dimensions, placées entre accolades.

Pour le dépannage des interrogations, voir Dépannage des interrogations.

Exemples
Note

Les guillemets autour de la valeur (par exemple, "FAULT-DOMAIN-1") peuvent être omis sauf si la valeur contient des espaces ou est utilisée dans une mise en correspondance floue.
Exemple 1 : Domaine d'erreur
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 d'erreur, Nom et Forme
CpuUtilization [1m]{faultDomain = "FAULT-DOMAIN-1", resourceDisplayName = "test", shape = "myshape"}.mean()
Les dimensions de cette interrogation sont traitées avec un opérateur AND. Les données résultantes incluent uniquement les flux de mesure qui correspondent à toutes les dimensions.
Exemple 5 : Valeurs multiples pour une dimension : Domaine d'erreur 1 ou 2
CpuUtilization [1m]{faultDomain =~ "FAULT-DOMAIN-1|FAULT-DOMAIN-2"}.mean()
Les valeurs de dimension de cette interrogation sont traitées avec un opérateur OR, à l'aide de la mise en correspondance floue. (La mise en correspondance floue n'est disponible que dans les expressions MQL. Dans la console, utilisez le mode avancé.) Les données résultantes incluent des flux de mesure qui correspondent à l'une ou l'autre des valeurs.
Mise en correspondance floue

Spécifiez les correspondances approximatives ("floues") avec les valeurs de dimension dans une expression MQL.

Note

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

Au lieu du signe égal (=) entre le nom de dimension et le jeu de valeurs, utilisez l'opérateur de comparaison suivant.

Opérateur de comparaison Description
=~ (signe égal suivi d'un tilde) Approximativement égal à. Utiliser pour les correspondances nulles

Pour une mise en correspondance floue, encadrez le jeu de valeurs par des citations : name = "val*" ou name = "value1|value2"

Mettez à jour le jeu de valeurs à l'aide d'au moins un des caractères suivants.

Caractère de correspondance floue pour les valeurs 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 d'affichage d'une mise en correspondance floue pour trois jeux de valeurs de dimension (test des instances de calcul dans le domaine d'erreur 1 qui utilisent la forme myshape) :

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

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

Note

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

Au lieu du signe égal (=) entre le nom de dimension et le jeu de valeurs, 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 de filtrer une valeur de dimension unique.
!~ (point d'exclamation suivi du tilde) Différent de. Permet de filtrer 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 le jeu de valeurs de dimension à l'aide d'un ou de plusieurs des caractères suivants.

Caractère de correspondance floue pour les valeurs 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) : Interrogation de base pour l'utilisation d'UC, à l'exclusion du domaine d'erreur 1.

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

Exemple 2 (valeurs multiples) : Interrogation de base pour l'utilisation d'UC, à l'exclusion des domaines d'erreur 1 et 2.

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

  • Cette section décrit comment sélectionner des dimensions dans la page explorateur de mesures. Pour les modifications d'interrogation d'alarme, voir Création d'une alerte de base.

    1. Créer une interrogation de base dans la page explorateur de mesures.
    2. Si l'interrogation n'est pas ouverte, ouvrez-la en sélectionnant Modifier les interrogations.
    3. Pour sélectionner des dimensions à l'aide du mode de base (par défaut), fournissez des valeurs pour les champs suivants :
      Note

      Des champs de dimension supplémentaires ou autres s'affichent pour certains espaces de noms de mesure. Par exemple, un champ de type de déploiement s'affiche pour l'espace de noms de mesure oci_autonomous_database. Pour plus de détails, consultez la documentation propre au service.
      • Nom de la dimension : Qualificatif spécifié dans la définition de la mesure. Par exemple, la dimension resourceId est indiquée dans la définition de la 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 à la ressource, par exemple resourceDisplayName .

        Note

        Les longues listes de dimensions sont rognées.

        • Pour voir les dimensions par nom, entrez au moins un caractère dans la zone. Une liste actualisée (rognée) affiche les noms des dimensions correspondantes.
        • Pour extraire toutes les dimensions pour une mesure, voir 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 valeur-nom pour une dimension.
    4. Pour sélectionner des dimensions en mettant à jour l'expression MQL, procédez de la façon suivante :
      1. Sélectionnez Mode avancé.
      2. Modifiez le texte dans l'éditeur de code d'interrogation.

        Exemple de dimension dans une expression MQL :

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

        Dans cet exemple, les limites d'interrogation ont retourné des données au domaine d'erreur 1. Le graphique Exemple d'interrogation et de graphique de mesure affiche maintenant quatre flux de mesure. Chaque flux de mesure correspond à une instance du domaine d'erreur 1.Flux de mesure filtrés selon un seul domaine d'erreur.

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

    Pour la liste complète des paramètres et valeurs des commandes de l'interface de ligne de commande, voir Référence de ligne de commande pour le service de surveillance.

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