Vous pouvez créer des extensions de mesure afin d'exploiter Database Management Diagnostics & Management en tant qu'outil de surveillance central pour vos bases de données gérées.

Pour créer une extension de mesure, procédez comme suit :

1. Connectez-vous à la console Oracle Cloud Infrastructure.
2. Ouvrez le menu de navigation et cliquez sur Observation & gestion. Sous Gestion de base de données, cliquez sur Administration.
3. Dans le panneau de gauche, cliquez sur Extensions de mesure et sélectionnez un compartiment dans la liste déroulante Compartiment. L'extension de mesure doit être créée dans le compartiment dans lequel la base de données réside ou est surveillée.
4. Cliquez sur Créer une extension de mesure.
5. Dans le panneau Créer une extension de mesure, procédez comme suit :
   1. Indiquez les propriétés d'extension de mesure suivantes :
      1. Nom : entrez le nom de l'extension de mesure. Le nom de l'extension de mesure est automatiquement précédé du préfixe ME_.
      2. Nom d'affichage : saisissez un nom d'affichage pour l'extension de mesure, s'il est différent du nom. Le nom d'affichage peut contenir des espaces et des chiffres.
      3. Description : entrez éventuellement une description pour l'extension de mesure.
   2. Fournissez des propriétés de méthode de collecte pour indiquer le type de ressource de base de données, tel que la base de données Conteneur, la base de données pluggable ou la base de données non Conteneur pour laquelle l'extension de mesure est créée, ainsi que d'autres propriétés :
      1. Type de ressource : sélectionnez le type de ressource de base de données pour lequel vous créez une extension de mesure.
      2. Méthode de collecte : sélectionnez la méthode de collecte SQL pour exécuter des requêtes SQL personnalisées sur des bases de données gérées et renvoyer les résultats dans une table de mesures.
      3. Fréquence de collecte : sélectionnez des options pour indiquer la fréquence de collecte de l'extension de mesure.
      4. Requête SQL : entrez la requête SQL. Exemple :

         select a.ename, (select count(*) from emp p where p.mgr=a.empno) directs from emp a

         Les instructions PL/SQL sont également prises en charge, et si elles sont utilisées, les propriétés Position du paramètre de sortie et Type du paramètre de sortie doivent être renseignées. Les variables attachées peuvent être transmises à la requête SQL à l'aide des propriétés Dans le paramètre.

         Sélectionnez Télécharger le fichier au-dessus du champ Requête SQL pour sélectionner ou déplacer le script SQL à exécuter et fournir les propriétés de paramètre d'entrée-sortie appropriées.

      5. Dans le paramètre : vous pouvez éventuellement entrer la variable de liaison si vous utilisez l'option Requête SQL ou les paramètres d'entrée si vous utilisez l'option Script SQL.
         Remarque
         
         Dans le paramètre prend en charge l'utilisation d'un espace réservé de propriété d'instance, qui peut être utilisé pour remplacer l'espace réservé par la valeur de propriété d'instance réelle de la base de données gérée pour laquelle la mesure est collectée. Par exemple, pour oracle_psft, db_service_name est une propriété d'instance. Il peut être transmis en tant que valeur Dans le paramètre dans une paire de symboles (pourcentage) %, %db_service_name%.
      6. Position du paramètre de sortie : saisissez éventuellement le numéro de position du paramètre de sortie.
      7. Type du paramètre de sortie : sélectionnez éventuellement le type du paramètre de sortie. Ce champ est activé uniquement si le numéro de position du paramètre de sortie est spécifié dans le champ Position du paramètre de sortie.
   3. Indiquez les propriétés de mesure et de dimension suivantes :
      1. Nom : entrez le nom de la mesure ou de la dimension dans PascalCase. Par exemple, CpuUtilization et TotalDatabaseSize.
         Remarque
         
         Les mesures d'une extension de mesure avec le statut Brouillon peuvent porter le même nom pour le même type de ressource, mais pas lors de la publication de l'extension de mesure. Si un nom de mesure particulier pour un type de ressource est déjà pris et utilisé dans une extension de mesure publiée, il ne peut pas être utilisé par une autre mesure pour le même type de ressource. Par exemple, si une extension de mesure ME_FirstMetricExtension est publiée pour un type de ressource particulier et qu'elle comporte une mesure nommée MetricFirst, vous ne pouvez pas publier une autre extension de mesure, ME_SecondMetricExtension, pour le même type de ressource avec une mesure également nommée MetricFirst.

         Cette contrainte ne s'applique pas aux mesures et dimensions masquées.

      2. Nom d'affichage : vous pouvez éventuellement entrer un nom d'affichage pour la mesure ou la dimension, s'il est différent du nom. Le nom d'affichage peut contenir des espaces et des chiffres.
      3. Est une dimension ? : sélectionnez Oui si vous définissez une dimension de mesure et Non si vous définissez une mesure.

         Une dimension est un qualificatif pour une mesure et doit être une valeur unique pour chaque ligne des résultats de la collecte de mesures. Par exemple, une mesure peut être le pourcentage d'espace de stockage utilisé et la dimension est le nom du système de fichiers.

      4. Est-il masqué ? : sélectionnez Oui si la mesure est utilisée uniquement dans les expressions de calcul, ce qui signifie que la mesure est utilisée uniquement en tant que valeur pour calculer une autre mesure ou qu'elle n'a pas besoin d'être envoyée au service Oracle Cloud Infrastructure Monitoring. Sinon, sélectionnez Non.
      5. Type de valeur : sélectionnez le type de valeur. Toutes les mesures non masquées doivent être numériques ; une mesure ou une dimension masquée peut être String ou Number.
      6. Unité : entrez éventuellement l'unité associée à la mesure. Selon la mesure, les unités possibles peuvent être la latence en secondes, millisecondes, microsecondes, minutes ou fréquence en Hertz ou en pourcentage. Ce champ n'est activé que pour les mesures et est grisé pour les dimensions.
      7. Catégorie : sélectionnez le type de données de mesure que la mesure collecte : Disponibilité, Capacité, Charger, Utilisation. Ce champ n'est activé que pour les mesures qui ne sont pas masquées et est grisé pour les dimensions et pour les mesures masquées.
      8. Expression de calcul : vous pouvez éventuellement entrer des expressions de calcul pour calculer la valeur d'une mesure en fonction d'opérations mathématiques ou logiques effectuées sur d'autres mesures ou dimensions au sein de la même extension de mesure. Les expressions de calcul nécessitent au moins une autre mesure à définir en premier et peuvent uniquement inclure les autres mesures qui ont déjà été définies dans l'extension de mesure. Pour plus d'informations, reportez-vous à Expressions de calcul.
      9. Ajouter une autre mesure/dimension : cliquez sur cette option pour ajouter une autre mesure ou dimension à l'extension de mesure.
6. Cliquez sur l'une des options suivantes pour créer l'extension de mesure :
   • Créer et tester : cliquez sur cette option pour tester l'extension de mesure par rapport à des bases de données gérées et vérifier que les valeurs renvoyées sont correctes. En fonction des valeurs renvoyées, vous pouvez continuer à les modifier et à les tester de manière itérative.
     Remarque
     
     Lors du test d'une extension de mesure, l'agent de gestion est redémarré. Il est recommandé de tester les extensions de mesure sur les bases de données hors production.
   • Créer : cliquez sur cette option pour enregistrer la définition d'extension de mesure et la tester ultérieurement sur les bases de données gérées.

WITH wait_stats AS (
SELECT
inst_id,
wait_class,
time_waited_fg
FROM
TABLE ( gv$(CURSOR(
SELECT
to_number(userenv('INSTANCE')) AS inst_id,
wait_class,
time_waited_fg / 100 AS time_waited_fg
FROM
v$system_wait_class
WHERE
wait_class <> 'Idle'
)) )
), inst_list AS (
SELECT
instance_number,
instance_name,
host_name
FROM
TABLE ( gv$(CURSOR(
SELECT
instance_number,
instance_name,
host_name
FROM
v$instance
)) )
)
SELECT
inst.instance_number instance_number,
inst.instance_name instance_name,
inst.host_name host_name,
ws.wait_class wait_class,
ws.time_waited_fg time_waited_fg
FROM
wait_stats ws,
inst_list inst
WHERE
inst.instance_number = ws.inst_id