Oracle Cloud Infrastructure Documentation

Auto-Discovery of Entities and Log Collection

You can initiate the discovery of entities like packaged applications, databases, middleware, and other components using the Stack Monitoring UI, view the entity topology, and collect logs from those entities.

Your entity might have multiple dependent entities that emit logs. When you discover the composite entity, the dependent entities are automatically discovered.

Prerequisites:

Use an existing log group or create at least one log group to store logs that you collect from your entities. See Create Log Groups to Store Your Logs.

Tasks To Perform

The following steps use the example of the packaged application Oracle E-Business Suite (EBS) at most places. However, these steps can be followed for all the resource types supported by Stack Monitoring service.

  1. Install the Management Agents and Deploy Plug-ins

    • For Discovery of EBS Entities: Install the Management Agent on the compute instance that has EBS middleware (WebLogic Admin Server). On this agent, if the Stack Monitoring Plug-in is not automatically deployed, then ensure to deploy it.

    • For Log Collection: Install Management Agents on all the hosts that have the EBS components installed on them. On those agents, deploy Logging Analytics plug-in for collecting the log data.

    Ensure that the Management Agent version is 211116.1855 or later. See Install Management Agents and Deploy a Plug-in During the Management Agent Installation.

  2. Prepare Your Packaged Application Hosts to Transmit Logs to Logging Analytics

    See Grant READ Access of the Logs to the Agent User on Your Host.

  3. Create IAM Policies for Auto-Discovering the Entities

    See Allow Auto-Discovery of Entities and Log Collection.

  4. Provide the Permissions to Set Up Continuous Log Collection

    See Allow Continuous Log Collection Using Management Agents.

  5. Discover the entities

    1. Open the navigation menu and click Observability & Management. Under Logging Analytics, click Administration. The Administration Overview page opens.

    2. Click Entities from the list of available resources in the left menu.

      In the compartment selector on the left, select the compartment for the entities to be the same as that of the management agent used for discovery.

    3. Click Discover New Resource. The Resource Discovery dialog box opens in the Stack Monitoring service UI.

    4. Under Resource Type, select the type of Oracle resource you want to discover, for example, EBS.

      You can select from the resource types Apache Tomcat, EBS, Host, Microsoft SQL Server, Oracle Database, Oracle WebLogic Domain, Pluggable DB, and PSFT Application.

    5. Provide the inputs to complete the discovery. For the details of the inputs, see the table Discovery Input for your resource type in OCI Documentation: Stack Monitoring - User-initiated Discovery.

    6. Click Discover New Resource.

    At this point, the discovery process is initiated at the Management Agent and may take a few moments to complete.

  6. Associate the Entities with Log Sources

    See Configure New Source-Entity Association.

    In case of EBS, the following Oracle-defined sources are available:

    • EBS Concurrent Manager Logs
    • EBS Concurrent Request Logs
    • EBS Conflict Resolution Manager Logs
    • EBS Internal Concurrent Manager Logs
    • EBS Output Post Processor Logs
    • EBS Transaction Manager Logs
    • EBS Workflow Notification Mailer Logs
    • Oracle EBS Transaction Logs

    For the full list of Oracle-defined log sources, see Oracle-Defined Sources.

  7. View the Topology of Your Configuration

    See View the Topology of Your Entities.

At this point, the logs start flowing into Logging Analytics.

Allow Auto-Discovery of Entities and Log Collection

Task IAM Policy Statements

Provide MANAGE permission to the Logging Analytics user group for the resources in the family stack-monitoring-family

 ALLOW GROUP <user_group> TO MANAGE stack-monitoring-family IN COMPARTMENT <compartment_name>

Allow Logging Analytics user group to perform discovery tasks

ALLOW GROUP <user_group> TO {STACK_MONITORING_DISCOVERY_JOB_CREATE, STACK_MONITORING_DISCOVERY_JOB_READ, STACK_MONITORING_DISCOVERY_JOB_DELETE, STACK_MONITORING_DISCOVERY_JOB_INSPECT} IN COMPARTMENT <compartment_name>

Here, compartment_name is the name of the compartment used for discovery. This is the same as the compartment of the Management Agents installed for discovery.

Allow Management Agent dynamic group to upload discovery results to the service ALLOW DYNAMIC-GROUP <Management_Agent_Dynamic_Group> TO {STACK_MONITORING_DISCOVERY_JOB_RESULT_SUBMIT} IN COMPARTMENT <compartment_name>

Here, compartment_name is the name of the compartment of the Management Agents installed for discovery.