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 d'indicateur renvoie la valeur combinée de tous les flux de données d'indicateur 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 des flux de donnée de mesure équivaut à grouping() dans l'expression MQL.

Remarque

Si vous agréez des flux de données de mesure, un seul flux est suivi. N'agrégez pas les flux de données de mesure avec des notifications fractionnées.

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 (count()) d'erreurs à un intervalle d'une minute, avec tous les résultats 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 la donnée de mesure IopsRead maximale (max()) à 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 d'indicateur sur la page explorateur de mesures. 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. Pour agréger les flux de donnée de mesure en mode de base (mode par défaut), sélectionnez Agréger le flux de donnée de mesure.
    4. Pour agréger les flux de données d'une mesure en mettant à jour l'expression MQL, procédez comme suit :
      1. Sélectionnez Mode avancé.
      2. Modifiez le texte dans la zone Editeur de code de requête.
    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 grouping() (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 grouping() (partie de l'expression MQL).