Documentation sur Oracle Cloud Infrastructure

Sélection d'une résolution autre que par défaut pour une interrogation

Spécifiez une valeur de résolution autre que par défaut pour l'interrogation des données de mesure dans le service Surveillance.

Note

Ces instructions s'appliquent uniquement aux interrogations de mesure (SummarizeMetricsData). La résolution ne peut pas être sélectionnée pour les interrogations d'alarme (CreateAlarm). La seule valeur valide de la résolution d'une demande d'interrogation d'alarme est 1m.
Illustration

Comme illustré ci-dessous, la résolution contrôle l'heure de début de chaque fenêtre d'agrégation relative à la fenêtre précédente alors que l'intervalle contrôle la longueur des fenêtres. Les deux demandes appliquent la statistique max aux données dans chaque fenêtre de 5 minutes (intervalle), ce qui entraîne un seul point de données agrégé représentant le compteur CPUutilization le plus élevé pour cette fenêtre. Seule la valeur de la résolution diffère. Cette résolution modifie la régularité à laquelle les fenêtres d'agrégation changent ou les heures de début des fenêtres d'agrégation successives. La demande A ne spécifie pas de résolution et utilise donc la valeur par défaut égale à l'intervalle (5 minutes). Les fenêtres d'agrégation de 5 minutes de cette demande sont ainsi extraites des jeux de points de données émis entre 0:n et 5:00, 5:n et 10:00, etc. La demande B spécifie une résolution de 1 minute. Par conséquent, ses fenêtres d'agrégation de cinq minutes sont extraites du jeu de points de données émis toutes les minutes entre 0: n et 5:00, 1: n et 6:00, etc.

Cette image montre comment les fenêtres d'agrégation commencent en fonction de la résolution.

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

Points à considérer

Pour les interrogations de mesure, l'intervalle  sélectionné détermine la résolution  par défaut de la demande, qui détermine l'intervalle de temps maximal des données retournées.

Intervalle de temps maximum retourné pour une interrogation

L'intervalle de temps maximum retourné pour une interrogation de mesure dépend de la résolution. Par défaut, pour des interrogations de mesure, la résolution est identique à l'intervalle d'interrogation.

L'intervalle de temps maximum est calculé à l'aide de l'heure courante, peu importe l'heure de fin spécifiée. Ci-dessous se trouvent les intervalles de temps maximum retournés pour chaque sélection d'intervalle disponible dans la console (mode de base).

Intervalle Résolution par défaut (interrogations de mesure) Intervalle de temps maximum retourné

1 minute

Auto (page Mesures de service)*, lorsque la période sélectionnée est inférieure ou égale à 6 heures

 1 minute 7 jours

5 minutes

Auto (page Mesures de service)*, lorsque la période sélectionnée est supérieure à 6 heures et inférieure à 36 heures

 5 minutes 30 jours

1 heure

Auto (page Mesures de service)*, lorsque la période sélectionnée est supérieure à 36 heures

 1 heure 90 jours

1 jour

 1 jour 90 jours

* L'intervalle de temps maximal retourné lorsque l'option Auto est sélectionnée pour Intervalle (page Mesures de serviceseulement) est déterminé par la sélection automatique d'intervalle. La sélection automatique de l'intervalle est basée sur la période sélectionnée.

Pour spécifier une résolution non par défaut qui diffère de l'intervalle, voir Sélection d'une résolution non par défaut pour une interrogation.

Exemple 1 pour les données retournées
Intervalle d'une minute et résolution jusqu'à l'heure courante, envoi à 10:00 le 8 janvier. Ni la résolution ni l'heure de fin n'étant indiquée, la résolution utilisée par défaut est la valeur d'intervalle 1m et l'heure de fin par défaut est l'heure courante (2023-01-08T10:00:00.789Z). Cette demande retourne des points de données de mesure pour un maximum de 7 jours. Le premier point de données possible dans cette période de sept jours est 10:00 le 1er janvier (2023-01-01T10:00:00.789Z).
Exemple 2 pour les données retournées
Intervalle de cinq minutes avec une résolution d'une minute il y a jusqu'à deux jours, envoyé à 10h00 le 8 janvier. Puisque la résolution entraîne l'intervalle de temps maximum, des points de données de mesure pour un maximum de 7 jours sont retournés. Bien que l'heure de fin précisée soit 10:00 le 6 janvier (2023-01-06T10:00:00.789Z), le premier point de données possible dans cette période de sept jours est 10:00 le 1er janvier (2023-01-01T10:00:00.789Z). Par conséquent, des points de données de mesure pour seulement 5 jours peuvent être retournés dans cet exemple.
  • Cette tâche ne peut pas être effectuée à l'aide de la console.

  • 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 --resolution pour sélectionner une résolution autre que celle-ci.

    oci monitoring metric-data summarize-metrics-data --resolution <resolution> [...]

    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. Utilisez l'attribut resolution pour sélectionner une résolution non par défaut pour l'interrogation.