Documentation Oracle Cloud Infrastructure

Utilisation de groupBy(x) dans une requête

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

Agrégez les résultats de requête par groupe afin de tracer une valeur pour chaque groupe. Cette option renvoie la valeur combinée de tous les flux de données de mesure dans chaque groupe indiqué pour la statistique sélectionnée. La valeur combinée de chaque groupe est représentée par une seule ligne dans le graphique de mesures. Cette option est utile lorsque vous voulez identifier les tendances par groupe plutôt que par ressource individuelle.

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

Exemples

Exemple 1 : regroupement par domaine de pannes
CpuUtilization[1m].groupBy(faultDomain).mean()
Exemple 2 : regroupement par groupe de ressources
CpuUtilization[1m].groupBy(resourceGroup).mean()

  • Cette section explique comment utiliser groupBy(x) sur la page Explorateur de mesures. groupBy(x) est disponible en mode avancé (MQL) uniquement. Pour plus d'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 sélectionnant Modifier les requêtes.
    3. Sélectionnez Mode avancé.
    4. Modifiez le texte dans la zone Editeur de code de requête.

      L'exemple d'expression MQL suivant effectue un regroupement par domaine de pannes :

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

      Le graphique de l'exemple de requête et de graphique de mesures présente désormais trois flux de données de mesure. Chaque flux de données de mesure correspond à un domaine de pannes. Toutes les instances de calcul de ce domaine de pannes sont agrégées.

      Flux de données de mesure agrégés par domaine de pannes.

    5. Sélectionnez 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 employer l'élément groupBy(x) (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 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 employer l'élément groupBy(x) (partie de l'expression MQL).