Documentation Oracle Cloud Infrastructure

Utilisation de groupBy(x) dans une requête

Utilisez l'élément facultatif groupBy(x) lors de l'affichage des données d'indicateur 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 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. 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 à 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 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 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 employer l'élément groupBy(x) (partie de l'expression MQL).