Création d'une requête pour une mesure personnalisée

• Console
• Interface de ligne de commande
• API

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

  1. Créez une requête de base sur la page explorateur de mesures.
  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 personnalisée de votre choix.
  4. Sélectionnez l'espace de noms de mesure qui contient la mesure personnalisée de votre choix.
     Exemple : mymetricsnamespace
  5. (Facultatif) Sélectionnez le groupe de ressources de votre choix.
     Exemple : divisionX
  6. Sélectionnez le nom de la mesure personnalisée.
     Exemple : productOrder
  7. (Facultatif) Mettez à jour l'intervalle ou la statistique.
     Exemple : sélectionnez 1 minute pour l'intervalle et sélectionnez Sum pour la statistique.
  8. Pour afficher et mettre à jour l'expression MQL, cliquez sur Mode avancé.

     L'expression MQL se trouve dans la zone Editeur de code de requête. Exemple :

     productOrder[1m].sum()
  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 :
  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.

• 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 --compartment-id <compartment_OCID> --namespace <metric_namespace> --query-text <mql_expression>

  L'exemple suivant utilise le paramètre --from-json pour extraire les informations de mesure personnalisée à partir d'un fichier JSON.

  oci monitoring metric-data summarize-metrics-data --from-json file://./get-metrics.json [...]

  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.

  Exemple de fichier JSON pour une demande

  Comparez le fichier suivant à l'exemple de données de mesure publiée dans Publication de mesures personnalisées à l'aide de l'API.

  {
    "compartmentId": "$compartmentId",
    "endTime": "2023-01-08T20:00:00+00:00",
    "namespace": "mymetricsnamespace",
    "queryText": "productOrder[1m].sum()",
    "resolution": "5m",
    "resourceGroup": "divisionX",
    "startTime": "2023-01-07T23:00:00+00:00"
  }

  Exemple de réponse

  L'exemple de réponse suivant inclut des points de données pour la division de groupe de ressources X uniquement (produit ball, pays NL). L'agrégation utilise un intervalle d'une minute, ce qui donne trois horodatages.

  Comparez la réponse suivante à l'exemple de données de mesure publiée dans Publication de mesures personnalisées à l'aide de l'API.

  {
    "data": [
      {
        "aggregated-datapoints": [
          {
            "timestamp": "2023-01-08T09:20:00+00:00",
            "value": 100.0
          },
          {
            "timestamp": "2023-01-08T10:15:00+00:00",
            "value": 110.0
          },
          {
            "timestamp": "2023-01-08T10:25:00+00:00",
            "value": 30.0
          },
        "compartmentId": "$compartmentId",
        "dimensions": {
          "country": "NL",
          "product": "ball"
        },
        "metadata": {
          "category": "toys",
          "note": "national holiday"
        },
        "name": "productOrder",
        "namespace": "mymetricsnamespace",
        "resourceGroup": "divisionX"
      }
    ]
  }

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