Documentation sur Oracle Cloud Infrastructure

Agrégation des flux de mesure dans une interrogation

L'agrégation des flux de mesure retourne la valeur combinée de tous les flux de mesure pour la statistique sélectionnée. Par exemple, agrégez tous les flux de mesure pour Utilisation d'UC afin de retourner la valeur combinée dans toutes les ressources.

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

Note

Si vous agrégez des flux de mesure, un seul flux est suivi. Ne pas agréger les flux de mesure avec des avis fractionnés.

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

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

Exemples

Exemple 1 : Agréger les flux de mesure pour count()
ServiceConnectorHubErrors[1m].grouping().count()

Dans l'exemple 1, l'interrogation retourne le nombre d'erreurs (count()) à un intervalle d'une minute, avec tous les résultats agrégés.

Exemple 2 : Agréger les flux de mesure pour max()
IopsRead[1m]{compartmentID = "<compartment_OCID>"}.grouping().max()

Dans l'exemple 2, l'interrogation retourne les données de mesure IopsRead maximales (max()) à un intervalle d'une minute, filtrées selon un compartiment, avec tous les résultats agrégés.

  • Cette section décrit comment agréger les flux de mesure 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 agréger les flux de mesure à l'aide du mode de base (par défaut), sélectionnez Agréger les flux de mesure.
    4. Pour agréger les flux de mesure 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.
    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 grouping() (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. Servez-vous de l'attribut query pour utiliser l'élément grouping() (partie de l'expression MQL).