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

Définissez une requête pour une mesure personnalisée dans Monitoring.

Pour plus d'informations sur les mesures personnalisées, reportez-vous à Publication de mesures personnalisées à l'aide de l'API. Pour le dépannage des requêtes, reportez-vous à Dépannage des requêtes.

Ces étapes indiquent 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 élémentaire sur la page Explorateur des mesures.
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 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 contenant la mesure personnalisée souhaitée.
  Exemple : mymetricsnamespace
5. (Facultatif) Sélectionnez le groupe de ressource de votre choix.
  Exemple : divisionX
6. Sélectionnez le nom de la mesure personnalisée.
  Exemple : productOrder
7. (Facultatif) Mettez à jour l'intervalle ou les statistiques.
  Exemple : sélectionnez 1 minute pour Intervalle, puis Somme pour Statistique.
8. Pour afficher et mettre à jour l'expression MQL, sélectionnez Mode avancé.
  L'expression MQL se trouve dans la zone Editeur de code de requête. Exemple :
  productOrder[1m].sum()
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 :
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.

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 [...]

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.

Exemple de fichier JSON pour une demande

Comparez ce fichier suivant à l'exemple de données d'indicateur publié 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 cette réponse à l'exemple de données d'indicateur publié 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.

Documentation Oracle Cloud Infrastructure

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