Documentation sur Oracle Cloud Infrastructure

Utilisation de groupBy(x) dans une interrogation

Utilisez l'élément groupBy(x) facultatif lors de l'interrogation des données de mesure dans le service Surveillance.

Regroupez les résultats d'interrogation par groupe pour tracer une valeur pour chaque groupe. Cette option retourne la valeur combinée de tous les flux de mesure dans chaque groupe spécifié pour la statistique sélectionnée. La valeur combinée de chaque groupe est tracée par une seule ligne sur le graphique de mesure. Cette option peut être utile pour identifier les tendances par groupe plutôt que par ressource individuelle.

Pour le dépannage des interrogations, voir Résolution des interrogations.

Exemples

Exemple 1 : Regrouper par domaine d'erreur
CpuUtilization[1m].groupBy(faultDomain).mean()
Exemple 2 : Regrouper par groupe de ressources
CpuUtilization[1m].groupBy(resourceGroup).mean()

  • Cette section décrit comment utiliser groupBy(x) dans la page explorateur de mesures. groupBy(x) n'est disponible qu'en mode avancé (MQL). Pour les modifications d'interrogation d'alarme, voir Création d'une alerte de base.

    1. Create a basic query (Créer une interrogation de base) dans la page Mesures Explorer.
    2. Si l'interrogation n'est pas ouverte, ouvrez-la en sélectionnant Modifier les interrogations.
    3. Sélectionnez Mode avancé.
    4. Modifiez le texte dans la zone Éditeur de code d'interrogation.

      L'exemple d'expression MQL suivant regroupe les expressions par domaine d'erreur :

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

      Le graphique dans Exemple d'interrogation et de graphique de mesure affiche maintenant trois flux de mesure. Chaque flux de mesure correspond à un domaine d'erreur, agrégeant toutes les instances de calcul dans ce domaine d'erreur.

      Flux de mesure agrégés par 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. Servez-vous du paramètre --query-text pour utiliser l'élément groupBy(x) (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 des valeurs pour les commandes de l'interface de ligne de commande, voir Informations de référence sur la ligne de commande pour le service de surveillance.

  • Exécutez l'opération SummarizeMetricsData pour interroger les données de mesure. Servez-vous de l'attribut query pour utiliser l'élément groupBy(x) (partie de l'expression MQL).