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.

  • Les étapes suivantes expliquent 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 cliquez sur Observation & gestion. Sous Surveillance, cliquez sur Explorateur de mesures.
      La page explorateur de mesures affiche un graphique vide avec des champs permettant de créer une requête.
    2. Dans l'en-tête de la console, 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 sous le graphique, sélectionnez le compartiment qui contient la mesure de votre choix.
    4. Sélectionnez l'espace de noms de mesure qui contient la mesure voulue.
      Remarque

      La liste Espace de noms de mesure affiche les espaces de noms de mesure du 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 selon vos besoins.
    7. (Facultatif) Pour sélectionner des dimensions, indiquez des valeurs pour les champs suivants :
      • Nom de la dimension : attribut 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. Cliquez sur Mettre le graphique à jour.
      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 sur une vue tabulaire, cliquez sur Afficher la table des données.
      Le graphique affiche les points de données pour la mesure personnalisée dans une vue tabulaire.

    Afin d'obtenir des informations sur la Modification directe d'expressions MQL ou la Modification de requêtes à l'aide de l'interface de ligne de commande ou de 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), entourez-la de guillemets et faites passer chaque guillemet double d'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()"

    Pour obtenir la liste complète des paramètres et des valeurs des commandes d'interface de ligne de commande, reportez-vous à Référence de ligne de commande pour Monitoring.

  • Exécutez l'opération SummarizeMetricsData pour interroger des données de mesure.