Création d'une interrogation pour une mesure personnalisée

Définissez une interrogation pour une mesure personnalisée dans le service de surveillance.

Pour plus d'informations sur les mesures personnalisées, voir Production de mesures personnalisées à l'aide de l'API. Pour le dépannage des interrogations, voir Résolution des interrogations.

Ces étapes montrent comment créer une interrogation en mode de base dans la page Explorateur de mesures. Pour créer une interrogation en mode avancé (MQL), voir Modification de l'expression MQL pour une interrogation.
1. Create a basic query (Créer une interrogation de base) dans la page Mesures Explorer.
2. Dans la barre de navigation, sélectionnez la région contenant les données de mesure que vous souhaitez.
  Pour plus d'informations sur les régions, voir Comprendre les régions et Utilisation de plusieurs régions.
3. Dans l'interrogation sous le graphique, sélectionnez le compartiment qui contient la mesure personnalisée souhaitée.
4. Sélectionnez l'espace de noms de mesure contenant la mesure personnalisée qui vous intéresse.
  Exemple : mymetricsnamespace
5. (Facultatif) Sélectionnez le groupe de ressources qui vous intéresse.
  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 Intervalle, puis sélectionnez Somme pour Statistique.
8. Pour voir et mettre à jour l'expression MQL, sélectionnez Mode avancé.
  L'expression MQL se trouve dans la zone Éditeur de code d'interrogation. Exemple :
  productOrder[1m].sum()
9. Sélectionnez Mettre à jour le graphique.
  Le graphique présente les points de données pour la mesure personnalisée, dans une vue de graphique. Exemple :
10. (Facultatif) Pour passer à une vue de table, sélectionnez Afficher la table de données.
  Le graphique présente les points de données pour la mesure personnalisée, dans une vue de table.

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 des informations de mesure personnalisées à partir d'un fichier JSON.

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

Pour la liste complète des paramètres et des valeurs pour les commandes de l'interface de ligne de commande, voir Informations de référence sur la ligne de commande pour le service de surveillance.

Exemple de fichier JSON pour une demande

Comparez ce fichier à l'exemple de données de mesure publiées sous 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

Cet exemple de réponse 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 entraîne trois horodatages.

Comparez cette réponse à l'exemple de données de mesure publiées sous 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 les données de mesure.

Documentation sur Oracle Cloud Infrastructure

Création d'une interrogation pour une mesure personnalisée