Documentation Oracle Cloud Infrastructure

Créer une requête

Définissez une requête pour extraire les données de Monitoring.

Pour obtenir un exemple de requête, reportez-vous à Exemple de requête et de graphique de mesures.

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

  • Remarque

    Pour commencer avec une requête de service prédéfinie, reportez-vous à Exploration d'un graphique de mesures par défaut.

    Ces étapes indiquent comment créer une requête sur la page Explorateur de mesures, en mode de base. Pour créer une requête en mode avancé (MQL), reportez-vous à Modification de l'expression MQL pour une requête.

    1. Ouvrez le menu de navigation et sélectionnez Observation et gestion. Sous Surveillance, sélectionnez Explorateur de mesures.
      La page Explorateur de mesures affiche un graphique vide avec des champs permettant de créer une requête.
    2. Dans la barre de navigation, sélectionnez la région qui contient les données de mesure de votre choix.
      Pour plus d'informations sur les régions, reportez-vous à Présentation des régions et à Travail sur plusieurs régions.
    3. Dans la requête située sous le graphique, sélectionnez le compartiment qui contient la mesure de votre choix,
    4. Sélectionnez l'espace de noms qui contient la mesure souhaitée.
      Remarque

      La liste Espace de noms de mesure affiche les espaces de noms de mesure pour le compartiment sélectionné. Par exemple, si le compartiment en cours contient des équilibreurs de charge, la liste inclut oci_lbaas.
    5. Sélectionnez le nom de la mesure.
    6. Mettez à jour l'intervalle ou la statistique, si nécessaire.
    7. (Facultatif) Pour sélectionner des dimensions, indiquez des valeurs pour les champs suivants :
      • Nom de la taille : qualificatif indiqué dans la définition de mesure. Par exemple, la dimension resourceId est spécifiée dans la définition de mesure pour CpuUtilization.
      • Valeur de dimension : valeur à utiliser pour la dimension spécifiée, par exemple l'identificateur de ressource d'une instance.
      • Dimension supplémentaire : ajoute une autre paire nom-valeur pour une dimension.
    8. (Facultatif) Pour agréger les flux de données de mesure, sélectionnez Agréger les flux de données de mesure.
    9. Sélectionnez Mettre à jour le graphique.
      Le graphique affiche les points de données pour la mesure personnalisée dans une vue graphique. Exemple :Flux de données de mesure et valeurs dans un graphique.
    10. (Facultatif) Pour basculer vers une vue de tableau, sélectionnez Afficher la table de données.
      Le graphique affiche les points de données pour la mesure personnalisée dans une vue tabulaire.

    Pour plus d'informations sur la modification directe d'expressions MQL ou la modification de requêtes à l'aide de l'interface de ligne de commande ou l'API, reportez-vous à Modification de l'expression MQL pour une requête.

  • Utilisez la commande oci monitoring metric-data summarize-metrics-data et les paramètres requis pour interroger les données de mesure :

    oci monitoring metric-data summarize-metrics-data [OPTIONS]

    Lorsque vous indiquez une valeur de dimension dans la requête (--query-text), placez-la entre guillemets et faites échapper chaque guillemet avec une barre oblique inverse (\). Exemple :

    oci monitoring metric-data summarize-metrics-data --compartment-id <compartment_OCID> --namespace oci_computeagent --query-text "CpuUtilization[1m]{resourceId = \"<instance_OCID>\"}.max()"

    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.