Utilisation du filtre Dimension de mesure

Vous pouvez utiliser le filtre de dimension de mesure afin d'indiquer l'entrée de mesure du service Oracle Cloud Infrastructure Monitoring pour un widget.

Le filtre Dimension de mesure peut être utilisé pour filtrer les données de mesure par valeur de dimension. Un scénario courant pour l'utilisation de ce filtre consiste à l'ajouter en tant que paramètre d'entrée supplémentaire pour fournir différentes valeurs de dimension à un widget basé sur une requête et à réutiliser le widget.

Voici un exemple dans lequel le filtre de dimension de mesure est ajouté en tant qu'entrée supplémentaire à un widget Database Management basé sur des requêtes qui utilise des mesures. Dans cet exemple, l'espace de noms oracle_oci_database, la mesure CpuUtilization et la dimension resourceName sont utilisés. Notez que cet exemple ne détaille pas tous les champs et options disponibles dans le générateur de widget basé sur une requête. Pour plus d'informations, reportez-vous à Création d'un widget basé sur une requête à l'aide de mesures.

  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. Dans l'onglet Filtres, entrez Dimension de mesure dans le champ de recherche et cliquez sur le filtre Dimension de mesure pour l'ajouter au tableau de bord.

    Lors de l'ajout du filtre, indiquez les détails suivants dans les boîtes de dialogue Configurer l'entrée <name> pour la dimension de mesure (obligatoire) :

    1. Espace de noms : sélectionnez oracle_oci_database.
    2. Nom de mesure : sélectionnez CpuUtilization.
    3. Nom de la dimension : sélectionnez resourceName.
    Remarque

    Le filtre de dimension de mesure requiert également l'entrée de compartiment pour déterminer le compartiment dans lequel réside la mesure. Toutefois, l'entrée de compartiment est automatiquement configurée pour utiliser le filtre de compartiment. Si nécessaire, vous pouvez modifier l'entrée configurée automatiquement.
  4. Dans la liste déroulante de filtre de dimension de mesure du tableau de bord, sélectionnez une ressource de base de données dans le compartiment.
  5. Dans l'onglet Widgets, cliquez sur l'icône Ajouter un groupe de widgets et des widgets (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.
  6. Cliquez sur l'icône Ouvrir/fermer le panneau de filtre (Ouvrir/fermer le panneau de filtre) pour confirmer l'ajout des filtres de dimension de mesure et de compartiment.
  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 sélectionné dans le filtre de dimension de mesure, oracle_oci_database.
    2. 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 CpuUtilization.
    3. Cliquez sur Exécuter.
  9. Pour ajouter un paramètre d'entrée supplémentaire et le lier au filtre de dimension de mesure, procédez comme suit :
    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 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. Configurer l'entrée de widget : sélectionnez Lier l'entrée à un filtre existant et liez le paramètre d'entrée au filtre de dimension de mesure.
  10. Modifiez la requête et ajoutez un espace réservé pour afficher les données du filtre de dimension de mesure dans le widget, à l'aide de l'expression suivante :
    {<dimension>=$(params.<input_name>)}

    Dans le cadre de cet exemple, voici à quoi ressemblera l'espace réservé dans la requête :

    CpuUtilization[auto]{resourceName=$(params.resourcename)}.mean()
  11. Dans l'onglet 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.
  12. Dans l'onglet Visualisation, sélectionnez un type de graphique et personnalisez la visualisation en indiquant ou en modifiant des options supplémentaires.
  13. Cliquez sur Enregistrer pour enregistrer le widget dans la bibliothèque de widgets et l'ajouter au tableau de bord.
Une fois le widget basé sur une requête ajouté au tableau de bord et à la bibliothèque de widgets, vous pouvez modifier la valeur de dimension de la dimension resourceName dans le filtre Dimension de mesure afin d'afficher la mesure CpuUtilization pour différentes ressources de base de données.