+
-
+
- Go to OCI Console > Observability & Management > Database Management. +
- Click on Administration > Metric Extensions. +
- Choose the target database for which you want to create the metric extension. +
++
-
+
- Click on Create Metric Extension. +
- Fill in the metric extension details as shown below: +
+ +
SELECT COUNT(*) AS active_sessions
+FROM V$SESSION
+WHERE STATUS = 'ACTIVE';Use this when the target level is CDB.
+ +
+
+
+The unit field must be a valid unit:
percent, count, seconds, MB, etc.
++
-
+
- Enter the details as shown in the example above and click on Create and test. +
- In the next window, select the database to test with and click on Test as shown below. +
+
It may take a few seconds to a couple of minutes to complete the test and return the results. Once you see “Success,” the results will be displayed.
+
+
Note the Test ID here.
++- The SQL is invalid.
+- Required privileges are missing.
+- Output columns or data types are incorrect.
+
+It is recommended to log in to the database and test your SQL query beforehand to ensure it is valid and returns the expected data. +
+
-
+
- Leave the previous page as is, and open a new tab (or duplicate the tab) to follow these steps: +
- From the main menu, go to OCI Console > Observability & Management > Monitoring > Metrics Explorer. +
- Select the following options as shown. Note that the metric namespace will end with
appmgmt_test. Click on Update Chart.
+
+
+
You will be able to view the metric in the chart above.
+appmgmt_test to verify that the metric is working as expected before publishing.
++
-
+
- Once you have confirmed the metric is working, return to the metric extension page and click on Publish. Then confirm the publish operation. +
+
The metric extension will now be listed on the main page of Metric Extensions as shown:
+
+
+
-
+
- Click on the three-dots menu and select Enable > Select resources. +
- Select the database from the list and click Enable on selected resources. +
- Confirm the enable action when prompted. +
+
+
+
This may take some time to execute. After you see success, check back after at least 5–6 minutes to see at least two metric points on the Metrics Explorer graph, as shown below.
++
-
+
- After publishing the metric extension, make sure to select the namespace
appmgmt(not the test one used earlier).
+
+
Click on Update Chart and review the graph:
+
+
Click on Show Data Table to see the metric values clearly:
+
+
appmgmt namespace (not the test namespace) to view production metrics data.
++
+
SELECT
+ ROUND((1 - (b.BYTES_FREE / a.BYTES_ALLOC)) * 100, 2) AS pct_used
+FROM
+ (SELECT SUM(BYTES) AS BYTES_ALLOC
+ FROM DBA_DATA_FILES
+ WHERE TABLESPACE_NAME = 'SYSTEM') a,
+ (SELECT SUM(BYTES) AS BYTES_FREE
+ FROM DBA_FREE_SPACE
+ WHERE TABLESPACE_NAME = 'SYSTEM') b;Use this when the target level is PDB.
+-
+
- Follow the same steps as for the CDB-level query above. Note the following changes: +
+
Select Pluggable DB for PDB-level queries. Test, publish, and enable as before.
+
+
+
-
+
- Go to Monitoring > Metrics Explorer and select the appropriate options. +
+
Click Update to view the captured metrics.
+
+
