My Oracle Support Banner

Announcement: User Defined Metrics are Being Deprecated in Enterprise Manager Cloud Control 12.1 and Desupported in EM 13.1 (Doc ID 1582656.1)

Last updated on MARCH 23, 2020

Applies to:

Enterprise Manager Base Platform - Version and later
Information in this document applies to any platform.


What are User-Defined Metrics?

User-Defined Metrics allow users to extend Enterprise Manager's monitoring capabilities by defining their own custom metrics.   With the release of Enterprise Manager Cloud Control 12c,  Metric Extensions were introduced as the next generation of User-Defined Metrics.   Metric Extensions provide all the capabilities of User-Defined Metrics and more.   Enhancements over User-Defined Metrics include:  support for all target types, support for multiple metric columns in a metric definition,  more data access mechanisms, and workflow support for the development and deployment of metric extensions.   In Enterprise Manager 12c, CLI (Command Line Interface) verbs are available to help users migrate their existing User-Defined Metrics to Metric Extensions.   Also, begining with Enterprise Manager 12c, new User-Defined Metrics can no longer be created.  All User-Defined Metrics that exist in an Enterprise Manager site will be available if the Enterprise Manager site was upgraded to 12c.  They can also be propagated to new targets using monitoring templates, but new User-Defined Metrics can not be created. 

What is the impact of the deprecation and de-support?

The deprecation will still allow any User-Defined Metric to work in Enterprise Manager 12c.  However users should cut over these metrics to Metric Extensions as soon as possible.  In Enterprise Manager 13c, User Defined Metrics will no longer be supported. Starting with EM 13.5, the EMCLI verbs responsible for migrating User-Defined Metrics to Metric Extensions will be deprecated.


What do you need to do?

Convert all existing User-Defined Metrics to Metric Extensions.   You can do this in one of 2 ways:

  1. Use the EM CLI (Enterprise Manager Command Line Interface) verbs specifically created to help with the migration process. For details, refer to Section 8.5 Converting User-defined Metrics to Metric Extensions of Chapter 9: Using Metric Extensions of the Enterprise Manager Cloud Control Administrator's Guide 12c.


  2. Create new metric extensions based on the scripts you have created for your user-defined metrics


What will you do if the deprecated feature is removed in a future release?

Use Metric Extensions as the way to create new metrics.  For details, refer to Chapter 8: Using Metric Extensions of the Enterprise Manager Cloud Control Administrator's Guide 13c.



To view full details, sign in with your My Oracle Support account.

Don't have a My Oracle Support account? Click to get started!

In this Document

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.