Vous pouvez créer un widget basé sur des requêtes à l'aide des mesures du service Oracle Cloud Infrastructure Monitoring.

1. Accédez à la page Tableaux de bord.
2. Cliquez sur Créer un tableau de bord pour créer un tableau de bord ou ouvrir un tableau de bord existant en mode modification.
3. Ajoutez éventuellement le filtre de dimension de mesure au tableau de bord.

   Vous pouvez utiliser le filtre Dimension de mesure pour indiquer l'entrée de dimension de mesure pour un widget basé sur une requête. Pour plus d'informations, reportez-vous à Utilisation du filtre Dimension de mesure.

4. Dans l'onglet Widgets, cliquez sur l'icône Ajouter un groupe de widgets et des widgets (), puis sur Créer un widget basé sur une requête....
   Le générateur de widget basé sur une requête s'affiche.
5. Vous pouvez également cliquer sur l'icône Ouvrir/fermer le panneau de filtre () pour afficher les filtres ajoutés au tableau de bord et apporter des modifications, si nécessaire.

   Lors de la création d'un widget basé sur une requête pour l'ajouter à un nouveau tableau de bord, un filtre Compartiment est automatiquement ajouté et l'entrée de compartiment pour le nouveau widget en cours de création est liée à ce filtre nouvellement ajouté. En outre, la case Sous-compartiments est affichée dans le filtre Compartiment et vous pouvez la sélectionner pour afficher les données de mesure de tous les sous-compartiments du compartiment racine. L'option permettant de visualiser les données de mesure à partir des sous-compartiments peut uniquement être utilisée si le compartiment racine est sélectionné dans le filtre Compartiment.

6. Dans l'angle supérieur droit, sélectionnez la période pour laquelle vous souhaitez afficher les données dans le widget.
7. Sélectionnez Surveillance dans le champ Source de données.
8. Indiquez les détails de mesure de service Monitoring suivants :
   1. Espace de noms : sélectionnez l'espace de noms applicable.
   2. Groupe de ressources : vous pouvez éventuellement sélectionner un groupe de ressources, le cas échéant. Un groupe de ressources est une chaîne personnalisée fournie avec une mesure personnalisée qui peut être utilisée comme filtre ou pour l'agrégation des résultats.
   3. Requête : modifiez la requête par défaut affichée dans ce champ ou entrez une nouvelle requête pour extraire les informations de mesure à afficher dans le widget.

      Les requêtes utilisées pour créer des widgets basés sur des requêtes utilisent la syntaxe MQL (METRIC[auto].grouping().mean()), qui régit les expressions permettant d'interroger les mesures publiées vers le service Monitoring. Pour plus d'informations, reportez-vous à Référence de Monitoring Query Language (MQL).

   4. Cliquez sur Exécuter.

   La requête est exécutée et les données de mesure sont affichées sous forme de tableau avec le nom de la mesure, l'horodatage et la valeur. Sous le graphique de tableau, une autre table contenant les données brutes renvoyées par la requête s'affiche et vous pouvez cliquer sur Masquer les données brutes pour les masquer.

9. Vous pouvez éventuellement ajouter des paramètres d'entrée pour rendre le widget réutilisable en indiquant différentes valeurs de ce paramètre. Par exemple, les paramètres d'entrée peuvent être configurés pour filtrer les données en fonction d'une dimension spécifique, où la valeur est fournie via le paramètre. Si vous créez un widget basé sur une requête pour le service Database Management (espace de noms oracle_oci_database) afin de visualiser l'utilisation de l'UC (mesure CpuUtilization), vous pouvez ajouter un paramètre d'entrée à l'aide de la dimension resourceName et configurer des valeurs de dimension afin de visualiser les données d'utilisation de l'UC pour des ressources spécifiques du widget.
   1. Dans l'onglet Paramètres, cliquez sur Ajouter une entrée +.
   2. Dans la boîte de dialogue Configurer l'entrée pour le widget sans titre (facultatif), procédez comme suit :
      1. Nom d'entrée : entrez le nom du paramètre d'entrée. Par exemple, si vous voulez ajouter la dimension resourceName en tant que paramètre d'entrée pour le widget, le nom d'entrée peut être resourcename. Notez que le nom d'entrée est requis lors de l'ajout d'une expression de réserve à la requête.
      2. Libellé d'entrée : entrez le nom d'affichage de l'entrée. Le nom d'entrée est affiché dans ce champ par défaut et vous pouvez le modifier pour le rendre plus convivial.
      3. Paramètres par défaut : si nécessaire, vérifiez et modifiez les paramètres par défaut.
         Remarque
         
         Si vous mettez à jour les paramètres par défaut pour configurer le paramètre d'entrée, les mêmes paramètres seront appliqués chaque fois que ce widget sera ajouté à un autre tableau de bord. Pour configurer un paramètre d'entrée dont la valeur peut être modifiée après la création et l'ajout du widget à la bibliothèque de widgets, utilisez les options de la section Configurer l'entrée du widget de cette boîte de dialogue.
         • Obligatoire : sélectionnez cette option pour indiquer qu'il s'agit d'une entrée de widget obligatoire. Si vous cochez cette case et que vous ne configurez pas le paramètre d'entrée, les données ne seront pas affichées dans le widget.
         • Autoriser plusieurs valeurs : sélectionnez cette option pour autoriser la configuration de plusieurs valeurs pour le paramètre d'entrée.
         • Autoriser les utilisateurs de widget à lier l'entrée <name> à un filtre : désélectionnez cette case pour indiquer uniquement une valeur de paramètre d'entrée fixe. Cette case est cochée par défaut et si vous la désélectionnez, les champs disponibles pour lier l'entrée à un filtre ne s'affichent pas dans la boîte de dialogue.
         • Autoriser les utilisateurs de widget à spécifier l'entrée <name> : désélectionnez cette case pour lier uniquement l'entrée à un filtre. Cette case est cochée par défaut et si vous la désélectionnez, les champs disponibles pour spécifier une valeur de paramètre d'entrée fixe ne s'affichent pas dans la boîte de dialogue.
      4. Configurer l'entrée de widget : sélectionnez l'une des options suivantes pour configurer le paramètre d'entrée :
         • Lier l'entrée à un filtre existant : sélectionnez cette option pour lier le paramètre d'entrée à un filtre existant dans le widget.
         • Indiquer l'entrée : sélectionnez cette option pour indiquer une valeur de paramètre d'entrée fixe, qui sera utilisée uniquement dans le contexte de ce widget.
         • Non configuré : sélectionnez cette option pour ne pas configurer l'entrée.
   3. Ajoutez un espace réservé à la requête pour afficher les données du paramètre d'entrée supplémentaire dans le widget, à l'aide de l'expression suivante :

      {<dimension>=$(params.<input_name>)}

      Prenant le même exemple mentionné au début de l'étape 8, après l'ajout d'un paramètre d'entrée pour la dimension resourceName, l'expression d'espace réservé suivante (en gras) doit être ajoutée à la requête CpuUtilization pour filtrer les données par ressource dans le widget :

      CpuUtilization[auto]{resourceName=$(params.resourcename)}.mean()

10. Utilisez les onglets suivants à droite pour effectuer des tâches telles que l'ajout d'un nom pour le widget et la personnalisation de la visualisation des données dans le widget :
    Remarque
    
    Vous pouvez cliquer sur JSON dans l'angle supérieur droit pour modifier directement les métadonnées JSON du widget. L'éditeur JSON vous offre une plus grande flexibilité et davantage d'options pour visualiser les données dans le widget. Cependant, il est recommandé de ne l'utiliser que si vous êtes familiarisé avec la modification du widget JSON. Pour plus d'informations sur l'éditeur JSON, contactez le support technique Oracle.

    • A propos de : entrez le nom du widget, sélectionnez le compartiment dans lequel le widget doit résider et ajoutez une description pour le widget.

      Vous pouvez également cliquer sur Afficher les options avancées pour ajouter des balises définies ou de format libre au widget. Si vous disposez des droits d'accès requis pour créer un widget, vous pouvez également ajouter des balises à format libre. Pour ajouter une balise définie, vous devez disposer des droits d'accès permettant d'utiliser l'espace de noms de balise. Pour plus d'informations sur :

      • Concepts de balisage et droits d'accès requis pour utiliser les balises. Reportez-vous à Présentation de Tagging.
      • Comment ajouter une balise lors de la création d'une ressource, reportez-vous à Procédure d'ajout d'une balise lors de la création d'une ressource.
    • Visualisation : sélectionnez un type de graphique et personnalisez la visualisation en indiquant ou en modifiant des options supplémentaires.

      Si vous sélectionnez Table comme type de graphique, vous avez la possibilité de supprimer certaines colonnes ou de cocher la case Toutes les colonnes pour afficher toutes les colonnes. Les types de graphique qui ont des axes X et Y, tels que le graphique Ligne, combinent les options de visualisation supplémentaires suivantes :

      • Axe X : sélectionnez l'attribut de données à projeter sur l'axe X. Sur l'axe des X, vous pouvez choisir d'afficher le nom de la mesure, l'espace de noms, etc.
      • Axe Y : sélectionnez l'attribut de données à projeter sur l'axe Y. L'axe Y prend en charge les attributs de données numériques et seuls ceux-ci sont répertoriés.
      • Série : sélectionnez l'attribut de données à tracer dans des séries distinctes dans le graphique. Par exemple, ajoutez la clause groupBy avec une dimension dans la requête et visualisez des séries distinctes pour les différentes valeurs de cette dimension. Dans la requête suivante, la mesure d'utilisation de l'UC dans l'espace de noms oracle_oci_database est regroupée par dimension resourceName et des séries distinctes sont affichées pour chacune des ressources.

        CpuUtilization[auto].groupBy(resourceName).mean()

        Cette option est également disponible pour un graphique à camembres.

      • Taille : sélectionnez un attribut de données auquel affecter des valeurs de taille. Cette option n'est disponible que pour un graphique à bulles.
      • Couleur par : sélectionnez l'attribut de données auquel affecter des couleurs distinctes. En règle générale, l'option Couleur par est utilisée avec l'option Série pour affecter des couleurs distinctes à la série distincte. Cette option est également disponible pour un graphique à camembres.
      • Titre de l'axe des X : indiquez un titre pour l'attribut de données projeté sur l'axe des X.
      • Titre de l'axe des Y : indiquez un titre pour l'attribut de données projeté sur l'axe des Y.
      • Légende : indiquez l'emplacement de la légende dans le widget. Cette option est également disponible pour un graphique à camembres.
      • Info-bulles corrélées : sélectionnez cette option pour corréler les info-bulles dans tous les widgets basés sur une requête du tableau de bord.
      • Curseur de données : sélectionnez cette option pour afficher une info-bulle lorsque vous passez le curseur de la souris sur le widget.
      • Empilé : sélectionnez cette option pour empiler les attributs de données affichés dans le graphique, par couleur.
      • Utiliser une couleur solide : lorsque vous utilisez un graphique Aire pour la visualisation, la zone qui représente la présence des données est couverte par une couleur solide. Cette option est sélectionnée par défaut.

      Pour plus d'informations sur les options de visualisation dans un générateur de widget basé sur une requête, reportez-vous à A propos des options de visualisation.

    • Paramètres : vérifiez et modifiez les entrées de widget, si nécessaire.
11. Cliquez sur Enregistrer pour enregistrer le widget dans la bibliothèque de widgets et l'ajouter au tableau de bord.