È possibile creare estensioni di metrica per utilizzare la diagnostica e la gestione della gestione del database come strumento di monitoraggio centrale per i database gestiti.

Per creare un'estensione di metrica:

1. Accedi alla console di Oracle Cloud Infrastructure.
2. Aprire il menu di navigazione e fare clic su Osservabilità e gestione. In Gestione database, fare clic su Amministrazione.
3. Nel riquadro sinistro, fare clic su Estensioni di metrica e selezionare un compartimento nell'elenco a discesa Compartimento. L'estensione di metrica deve essere creata nel compartimento in cui risiede o è monitorata il database.
4. Fare clic su Crea estensione metrica.
5. Nel pannello Crea estensione metrica:
   1. Fornire le seguenti proprietà dell'estensione metrica:
      1. Nome: immettere un nome per l'estensione di metrica. Il nome dell'estensione di metrica viene preceduto automaticamente da ME_.
      2. Nome visualizzato: immettere un nome visualizzato per l'estensione della metrica, se diverso dal nome. Il nome visualizzato può contenere spazi e numeri.
      3. Descrizione: è possibile immettere una descrizione per l'estensione di metrica.
   2. Fornire le proprietà del metodo di raccolta per specificare il tipo di risorsa del database, ad esempio CDB, PDB o non CDB per il quale si sta creando l'estensione di metrica e altre proprietà:
      1. Tipo di risorsa: selezionare il tipo di risorsa di database per il quale si sta creando un'estensione di metrica.
      2. Metodo di raccolta: selezionare il metodo di raccolta SQL per eseguire query SQL personalizzate sui database gestiti, restituendo i risultati in una tabella di metriche.
      3. Frequenza di raccolta: selezionare le opzioni per specificare la frequenza di raccolta dell'estensione di metrica.
      4. Query SQL: immettere la query SQL. Ad esempio:

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

         Sono supportate anche le istruzioni PL/SQL e, se utilizzate, è necessario popolare le proprietà Posizione parametri in uscita e Tipo di parametro in uscita. Le variabili di binding possono essere passate alla query SQL utilizzando le proprietà In parametro.

         Selezionare Carica file sopra il campo Query SQL per selezionare o trascinare lo script SQL da eseguire e fornire le proprietà dei parametri di input-output pertinenti.

      5. Nel parametro: è possibile immettere la bind variable se si utilizza l'opzione Query SQL o i parametri di input se si utilizza l'opzione Script SQL.
         Nota
         
         Nel parametro supporta l'uso del segnaposto della proprietà dell'istanza, che può essere utilizzato per sostituire il segnaposto con il valore effettivo della proprietà dell'istanza del database gestito per il quale viene raccolta la metrica. Ad esempio, per oracle_psft, db_service_name è una proprietà di istanza. Può essere passato come valore nel parametro all'interno di una coppia di simboli % (percentuale), %db_service_name%.
      6. Posizione parametro OUT: è possibile immettere il numero di posizione del parametro di output.
      7. Tipo di parametro OUT: è possibile selezionare il tipo di parametro di output. Questo campo è abilitato solo se il numero di posizione del parametro di output è specificato nel campo Posizione parametro Uscita.
   3. Fornire le proprietà di metrica e dimensione riportate di seguito.
      1. Nome: immettere il nome della metrica o della dimensione in PascalCase. Ad esempio, CpuUtilization e TotalDatabaseSize.
         Nota
         
         Le metriche in un'estensione di metrica con stato Bozza possono avere gli stessi nomi per lo stesso tipo di risorsa, ma non quando l'estensione di metrica viene pubblicata. Se un determinato nome di metrica per un tipo di risorsa è già utilizzato e viene utilizzato in un'estensione di metrica pubblicata, lo stesso non può essere utilizzato da un'altra metrica per lo stesso tipo di risorsa. Ad esempio, se esiste un'estensione di metrica pubblicata ME_FirstMetricExtension per un determinato tipo di risorsa e ha una metrica denominata MetricFirst, non è possibile pubblicare un'altra estensione di metrica, ME_SecondMetricExtension, per lo stesso tipo di risorsa con una metrica denominata anche MetricFirst.

         Questo vincolo non è applicabile a metriche e dimensioni nascoste.

      2. Nome visualizzato: è possibile immettere un nome visualizzato per la metrica o la dimensione, se diverso dal nome. Il nome visualizzato può contenere spazi e numeri.
      3. È una dimensione?: selezionare Sì se si sta definendo una dimensione metrica e No se si sta definendo una metrica.

         Una dimensione è un qualificatore per una metrica e deve essere un valore univoco per ogni riga nei risultati della raccolta di metriche. Ad esempio, una metrica può essere la percentuale di spazio di storage utilizzato e la dimensione è il nome del file system.

      4. È nascosta?: selezionare Sì se la metrica verrà utilizzata solo nelle espressioni di computazione, il che significa che la metrica viene utilizzata solo come valore per calcolare un'altra metrica o non è necessaria per essere inviata al servizio Oracle Cloud Infrastructure Monitoring. Altrimenti, selezionare No.
      5. Tipo di valore: selezionare il tipo di valore. Tutte le metriche non nascoste devono essere numeriche; una metrica o una dimensione nascosta può essere String o Number.
      6. Unità: è possibile inserire l'unità associata alla metrica. A seconda della metrica, le possibili unità potrebbero essere latenza in secondi, millisecondi, microsecondi, minuti o frequenza in Hertz o percentuale. Questo campo è abilitato solo per le metriche ed è disattivato per le dimensioni.
      7. Categoria: selezionare il tipo di dati della metrica che la metrica sta raccogliendo: Disponibilità, Capacità, Carica, Utilizzo. Questo campo è abilitato solo per le metriche non nascoste ed è disattivato per le dimensioni e per le metriche nascoste.
      8. Espressione di computazione: è possibile immettere le espressioni di computazione per calcolare il valore di una metrica in base a operazioni matematiche o logiche eseguite su altre metriche o dimensioni all'interno della stessa estensione di metrica. Le espressioni di computazione richiedono la prima definizione di almeno un'altra metrica e possono includere solo le altre metriche già definite nell'estensione di metrica. Per ulteriori dettagli, vedere Espressioni di computazione.
      9. Aggiungi un'altra metrica/dimensione: fare clic per aggiungere un'altra metrica o dimensione all'estensione di metrica.
6. Fare clic su una delle opzioni riportate di seguito per creare l'estensione di metrica.
   • Crea e sottoponi a test: fare clic per eseguire il test dell'estensione di metrica su uno o più database gestiti e verificare che i valori restituiti siano corretti. In base ai valori restituiti, è possibile continuare a modificare e testare in modo iterativo.
     Nota
     
     Quando si esegue il test di un'estensione di metrica, il Management Agent viene riavviato. Si consiglia di eseguire il test delle estensioni di metrica su database non di produzione.
   • Crea: fare clic per salvare la definizione dell'estensione di metrica ed eseguire il test sui database gestiti in un secondo momento.

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