Documentation sur Oracle Cloud Infrastructure

Spécification d'un prédicat dans une interrogation

Spécifiez un prédicat pour l'interrogation des données de mesure dans le service de surveillance.

Bien qu'ils soient généralement utilisés avec des alarmes, vous pouvez également utiliser les prédicats dans des interrogations pour des graphiques de mesure personnalisés.

Pour les opérateurs de prédicat valides dans les expressions MQL, voir Opérateurs de prédicat.

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

Exemples
Exemple 1 : Supérieur à 80 % pour l'utilisation moyenne d'UC 
CpuUtilization[1m].mean() > 80
Exemple 2 : Entre 60 et 80 % pour l'utilisation moyenne d'UC 
CpuUtilization[1m].mean() in (60, 80)
Exemple 3 : Supérieur à 1 pour les erreurs
ServiceConnectorHubErrors[1m].count() > 1
Exemple 4 : Supérieur à 85 pour l'utilisation d'UC du 90e centile (Sélection d'un domaine de disponibilité et regroupement par groupe)
CpuUtilization[1m]{availabilityDomain = "VeBZ:PHX-AD-1"}.groupBy(poolId).percentile(0.9) > 85
Exemple 5 : Au moins 20 pour l'utilisation minimale d'UC (Sélectionnant "ol8" ou "ol7")
CpuUtilization[1m]{resourceDisplayName =~ "ol8|ol7"}.min() >= 20
Exemple 6 : Au moins 30 pour l'utilisation minimale d'UC (sélection des noms d'instance commençant par "instance-2023-")
CpuUtilization[1m]{resourceDisplayName =~ "instance-2023-*"}.min() >= 30
Exemple 7 : Absence des mesures d'utilisation d'UC pour la ressource spécifiée, réglée à 20 heures pour la période de détection des absences
CpuUtilization[1m]{resourceId = "<resource_identifier>"}.groupBy(resourceId).absent(20)
Description pour absent() : Retourne Vrai (1) si la mesure est absente pendant tout l'intervalle. Retourne Faux (0) si la mesure est présente pendant l'intervalle. Est ignoré après la période de détection d'absence, sans générer de valeur.

  • Cette section décrit comment spécifier un prédicat dans une interrogation dans la page explorateur de mesures. Dans cette page, les prédicats ne sont disponibles qu'en mode avancé (MQL). 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. Sélectionnez Mode avancé.
    4. Modifiez le texte dans l'éditeur de code d'interrogation.
      Exemple 1 : Prédicat de seuil
      > 80 est le prédicat de seuil dans l'expression MQL suivante.
      CpuUtilization[1m].mean() > 80
      Le graphique dans Exemple d'interrogation et de graphique de mesure affiche maintenant une seule valeur. La valeur de 85 % retourne Vrai (1) pour indiquer qu'elle satisfait à l'expression MQL. (Si aucune valeur n'est supérieure à 80, aucune donnée n'apparaît dans le graphique de la page Explorateur de mesures.)
      Seuil dans un graphique, page Explorateur de mesures.
      Exemple 2 : Prédicat d'absence
      absent() est le prédicat d'absence dans l'expression MQL suivante.
      CpuUtilization[1m].absent()
      Le graphique dans Exemple d'interrogation et de graphique de mesure affiche maintenant une valeur "1" pour un flux de mesure. La valeur "1" dans le graphique indique que l'instance de calcul correspondant à ce flux de mesure n'a pas émis de données de mesure CpuUtilization avant 1:30.
      Données de mesure absentes dans un graphique, page Explorateur de mesures.

      Pour les opérateurs de prédicat valides dans les expressions MQL, voir Opérateurs de prédicat.

    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 spécifier un prédicat (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. Utilisez l'attribut query pour spécifier un prédicat (partie de l'expression MQL). Pour un exemple, voir SummarizeMetricsDataDetails.