Oracle Enterprise Manager Cloud Control (EM) is Oracle's enterprise information technology (IT) management solution, which provides complete, integrated, and business-driven enterprise cloud management solution. EM collects additional information about entities such as configuration information necessary to locate log files and relationships between entities to provide topological views of applications. These topological views across application stack components help to easily troubleshoot issues with application availability and performance. The existing users of EM can set up the EM Bridge and benefit from the automated set up that imports their entity model data like the entity associations, and properties information from EM into Oracle Logging Analytics. The entity association information is then used to construct the topology in Oracle Logging Analytics.

More information about harvesting the data from EM:

• The EM targets which represent the on-premises resources are equivalents of entities in Oracle Logging Analytics. Therefore, you can leverage the discovered targets in EM to achieve faster onboarding in Logging Analytics instead of re-creating them.

• The topology in EM, including that of complex composite targets, is retained and reproduced in Oracle Logging Analytics. The target associations in EM are converted to entity relations in Oracle Logging Analytics avoiding loss of information.

• Relevant target metadata in EM is stored as entity properties in Oracle Logging Analytics enabling better monitoring of those EM resources.

• The entity properties are periodically updated with the target information that is transferred from EM to OCI Object Storage, and in turn collected by Oracle Logging Analytics using an EM Bridge.

  • Immediately after you configure the EM Bridge, the information about EM targets and their associations is collected.

  • The periodicity of transmitting information from EM and collecting it in Oracle Logging Analytics later:

    Configuration metrics and target associations: Daily

    Target and target properties: Hourly

Overview of the workflow for harvesting data from EM:

To be able to harvest the entity data model from EM, you must first group the targets in EM for Oracle Logging Analytics service. Create a Cloud Bridge in your EM monitored environment to export the target information to OCI Object Storage. After confirming that the entity data is collected in the Object Storage, create an EM Bridge between Object Storage and Oracle Logging Analytics to import the entity information into Oracle Logging Analytics. The entities are automatically created in Oracle Logging Analytics by using the entity information collected from EM. To collect your logs from your targets in EM, associate the automatically created entities with log sources so that the logs can be collected using Management Agents.

These are the overview steps to harvest EM data and collect logs:

1. Create an OCI Object Storage Bucket to collect target data from EM. See Create a Bucket: Using Console.

2. Before setting up the EM Bridge, you must prepare the EM environment to export the required information to OCI. See Prerequisites for Creating the EM Bridge.

   At this point, the OCI connectivity is set up, and your target data is automatically uploaded at frequent intervals to OCI Object Storage.

3. Using the compartment name and the bucket name that you specified in EM while setting up the Cloud bridge, verify in OCI Object Storage that the entity data is successfully collected. See View Bucket Details: Using Console in Oracle Cloud Infrastructure Documentation.

4. Install the Management Agents on your EM hosts to continuously collect logs from the EM entities:

   See Oracle Management Agents Documentation to complete the following tasks:

   • Perform prerequisites for deploying Management Agents

   • Install Management Agents

5. Create IAM policies to collect the entity information from the Object Storage. See Allow Users to Perform EM Bridge Operations.

6. Now that the entity information is available in OCI Object Storage, create an EM Bridge to collect it and create the entity data model which helps to perform a complete log analysis for monitoring the EM targets. Upon creating the EM Bridge, the entities are automatically created in Oracle Logging Analytics.

   • Using console: Add an EM Bridge
   • Using CLI: EM Bridge Operations Using CLI
   • Using REST API: EM Bridge Operations Using REST API
   Note
   
   

   • Create EM Bridge Operation:

     Every EM Bridge must have a unique display name in a specific tenancy.

     There can only be one EM Bridge for a specific OCI object store bucket in a given tenancy.

   • Delete EM Bridge Operation:

     If you delete an EM Bridge, then the entities that were automatically created using the EM Bridge will not be deleted.

     If a target is deleted in EM, then the corresponding entity is not automatically deleted in Oracle Logging Analytics.

   • Changing the EM Bridge Compartment:

     This operation only moves the EM Bridge resource to another compartment. The entities that are automatically created when you create the EM bridge cannot be moved to other compartments.

7. Ensure to enable the auto-association feature for the specific sources that you want to associate with the EM entities. See Enable Auto-Association for a Source. After the creation of EM Bridge, the eligible entities are automatically associated with the relevant sources.

At this point, the logs will start collecting from the EM targets into Oracle Logging Analytics. You can view them in the log explorer.