Vous pouvez créer des extensions de mesure pour tirer parti des diagnostics et de la gestion du service de gestion de bases de données en tant qu'outil de surveillance central pour vos bases de données gérées.

Pour créer une extension de mesure :

1. Connectez-vous à la console Oracle Cloud Infrastructure.
2. Ouvrez le menu de navigation, cliquez sur Observabilité et gestion. Sous Gestion de bases de données, cliquez sur Administration.
3. Dans le volet 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 réside la base de données ou dans lequel elle est surveillée.
4. Cliquez sur Créer une extension de mesure.
5. Dans le panneau Créer une extension de mesure :
   1. Indiquez les propriétés suivantes de l'extension de mesure :
      1. Nom : Entrez un nom pour l'extension de mesure. Le nom de l'extension de mesure est automatiquement précédé du préfixe ME_.
      2. Nom d'affichage : Entrez un nom d'affichage pour l'extension de mesure, s'il est différent de ce nom. Le nom d'affichage peut contenir des espaces et des chiffres.
      3. Description : Facultativement, entrez une description de l'extension de mesure.
   2. Fournissez des propriétés de méthode de collecte pour spécifier le type de ressource de base de données, comme la base de données conteneur, la base de données enfichable ou la base de données non conteneur pour laquelle l'extension de mesure est en cours de création, 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 interrogations SQL personnalisées sur des bases de données gérées, et retourner les résultats dans une table de mesures.
      3. Fréquence de collecte : Sélectionnez des options pour spécifier la fréquence à laquelle l'extension de mesure doit être collectée.
      4. Interrogation SQL : Entrez l'interrogation SQL. Exemple :

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

         Les énoncés PL/SQL sont également pris en charge et, s'ils sont utilisés, les propriétés Out parameter position (Position du paramètre de sortie) et Out parameter type (Type de paramètre de sortie) doivent être alimentées. Les variables de liaison peuvent être transmises à l'interrogation SQL à l'aide des propriétés Dans le paramètre.

         Sélectionnez Charger un fichier au-dessus du champ Interrogation SQL pour sélectionner ou glisser-déposer 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 : Facultativement, entrez la variable de liaison si vous utilisez l'option Interrogation SQL ou les paramètres d'entrée si vous utilisez l'option Script SQL.
         Note
         
         Dans le paramètre prend en charge l'utilisation du paramètre fictif de la propriété d'instance, qui peut être utilisé pour remplacer le paramètre fictif par la valeur réelle de la propriété d'instance 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 : Facultativement, entrez le numéro de position du paramètre de sortie.
      7. Type de paramètre de sortie : Facultativement, sélectionnez le type de paramètre de sortie. Ce champ n'est activé que 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.
         Note
         
         Les mesures d'une extension de mesure ayant le statut Provisoire peuvent avoir les mêmes noms pour le même type de ressource, mais pas lorsque l'extension de mesure est publiée. Si un nom de mesure particulier pour un type de ressource est déjà pris et est 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, s'il existe une extension de mesure publiée ME_FirstMetricExtension pour un type de ressource particulier et qu'elle a 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 : Facultativement, entrez 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. Elle 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 masqué? : Sélectionnez Oui si la mesure ne sera utilisée que dans les expressions de calcul, ce qui signifie que la mesure est utilisée uniquement comme valeur pour calculer une autre mesure ou qu'elle n'est pas requise pour ê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é : Facultativement, entrez l'unité associée à la mesure. Selon la mesure, les unités possibles peuvent avoir une 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 qui sont masquées.
      8. Expression de calcul : Facultativement, entrez 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 dans la même extension de mesure. Les expressions de calcul nécessitent qu'au moins une autre mesure soit définie en premier et ne peuvent inclure que les autres mesures qui ont déjà été définies dans l'extension de mesure. Pour plus de détails, voir Expressions de calcul.
      9. Ajouter une autre mesure/dimension : Cliquez 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 sur une ou plusieurs bases de données gérées et vérifier que les valeurs retournées sont correctes. En fonction des valeurs retournées, vous pouvez continuer à modifier et à tester de manière itérative.
     Note
     
     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 effectuer des tests plus tard 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