Sie können Metrikerweiterungen erstellen, um die Diagnose und Verwaltung des Datenbankmanagements als zentrales Überwachungstool für Ihre verwalteten Datenbanken zu nutzen.

So erstellen Sie eine Metrikerweiterung:

1. Melden Sie sich bei der Oracle Cloud Infrastructure-Konsole an.
2. Öffnen Sie das Navigationsmenü, und klicken Sie auf Observability and Management. Klicken Sie unter Datenbankmanagement auf Administration.
3. Klicken Sie im linken Bereich auf Metrikerweiterungen, und wählen Sie ein Compartment in der Dropdown-Liste Compartment aus. Die Metrikerweiterung muss in dem Compartment erstellt werden, in dem sich die Datenbank befindet oder in dem sie überwacht wird.
4. Klicken Sie auf Metrikerweiterung erstellen.
5. Gehen Sie im Bereich Metrikerweiterung erstellen wie folgt vor:
   1. Geben Sie die folgenden Metrikerweiterungseigenschaften an:
      1. Name: Geben Sie einen Namen für die Metrikerweiterung ein. Der Name der Metrikerweiterung wird automatisch mit dem Präfix ME_ versehen.
      2. Anzeigename: Geben Sie einen Anzeigenamen für die Metrikerweiterung ein, falls dieser vom Namen abweicht. Der Anzeigename kann Leerzeichen und Zahlen enthalten.
      3. Beschreibung: Geben Sie optional eine Beschreibung für die Metrikerweiterung ein.
   2. Geben Sie Collection-Methodeneigenschaften an, um den Datenbankressourcentyp anzugeben, wie die CDB, PDB oder Nicht-CDB, für die die Metrikerweiterung erstellt wird, und andere Eigenschaften:
      1. Ressourcentyp: Wählen Sie den Datenbankressourcentyp aus, für den Sie eine Metrikerweiterung erstellen.
      2. Erfassungsmethode: Wählen Sie die Erfassungsmethode SQL aus, um benutzerdefinierte SQL-Abfragen für verwaltete Datenbanken auszuführen und Ergebnisse in einer Metriktabelle zurückzugeben.
      3. Erfassungshäufigkeit: Wählen Sie Optionen aus, um anzugeben, wie oft die Metrikerweiterung erfasst werden muss.
      4. SQL-Abfrage: Geben Sie die SQL-Abfrage ein. Beispiele:

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

         PL/SQL-Anweisungen werden auch unterstützt, wenn sie verwendet werden, müssen die Eigenschaften Out-Parameterposition und Out-Parametertyp ausgefüllt werden. Bind-Variablen können mit den Eigenschaften In Parameter an die SQL-Abfrage übergeben werden.

         Wählen Sie über dem Feld SQL-Abfrage die Option Datei hochladen aus, um das auszuführende SQL-Skript auszuwählen oder per Drag-and-Drop zu verschieben und die entsprechenden Eigenschaften für den Eingabeausgabeparameter anzugeben.

      5. In Parameter: Geben Sie optional die Bind-Variable ein, wenn Sie die Option SQL-Abfrage oder Eingabeparameter verwenden, wenn Sie die Option SQL-Skript verwenden.
         Hinweis
         
         In Parameter unterstützt die Verwendung des Platzhalters der Instanzeigenschaft. Dieser kann verwendet werden, um den Platzhalter durch den tatsächlichen Instanzeigenschaftswert der verwalteten Datenbank zu ersetzen, für die die Metrik erfasst wird. Beispiel: Für oracle_psft ist db_service_name eine Instanzeigenschaft. Er kann als In Parameter-Wert innerhalb eines Paares von %-Symbolen (Prozentsatz) übergeben werden, %db_service_name%.
      6. Out-Parameterposition: Geben Sie optional die Positionsnummer des Ausgabeparameters ein.
      7. Out-Parametertyp: Wählen Sie optional den Typ des Ausgabeparameters aus. Dieses Feld ist nur aktiviert, wenn die Positionsnummer des Ausgabeparameters im Feld Ausgangsparameterposition angegeben ist.
   3. Geben Sie die folgenden Metrik- und Dimensionseigenschaften an:
      1. Name: Geben Sie den Namen der Metrik oder Dimension in PascalCase ein. Beispiel: CpuUtilization und TotalDatabaseSize.
         Hinweis
         
         Metriken in einer Metrikerweiterung mit dem Entwurfsstatus können dieselben Namen für denselben Ressourcentyp aufweisen, jedoch nicht, wenn die Metrikerweiterung veröffentlicht wird. Wenn ein bestimmter Metrikname für einen Ressourcentyp bereits verwendet und in einer veröffentlichten Metrikerweiterung verwendet wird, kann er nicht von einer anderen Metrik für denselben Ressourcentyp verwendet werden. Beispiel: Wenn für einen bestimmten Ressourcentyp eine veröffentlichte Metrikerweiterung ME_FirstMetricExtension mit der Metrik MetricFirst vorhanden ist, können Sie keine weitere Metrikerweiterung ME_SecondMetricExtension für denselben Ressourcentyp mit der Metrik MetricFirst veröffentlichen.

         Dieses Constraint gilt nicht für ausgeblendete Metriken und Dimensionen.

      2. Anzeigename: Geben Sie optional einen Anzeigenamen für die Metrik oder Dimension ein, wenn dieser nicht mit dem Namen übereinstimmt. Der Anzeigename kann Leerzeichen und Zahlen enthalten.
      3. Ist Dimension?: Wählen Sie Ja aus, wenn Sie eine Metrikdimension definieren, und Nein, wenn Sie eine Metrik definieren.

         Eine Dimension ist ein Qualifier für eine Metrik und muss ein eindeutiger Wert für jede Zeile in den Ergebnissen der Metriksammlung sein. Beispiel: Eine Metrik kann der Prozentsatz des belegten Speicherplatzes sein, und die Dimension ist der Name des Dateisystems.

      4. Ist ausgeblendet?: Wählen Sie Ja aus, wenn die Metrik nur in Compute-Ausdrücken verwendet wird. Das bedeutet, dass die Metrik nur als Wert zur Berechnung einer anderen Metrik verwendet wird oder nicht an den Oracle Cloud Infrastructure Monitoring-Service gesendet werden muss. Andernfalls wählen Sie Nein.
      5. Werttyp: Wählen Sie den Werttyp aus. Alle nicht ausgeblendeten Metriken müssen numerisch sein. Eine ausgeblendete Metrik oder Dimension kann String oder Number sein.
      6. Einheit: Geben Sie optional die mit der Metrik verknüpfte Einheit ein. Je nach Metrik können mögliche Einheiten Latenz in Sekunden, Millisekunden, Mikrosekunden, Minuten oder Häufigkeit in Hertz oder Prozentsatz sein. Dieses Feld ist nur für Metriken aktiviert und für Dimensionen ausgegraut.
      7. Kategorie: Wählen Sie den Typ der Metrikdaten aus, die von der Metrik erfasst werden: Verfügbarkeit, Kapazität, Laden, Auslastung. Dieses Feld ist nur für Metriken aktiviert, die nicht ausgeblendet sind und für Dimensionen und ausgeblendete Metriken ausgegraut sind.
      8. Compute-Ausdruck: Geben Sie optional Compute-Ausdrücke ein, um den Wert einer Metrik basierend auf mathematischen oder logischen Vorgängen zu berechnen, die für andere Metriken oder Dimensionen innerhalb derselben Metrikerweiterung ausgeführt werden. Für Compute-Ausdrücke muss zuerst mindestens eine andere Metrik definiert werden. Sie können nur die anderen Metriken enthalten, die bereits in der Metrikerweiterung definiert wurden. Zusätzliche Details finden Sie unter Compute-Ausdrücke.
      9. Weitere Metrik/Dimension hinzufügen: Klicken Sie auf diese Option, um der Metrikerweiterung eine weitere Metrik oder Dimension hinzuzufügen.
6. Klicken Sie auf eine der folgenden Optionen, um die Metrikerweiterung zu erstellen:
   • Erstellen und testen: Klicken Sie auf diese Option, um die Metrikerweiterung für eine oder mehrere verwaltete Datenbanken zu testen und zu prüfen, ob die zurückgegebenen Werte korrekt sind. Basierend auf den zurückgegebenen Werten können Sie die Bearbeitung und den Test iterativ fortsetzen.
     Hinweis
     
     Beim Testen einer Metrikerweiterung wird der Management Agent neu gestartet. Es wird empfohlen, Metrikerweiterungen in Nicht-Produktionsdatenbanken zu testen.
   • Erstellen: Klicken Sie auf diese Option, um die Metrikerweiterungsdefinition zu speichern und zu einem späteren Zeitpunkt mit verwalteten Datenbanken zu testen.

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