Documentation Oracle Cloud Infrastructure

Agrégation des flux de données de mesure dans une requête

L'agrégation des flux de données de mesure renvoie la valeur combinée de tous les flux de données de mesure pour la statistique sélectionnée. Par exemple, vous pouvez agréger tous les flux de données de mesure pour l'utilisation de l'UC afin de renvoyer la valeur combinée de toutes les ressources.

L'option Agréger les flux de données de mesure équivaut à grouping() dans l'expression MQL.

Remarque

Si vous agrégez des flux de données de mesure, un seul flux de données est suivi. Ne regroupez pas les flux de données de mesure avec des notifications de fractionnement.

Par défaut, un graphique représente chaque flux de données de mesure avec une ligne, ce qui se traduit par plusieurs lignes par graphique. Lorsque vous agrégez des flux de données de mesure, un graphique représente tous les flux avec une seule ligne, ce qui se traduit par une seule ligne par graphique.

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

Exemples

Exemple 1 : agrégation des flux de données de mesure pour count()
ServiceConnectorHubErrors[1m].grouping().count()

Dans l'exemple 1, la requête renvoie le nombre d'erreurs (count()) à un intervalle d'une minute, tous les résultats étant agrégés.

Exemple 2 : agrégation des flux de données de mesure pour max()
IopsRead[1m]{compartmentID = "<compartment_OCID>"}.grouping().max()

Dans l'exemple 2, la requête renvoie les données de mesure IopsRead maximales (max()) avec un intervalle d'une minute, filtrées sur un compartiment, avec tous les résultats agrégés.

  • Cette section explique comment agréger les flux de données de mesure sur la page explorateur de mesures. Pour obtenir des 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 cliquant sur Modifier les requêtes.
    3. Pour agréger les flux de données de mesure en mode de base (mode par défaut), sélectionnez Agréger les flux de données de mesure.
    4. Pour agréger les flux de données de mesure en mettant à jour l'expression MQL, procédez comme suit :
      1. Cliquez sur Mode avancé.
      2. Edit the text in the Query code editor box.
    5. Cliquez sur 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 grouping() (partie de l'expression MQL).

    oci monitoring metric-data summarize-metrics-data --query-text <mql_expression> [...]

    Pour 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 grouping() (partie de l'expression MQL).