Documentation Oracle Cloud Infrastructure

Spécification d'un prédicat dans une requête

Indiquez un prédicat pour l'interrogation des données de mesure dans Monitoring.

Les prédicats sont généralement utilisés avec les alarmes mais vous pouvez également les employer dans les requêtes pour les graphiques de mesures personnalisés.

Pour connaître les opérateurs de prédicat valides dans les expressions MQL, reportez-vous à Opérateurs de prédicat.

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

Exemples
Exemple 1 : consommation moyenne de l'UC supérieure à 80 % 
CpuUtilization[1m].mean() > 80
Exemple 2 : utilisation moyenne de l'UC compris entre 60 et 80 % 
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 de l'UC supérieure à 90e centile (prédicat de seuil, sélection d'un domaines de disponibilité et regroupement par pool)
CpuUtilization[1m]{availabilityDomain = "VeBZ:PHX-AD-1"}.groupBy(poolId).percentile(0.9) > 85
Exemple 5 : au moins 20 pour une utilisation minimale de l'UC (sélection de "ol8" ou "ol7")
CpuUtilization[1m]{resourceDisplayName =~ "ol8|ol7"}.min() >= 20
Exemple 6 : au moins 30 pour une utilisation minimale de l'UC (sélection des noms d'instance commençant par "instance-2023-")
CpuUtilization[1m]{resourceDisplayName =~ "instance-2023-*"}.min() >= 30
Exemple 7 : Absence de mesures d'utilisation de l'UC pour la ressource indiquée, définie sur 20 heures pour la période de détection d'absence
CpuUtilization[1m]{resourceId = "<resource_identifier>"}.groupBy(resourceId).absent(20)
Description de absent() : renvoie une valeur True (1) si la mesure est absente dans l'intégralité de l'intervalle. Renvoie False (0) si la mesure est présente au cours de l'intervalle. Est ignoré après la période de détection des absences, sans générer de valeurs.

  • Cette section explique comment indiquer un prédicat dans une requête sur la page Explorateur de mesure. Sur cette page, les prédicats sont disponibles en mode avancé (MQL) uniquement. 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. Sélectionnez Mode avancé.
    4. Modifiez le texte dans la zone Editeur de code de requête.
      Exemple 1 : prédicat de seuil
      > 80 est le prédicat de seuil dans l'expression MQL suivante.
      CpuUtilization[1m].mean() > 80
      Le graphique de l'exemple de requête et de graphique de mesures présente désormais une seule valeur. La valeur de 85 % est résolue sur True (1) pour indiquer qu'elle correspond à l'expression MQL. (Si aucune valeur ne dépasse 80, le graphique de la page Explorateur de mesures affiche "Aucune donnée.")
      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 de l'exemple de requête et de graphique de mesures présente désormais une valeur "1" pour un flux de données de mesure. La valeur "1" dans le graphique indique que l'instance de calcul correspondant à ce flux de données 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 connaître les opérateurs de prédicat valides dans les expressions MQL, reportez-vous à 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 indiquer un prédicat (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 indiquer un prédicat (partie de l'expression MQL). Pour obtenir un exemple, reportez-vous à SummarizeMetricsDataDetails.