Skip Headers
Oracle® Fusion Applications Administrator's Guide
11g Release 1 (11.1.2)

Part Number E14496-03
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

10 Monitoring the Oracle Fusion Applications Middle Tier

This chapter describes how to monitor the middle tier using Oracle Enterprise Manager Fusion Applications Control (Fusion Applications Control) and Oracle Enterprise Manager (Cloud Control).

This chapter includes the following topics:

The procedures referenced in the Oracle Fusion Middleware guides describe using Fusion Middleware Control. These procedures also apply to Fusion Applications Control.

10.1 Introduction to Monitoring the Middle Tier

Both Oracle Enterprise Manager Fusion Applications Control (Fusion Applications Control) and Oracle Enterprise Manager Cloud Control (Cloud Control) automatically and continuously measure run-time performance. The performance metrics are automatically enabled; you do not need to set options or perform any extra configuration to collect them.

You can monitor the following aspects of the middle tier with this control:

You can also monitor a specific set of metrics for performance tuning information. With Cloud Control, you can also view historical data. See Section 10.5 for more specific information about usage of Cloud Control.

Use the following sections for specifics on using Fusion Applications Control:

Use the following sections for specifics on using Cloud Control:

10.2 Monitoring and Viewing Performance Status of Oracle Fusion Middleware

Monitoring the health of the underlying Oracle Fusion Middleware environment and ensuring that it performs optimally is an important task.

This section contains the following topics:

10.2.1 Viewing the General Status of Oracle Fusion Middleware Components for a Product Family

You can view the overall status of the underlying Oracle Fusion Middleware components from the home page of the product family.

To view the general status with either Fusion Applications Control or Cloud Control:

  1. Navigate to a product family home page:

    • From Fusion Applications Control, in the navigation pane, select the product family.

    • From Cloud Control:

      1. From the Targets menu, choose Fusion Applications.

        The Fusion Applications target home page displays.

      2. In the table on the Fusion Applications target home page, click the appropriate Product Family target.

  2. View the Applications and Infrastructure section. The following figure shows an example of the tab from Fusion Applications Control.

    Description of monitor_mid_tiergen.gif follows
    Description of the illustration monitor_mid_tiergen.gif

The pie charts in the Fusion Middleware section displays the percentage of Oracle Fusion Middleware components that are currently up or down.

10.2.2 Viewing the Detailed Status of Oracle Fusion Middleware Components for a Product Family

You can view the detailed status of Oracle Fusion Applications and Oracle Fusion Middleware components, including the Administration Server and the Managed Servers in the Oracle WebLogic Server domain and specific Oracle Fusion Middleware components.

To view detailed status with Oracle Fusion Middleware components:

  1. Navigate to a product family home page:

    • From Fusion Applications Control, from the navigation pane, select the product family.

    • From Cloud Control:

      1. From the Targets menu, choose Fusion Applications.

        The Fusion Applications target home page displays.

      2. In the table on the Fusion Applications target home page, click the appropriate Product Family target.

  2. From the Product Family menu, choose Applications and Infrastructure.

  3. From the Applications and Infrastructure page, click the Fusion Middleware tab.

    This tab shows the status of the various components, associated host, and the percentage of CPU that is being used the component. The following figure shows an example of the tab from Fusion Applications Control.

    Description of monitor_mid_tierfmw.gif follows
    Description of the illustration monitor_mid_tierfmw.gif

  4. Select a specific component to gain more insight.

    For example, if you select the Oracle WebLogic Server domain, Fusion Applications Control directs you to the domain home page. This page shows the following.

    • A general summary of the domain, along with a link to the Oracle WebLogic Server Administration Console

    • Information about the servers, both the Administration Server and the Managed Servers in the domain

    • Information about the clusters in the domain

    • Information about the deployments in the domain

10.2.3 Viewing the Routing Topology of Oracle Fusion Middleware

This section contains the following topics:

10.2.3.1 Viewing the Routing Topology of Oracle Fusion Middleware Using Fusion Applications Control

Fusion Applications Control provides a Topology Viewer for the farm. The Topology Viewer is a graphical representation of routing relationships across components and elements of the farm. You can easily determine how requests are routed across components.

The Topology Viewer enables you to easily monitor your Oracle Fusion Applications environment. You can see which entities are up and which are down.

You can also print the topology or save it to a .png file.

To view the topology with Fusion Applications Control:

  1. Click Topology.

    The Topology Viewer is displayed in a separate window.

  2. From the View menu, choose Routing: Group By Application to view the topology of applications or choose Routing: Group by Middleware to view the topology for the middleware.

  3. To see information about a particular target, place your mouse over the target. To view additional information, click More. The following figure shows additional information for the LedgerApp target.

    Description of topology.gif follows
    Description of the illustration topology.gif

  4. From the Options menu, you can save or print the image, expand or collapse all of the nodes, change the orientation of the topology to be left to right or top to bottom, or show and hide the routing navigator.

    In addition, you can refresh the status and the metrics or update the topology. To refresh the status and metrics, click Refresh Target Status and Metrics. To update the topology shown in the viewer, click Recreate Topology. If a target has been added or deleted, the target list and relationships are updated. This option also updates the status and metrics.

  5. With Topology Viewer, you can also:

    • Search for a target within the topology. This makes it easier to find a target if you have many targets. Enter the name in the Find box. The target is highlighted and the topology is repositioned so you can see the target if it was not previously visible in the viewing area.

      You can also specify criteria for the search. From Find, choose the one or more types of Status or one or more of Target Type, or both.

    • View the targets by status. Choose Up, Down, or Unknown from the Target Status at the top of the page.

    • Navigate to the home page of a target. Right-click the target, and choose Home.

    • Hide or show the status or metrics. From the Annotations menu, choose Status or Metrics.

      If you select Metrics, one key performance metric for the component is displayed. (You cannot change the metric that is displayed.)

    • View the routing relationships between components.

    • Perform operations directly on the target by right-clicking. The right-click target menu is displayed.

  6. To change what is visible in the topology view, drag the shaded section in the navigator window, which is located in the bottom right.

Notes:

  • If you use Mozilla Firefox, when you click an entity in Topology Viewer to take you back to the main Fusion Applications Control window, focus is not returned to the main window. For example, if you right-click an entity and choose logs from menu, the focus remains on the Topology Viewer window. (If you go back to the main window, the Logs page is correctly displayed.)

    To workaround this problem, make the following change in Firefox:

    From the Tools menu, choose Options, and then Content. Click Advanced. In the Advanced JavaScript Settings dialog box, select Raise and lower windows.

  • If you use Internet Explorer, turn off the Always Open Popups in New Tab option.

10.2.3.2 Viewing the Routing Topology of Oracle Fusion Middleware Using Cloud Control

See Section 9.11.

10.2.4 Viewing the Performance of an Oracle WebLogic Server

See the following resources in the Oracle Fusion Middleware Administrator's Guide to monitor the Oracle WebLogic Server:

For information on locating specific metrics to monitor, see Section 10.4.4.1.

10.2.5 Monitoring the System Performance of Oracle Fusion Applications Deployed to a Cluster

During installation, Oracle Fusion Applications automatically deploys each application to a Managed Server in a cluster. For each Managed Server in the cluster, there is an instance of the application on each Oracle WebLogic Server.

There are times when you want to monitor the system performance of the application on an individual server, and times when you want to monitor the overall performance of the application across all the servers in the cluster.

For example, normally, you would manage the overall performance of the application to determine if there are any performance issues affecting all users of the application, regardless of which instance users access. If you notice a performance problem, you can then drill down to a specific instance of the application to determine if the problem is affecting one or all of the application instances in the cluster. Cloud Control and Fusion Applications Control provides monitoring pages for both of these scenarios.

This section contains the following topics:

10.2.5.1 Monitoring the Performance of Oracle Fusion Applications Cluster Applications Using Fusion Applications Control

To monitor the overall performance of the Oracle Fusion Applications cluster applications with Fusion Applications Control:

  1. From the navigation pane, expand the product family, then Fusion Applications.

    Fusion Applications Control lists the applications deployed in the current domain, as shown in the following figure:

    Description of monitor_mid_navclus.gif follows
    Description of the illustration monitor_mid_navclus.gif

  2. Monitor the overall performance of the applications on a cluster by clicking the cluster application name, for example, PayablesApp.

    The Fusion Cluster Application page displays.

  3. View performance metrics. From the Fusion Cluster Application menu, choose Performance Summary.

    The Performance Summary page displays. For more information about using this page, see Section 2.5.7.

10.2.5.2 Monitoring the Performance of Oracle Fusion Applications Cluster Applications Using Cloud Control

To monitor the overall performance of the Oracle Fusion Applications cluster applications with Cloud Control:

  1. Navigate to a product family home page:

    1. From the Targets menu, choose Fusion Applications.

      The Fusion Applications target home page displays.

    2. In the table on the Fusion Applications page, click the appropriate Product Family target.

  2. From the navigation pane, expand Fusion Applications.

    Cloud Control lists the applications deployed in the current domain, as shown in the following figure:

    Description of monitor_mid_navcluscc.gif follows
    Description of the illustration monitor_mid_navcluscc.gif

  3. Monitor the overall performance of the applications on a cluster by clicking the cluster application name, for example, PayablesApp.

    The Fusion Cluster Application page displays.

  4. View performance metrics. From the Fusion Cluster Application menu, choose Monitoring > Performance Summary.

    The Performance Summary page displays. For more information about using this page, see the topic "Using Performance Summary" in the Cloud Control online help.

  5. From the Performance Summary page, you can optionally click on a metric name.

    The Additional Information dialog displays. From this dialog, you can view more details about the metric with the following links:

    • Problem Analysis: Directs to the Problem Analysis page. This page enables you to see a metric with other related metrics, which are affecting the metrics being analyzed. It also shows the related targets and the related targets topology. The Problem Analysis is only available for request-related metrics, such as the Request Processing Time (ms) and Request (per minute).

    • Analyze Logs: Displays a message that enables you to view the logs for a target on which the metric is viewed.

    • Metric Details: Enables you view historical metric data.

    • Target Home: Directs you to the home page.

    When used together, Problem Analysis and Analyze Logs can help you inspect metrics, target status information, and logs during troubleshooting. These links are not available for all metrics. For more information about these links, see Section 17.4.8.

10.2.5.3 Monitoring the Performance of Oracle Fusion Application Instances Using Fusion Applications Control

To monitor a specific instance of the application with Fusion Applications Control:

  1. From the navigation pane, expand the product family, then Fusion Applications.

  2. Expand the cluster application you want to monitor to show each instance of the application, as shown in the following figure:

    Description of monitor_mid_navcins.gif follows
    Description of the illustration monitor_mid_navcins.gif

  3. Monitor the overall performance of an application instance in cluster by clicking one of the application deployment instances, for example, PayablesApp (PayablesSever_1).

    The Fusion J2EE Application page displays.

  4. View performance metrics. From the Fusion J2EE Application menu, choose Performance Summary.

    The Performance Summary page displays. For more information about using this page, see Section 2.5.7.

10.2.5.4 Monitoring the Performance of Oracle Fusion Application Instances Using Cloud Control

To monitor a specific instance of the application with Cloud Control:

  1. Navigate to a product family home page:

    1. From the Targets menu, choose Fusion Applications.

      The Fusion Applications target home page displays.

    2. In the table on the Fusion Applications target home page, click the appropriate Product Family target.

  2. From the navigation pane, expand the product family, then Fusion Applications.

  3. Expand the cluster application you want to monitor to show each instance of the application, as shown in the following figure:

    Description of monitor_mid_navcinscc.gif follows
    Description of the illustration monitor_mid_navcinscc.gif

  4. Monitor the overall performance of an application instance in cluster by clicking one of the application deployment instances, for example, PayablesApp (PayablesSever_1).

    The Fusion J2EE Application page displays.

  5. View performance metrics. From the Fusion J2EE Application menu, choose Performance Summary.

    The Performance Summary page displays. For more information about using this page, see the topic "Using Performance Summary" in the Cloud Control online help.

  6. From the Performance Summary page, you can optionally click on a metric name.

    The Additional Information dialog displays. From this dialog, you can view more details about the metric with the following links:

    • Problem Analysis: Directs to the Problem Analysis page. This page enables you to see a metric with other related metrics, which are affecting the metrics being analyzed. It also shows the related targets and the related targets topology. The Problem Analysis is only available for request-related metrics, such as the Request Processing Time (ms) and Request (per minute).

    • Analyze Logs: Displays a message that enables you to view the logs for a target on which the metric is viewed.

    • Metric Details: Enables you view historical metric data.

    • Target Home: Directs you to the home page.

    When used together, Problem Analysis and Analyze Logs can help you inspect metrics, target status information, and logs during troubleshooting. These links are not available for all metrics. For more information about these links, see Section 17.4.8.

10.3 Monitoring System Performance Metrics for a Fusion Instance, Product Family, or a Product

If you encounter a problem, such as a product running slowly or hanging, you can view more detailed performance information, including aggregate system performance metrics for all the product families or an individual product family. You can also view metrics specific to a particular product, to find out more information about the problem. You can only view aggregate system performance metrics for all the product families with Cloud Control.

This section contains the following topics:

10.3.1 Monitoring System Performance Metrics for a Product Family or a Product with Fusion Applications Control

With Fusion Applications Control, you can view detailed aggregate system performance metrics for the product family or view metrics specific to a particular product.

To view the performance metrics for the product family with Fusion Applications Control:

  1. From the navigation pane, select the name of the product family.

  2. From the Product Family menu, choose System Performance Summary.

    The System Performance page displays. For more information about using this page, see Section 2.5.7.

To view the performance metrics for a particular product with Fusion Applications Control:

  1. From the navigation pane, expand the product family, then Products.

  2. Select the product you want to monitor.

  3. From the Product menu, choose System Performance Summary.

    The System Performance page displays. For more information about using this page, see Section 2.5.7.

10.3.2 Monitoring System Performance Metrics for a Fusion Instance, Product Family, or a Product with Cloud Control

With Cloud Control, you can view aggregate system performance metrics for all the product families by monitoring the Fusion instance or an individual product family. You can also view metrics specific to a particular product.

To view the performance metrics for the product family with Cloud Control:

  1. Navigate to a Fusion Instance, product family, or product home page:

    1. From the Targets menu, choose Fusion Applications.

      The Fusion Applications target home page displays.

    2. In the table on the Fusion Applications target home page, click the appropriate target, the instance for the Oracle Fusion Applications or product family. You can also expand a product family to select an individual product.

  2. From the Fusion Instance, Product Family, or Product menu, choose Monitoring > System Performance.

    The Performance Summary page displays. For more information about using this page, see the topic "Using Performance Summary" in the Cloud Control online help.

  3. From the Performance Summary page, you can optionally click on a metric name.

    The Additional Information dialog displays. From this dialog, you can view more details about the metric with the following links:

    • Problem Analysis: Directs to the Problem Analysis page. This page enables you to see a metric with other related metrics, which are affecting the metrics being analyzed. It also shows the related targets and the related targets topology. The Problem Analysis is only available for request-related metrics, such as the Request Processing Time (ms) and Request (per minute).

    • Analyze Logs: Displays a message that enables you to view the logs for a target on which the metric is viewed.

    • Metric Details: Enables you view historical metric data.

    • Target Home: Directs you to the home page.

    When used together, Problem Analysis and Analyze Logs can help you inspect metrics, target status information, and logs during troubleshooting. These links are not available for all metrics. For more information about these links, see Section 17.4.8.

10.4 Monitoring Performance for Key Oracle Fusion Middleware Components with Fusion Applications Control

Monitoring Oracle Fusion Middleware performance involves monitoring any Oracle WebLogic Server Managed Servers for a component and as available, performance metrics. The Oracle Fusion Middleware layer of Oracle Fusion Applications automatically and continuously measures run-time performance for middle tier components. Use Table 10-1 to find information on where to find related documentation for the main Oracle Fusion Middleware components in most Oracle Fusion Applications environments. As mentioned previously in this chapter, references to Fusion Middleware Control in the Oracle Fusion Middleware documents apply to Fusion Applications Control.

Table 10-1 Monitoring Oracle Fusion Middleware Components

Component Documentation

Oracle Business Intelligence Suite

Status of an Oracle WebLogic Server Managed Server for Oracle Business Intelligence Suite: "Monitoring an Oracle WebLogic Server Administration or Managed Server" section in the Oracle Fusion Middleware Administrator's Guide for instructions on accessing the server home page. Specifically, review the Summary section of the page.

Performance metrics: "Monitoring Service Levels" section in the Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition

Oracle Enterprise Content Management Suite, Content Server

Status of an Oracle WebLogic Server Managed Server for Content Server: "Monitoring an Oracle WebLogic Server Administration or Managed Server" section in the Oracle Fusion Middleware Administrator's Guide for instructions on accessing the server home page. Specifically, review the Summary section of the page.

Performance Metrics: "Viewing Performance Information for Oracle Content Server" section in the Oracle Fusion Middleware System Administrator's Guide for Oracle Content Server

Oracle Enterprise Crawl and Search Framework

Performance metrics: Section 10.4.1

Oracle Enterprise Scheduler Service

Status of an Oracle WebLogic Server Managed Server for Oracle Enterprise Scheduler: "Monitoring an Oracle WebLogic Server Administration or Managed Server" section in the Oracle Fusion Middleware Administrator's Guide for instructions on accessing the server home page. Specifically, review the Summary section of the page.

Performance metrics: Section 10.4.2.4 and Section 10.4.4.3

Oracle Identity Management, Oracle Access Manager

Status of an Oracle WebLogic Server Managed Server for Oracle Access Manager: "Monitoring an Oracle WebLogic Server Administration or Managed Server" section in the Oracle Fusion Middleware Administrator's Guide for instructions on accessing the server home page. Specifically, review the Summary section of the page.

Performance metrics: "Viewing Performance in Fusion Middleware Control" section in the Oracle Fusion Middleware Administrator's Guide for Oracle Access Manager with Oracle Security Token Service

Oracle Identity Management, Oracle Identity Manager

Status of an Oracle WebLogic Server Managed Server for Oracle Identity Management: "Monitoring an Oracle WebLogic Server Administration or Managed Server" section in the Oracle Fusion Middleware Administrator's Guide for instructions on accessing the server home page. Specifically, review the Summary section of the page.

Performance metrics: Section 10.4.3

Oracle Identity Management, Oracle Internet Directory

Status of an Oracle WebLogic Server Managed Server for Oracle Identity Management: "Monitoring an Oracle WebLogic Server Administration or Managed Server" section in the Oracle Fusion Middleware Administrator's Guide for instructions on accessing the server home page. Specifically, review the Summary section of the page.

Performance Metrics: "Monitoring Oracle Internet Directory" in the Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory

Oracle Identity Management, Oracle Virtual Directory

Status of an Oracle WebLogic Server Managed Server for Oracle Virtual Directory: "Monitoring an Oracle WebLogic Server Administration or Managed Server" section in the Oracle Fusion Middleware Administrator's Guide for instructions on accessing the server home page. Specifically, review the Summary section of the page.

Performance Metrics: "Monitoring Oracle Virtual Directory Using Fusion Middleware Control Metrics" in the Oracle Fusion Middleware Administrator's Guide for Oracle Virtual Directory

Oracle SOA Suite

Performance metrics: "Monitoring Processing Requests" section in the Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle Business Process Management Suite and Section 10.4.4.2

Oracle WebCenter

Status of an Oracle WebLogic Server Managed Server for Oracle WebCenter: "Monitoring an Oracle WebLogic Server Administration or Managed Server" section in the Oracle Fusion Middleware Administrator's Guide for instructions on accessing the server home page. Specifically, review the Summary section of the page.

Performance metrics: "Monitoring Oracle WebCenter Performance" section in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter

Oracle Web Tier, Oracle HTTP Server

Performance metrics: "Monitoring Oracle HTTP Server Performance" section in the Oracle Fusion Middleware Administrator's Guide for Oracle HTTP Server

Oracle WebLogic Server

Section 10.2.4 and Section 10.4.4.1


The section contains the following topics:

10.4.1 Monitoring Oracle Enterprise Crawl and Search Framework

Fusion Applications Control automatically and continuously measures the runtime performance of Oracle Enterprise Crawl and Search Framework. If you encounter a problem, you can view the performance metrics to find out more information about the problem.

To monitor performance metrics for Oracle Enterprise Crawl and Search Framework with Fusion Applications Control:

  1. From the navigation pane, expand Enterprise Crawl and Search Framework.

  2. Select the Oracle Enterprise Crawl and Search Framework application for the product family.

  3. From the Enterprise Crawl and Search Framework menu, choose Performance Summary to view detailed performance metrics.

    The Performance Summary page displays. For more information about using this page, see Section 2.5.7.

10.4.2 Monitoring the Performance of a Single Oracle Enterprise Scheduler Instance

You can monitor the performance of an Oracle Enterprise Scheduler instance, specifically current and historical performance data, as well as a summary of all performance data. Performance data displays in a chart set, which you save, delete and reorder. Additionally, you can modify the time period for which performance data displays.

This section contains the following topics:

10.4.2.1 Viewing a Summary of Oracle Enterprise Scheduler Activity

The Oracle Enterprise Scheduler Performance Summary page displays current charts of job requests such as requests completed per hour, running requests, requests by processing time and requests by status.

To view a summary of Oracle Enterprise Scheduler activity:

  1. From the Scheduling Service menu, choose Performance > Service Summary.

    By default, this page displays job requests running during a selected time period in the following categories:

    • Requests completed per hour

    • Processing times, average, minimum and maximum

    • Running requests and maximum running requests

    • Requests over the past hour with the status SUCCESS, WARNING, ERROR or CANCEL.

    You can change the metrics displayed on the Service Summary performance page. Click the Show Metric Palette button to display the metric palette for Oracle Enterprise Scheduler.

  2. You can change the duration for which performance data display.

  3. Optionally, you can change the display format of performance data on the page.

    Choose View > Grid to remove the grid display format from the charts.

    Click the Table View link to display the performance data in table format.

  4. You can overlay an additional scheduler service over the current service performance metrics.

    1. Choose Overlay > Another Scheduler Service.

      In the Search and Select: Targets window, enter the name of the target and host server and click Go to search for the relevant service.

    2. From the search results table, select the relevant service and click Select to choose the scheduler service to overlay.

  5. Additionally, you can take any of the following actions.

10.4.2.2 Viewing Current Oracle Enterprise Scheduler Activity

The Oracle Enterprise Scheduler Current Activity page displays pending and running requests by user and application.

To view current Oracle Enterprise Scheduler activity:

  1. From the Scheduling Service menu, choose Performance > Current Activity.

  2. You can view pending and running requests by user or application, or workload by work assignment.

    To view pending and running requests by user, choose View > Requests By User.

    To view pending and running requests by application, choose View > Requests By Application.

    To view workloads by work assignment, choose View > Workload By Work Assignment. For more information about work assignment details, see Section 5.11.1.1.

10.4.2.3 Viewing Historical Oracle Enterprise Scheduler Reports

The Oracle Enterprise Scheduler Historical Reports page displays completed job requests by user, application and work assignment.

To view historical Oracle Enterprise Scheduler reports:

  1. From the Scheduling Service menu, choose Performance > Historical Reports.

  2. From the View list, choose one of the following report views:

    • Completed Request Statistics By Job Name

    • Completed Request Statistics By User

    • Request Metrics By Work Assignment

    • Completed Request Statistics

  3. Adjust the filter criteria as required. The filter criteria vary depending on the report view you choose.

    Table 10-2 Completed Request Statistics by Job Name

    Filter Criterion What to Do...

    Application

    From the list, choose the application whose statistics you want to view.

    Minimum Run Time

    Enter the shortest run time period for jobs whose statistics you want to view. Use the text field to enter a number, and select a unit of time from the list: Seconds, Minutes, Hours or Days.

    Completed between

    Use the calendar icons on either side of the text fields to select a start and end date and time.


    Table 10-3 Completed Request Statistics by User

    Filter Criterion What to Do...

    Application

    From the list, choose the application whose statistics you want to view.

    Minimum Total Run Time

    Enter the shortest total time period for jobs whose statistics you want to view. Use the text field to enter a number, and select a unit of time from the list: Seconds, Minutes, Hours or Days.

    Completed between

    Use the calendar icons on either side of the text fields to select a start and end date and time.


    Table 10-4 Request Metrics By Work Assignment

    Filter Criterion What to Do...

    Application

    From the list, choose the application whose statistics you want to view.

    Completed after

    Use the calendar icon to choose the date and time after which the work assignment has completed.


    Table 10-5 Completed Request Statistics

    Filter Criterion What to Do...

    Application

    From the list, choose the application whose statistics you want to view.

    Completed between

    Use the calendar icons on either side of the text fields to choose a start and end date and time.


  4. Click Go to search for and display the historical data.

10.4.2.4 Viewing Oracle Enterprise Scheduler Metrics

You can view performance metrics for specific components of Oracle Enterprise Scheduler. Each set of metrics displays performance data that is relevant to the component.

To view Oracle Enterprise Scheduler performance metrics:

  1. From the Scheduling Service menu, choose Performance > Service Summary.

  2. Click Key Performance Indicators.

  3. Click Show Metric Palette and select the metrics you want to display for each component.

10.4.2.5 Managing Chart Sets

You can save or delete the chart set displayed in the Oracle Enterprise Scheduler Performance Summary page. You can also re-organize the order of a chart and revert to an old chart set.

This section contains the following topics:

10.4.2.5.1 Saving a Chart Set

You can save the chart set displayed in the Oracle Enterprise Scheduler Performance Summary page. Saving a chart set allows preserving a specific set of metrics selected for display, as opposed to the default metrics.

To save a chart set:

  1. Display the Oracle Enterprise Scheduler Performance Summary page.

  2. Choose View > Save Chart Set.

  3. In the Save Chart Set dialog box, enter a name for the chart set and click OK.

  4. Once you have saved the chart set, you can display it by choosing Chart Set > My Chart Set.

10.4.2.5.2 Deleting a Chart Set

You can delete saved chart set files created in the Oracle Enterprise Scheduler Performance Summary page.

To delete a chart set:

  1. Display the Oracle Enterprise Scheduler Performance Summary page.

  2. Choose View > Delete Chart Sets.

  3. In the Delete Chart Sets dialog box, select the name of the chart set to be deleted and click OK.

10.4.2.5.3 Reordering Charts

You can organize the display of performance charts in the Oracle Enterprise Scheduler Performance Summary page. Charts can be moved up or down, or removed entirely.

To reorder chart sets:

  1. Display the Oracle Enterprise Scheduler Performance Summary page.

  2. Choose View > Reorder Charts.

  3. In the Reorder Charts popup window, select the chart you want to move and click Move Up or Move Down, respectively.

    To delete a chart from the Performance Summary page, select the chart and click Delete.

  4. Click OK.

10.4.2.5.4 Reverting to an Old Chart Set

If you have re-organized your chart sets, you can can revert to the chart set as you had originally saved it.

To revert chart sets:

  1. Display the Oracle Enterprise Scheduler Performance Summary page.

  2. From the Chart Set list, choose the chart you want to revert to its original display.

  3. Choose View > Revert Chart Set.

10.4.2.6 Selecting the Performance Time Period

In the Oracle Enterprise Scheduler Performance Summary page, you can change the time period for which the performance summary displays.

To select the performance time period:

  1. Display the Oracle Enterprise Scheduler Performance Summary page.

  2. Change the duration for which job requests display.

    • All: Click to display all job requests within a specified, finite period.

    • 2 hours: Click to display all job requests within the past two hours.

    • 15 minutes: Click to display all job requests within the past fifteen minutes.

    • Slider: Click to display a slider that enables scrolling horizontally to show job requests from a specified period. The slider defaults to whichever time segment is selected, all, 2 hours, or 15 minutes.

    • Calendar: Click the calendar icon to select a time period for which you want to display job requests.

10.4.3 Monitoring Oracle Identity Manager Performance Metrics

To monitor performance metrics for Oracle Identity Manager with Fusion Applications Control:

  1. From the navigation pane, expand Identity and Access and OIM.

  2. Select the Oracle Identity Management server.

  3. From the Oracle Identity Management home page, view the overall metrics.

  4. From the Oracle Identity Manager menu, choose Performance Summary to view detailed performance metrics.

    The Performance Summary page displays. For more information about using this page, see Section 2.5.7.

10.4.4 Locating Key Performance Metrics for Specific Components

For each component in the Oracle Fusion Applications environment, there are performance metrics. This section helps you locate the key performance metrics related to software monitoring and configuration.

This section contains the following topics:

10.4.4.1 Monitoring Key Performance Metrics for Oracle WebLogic Server

Use Table 10-6 to locate the key performance metrics for Oracle WebLogic Server.

Table 10-6 Oracle WebLogic Server Key Performance Metrics

Category Metric Name Location in Fusion Applications Control

JMS

Messages Pending

Messages Received

  1. From the navigation pane, expand the farm, then WebLogic Domain, and then the domain.

  2. Expand the Managed Server.

    The Managed Server home page displays.

  3. From the WebLogic Server menu, choose Performance Summary.

  4. From the Performance Summary page, click Show Metric Palette.

  5. From the Metric Palette, expand the JMS Server Metrics folder.

  6. Select the metrics to view the charts.

JDBC

Available Connections

Connection Leaks (per minute)

Connection Pool Size

Connection Requests (per minute)

Connections Requests Waiting

Connections in Use

  1. From the navigation pane, expand the farm, then WebLogic Domain, and then the domain.

  2. Expand the Managed Server.

    The Managed Server home page displays.

  3. From the WebLogic Server menu, choose Performance Summary.

  4. From the Performance Summary page, click Show Metric Palette.

  5. From the Metric Palette, expand the Datasource Metrics folder.

  6. Select the metrics view the charts.

JVM Memory

Heap Usage (MB)

Non Heap Usage (MB)

  1. From the navigation pane, expand the farm, then WebLogic Domain, and then the domain.

  2. Expand the Managed Server.

    The Managed Server home page displays.

  3. From the WebLogic Server menu, choose JVM Performance.

  4. In the Memory section, view the charts.

JVM Garbage Collections

Collections (per minute)

  1. From the navigation pane, expand the farm, then WebLogic Domain, and then the domain.

  2. Expand the Managed Server.

    The Managed Server home page displays.

  3. From the WebLogic Server menu, choose JVM Performance.

  4. In the Memory section, view the Collections (per minute) in the Garbage Collectors table.

 

Heap Usage (%)

  1. From the navigation pane, expand the farm, then WebLogic Domain, and then the domain.

  2. Expand the Managed Server.

    The Managed Server home page displays.

  3. From the WebLogic Server menu, choose Performance Summary.

  4. From the Performance Summary page, click Show Metric Palette.

  5. From the Metric Palette, expand the JVM Metrics folder.

  6. Select the metric to view the chart.

Oracle WebLogic Server

CPU Usage (%)

Active Threads

  1. From the navigation pane, expand the farm, then WebLogic Domain, and then the domain.

  2. Expand the Managed Server.

    The Managed Server home page displays.

  3. From the WebLogic Server menu, choose Performance Summary.

  4. From the Performance Summary page, click Show Metric Palette.

  5. From the Metric Palette, expand the JVM Metrics folder.

  6. Select the metric to view the chart.

 

Deadlocked Threads

  1. From the navigation pane, expand the farm, then WebLogic Domain, and then the domain.

  2. Expand the Managed Server.

    The Managed Server home page displays.

  3. From the WebLogic Server menu, choose Performance Summary.

  4. From the Performance Summary page, click Show Metric Palette.

  5. From the Metric Palette, expand the JVM Threads folder.

  6. Select the metric to view the chart.

 

Threads

  1. From the navigation pane, expand the farm, then WebLogic Domain, and then the domain.

  2. Expand the Managed Server.

    The Managed Server home page displays.

  3. From the WebLogic Server menu, choose JVM Performance.

  4. View the thread metrics in the Threads section.

Server Work Manager

Work Manager Pending Requests

Work Manager Requests (per minute)

Work Manager Stuck Threads

  1. From the navigation pane, expand the farm, then WebLogic Domain, and then the domain.

  2. Expand the Managed Server.

    The Managed Server home page displays.

  3. From the WebLogic Server menu, choose Performance Summary.

  4. From the Performance Summary page, click Show Metric Palette.

  5. From the Metric Palette, expand the Work Manager folder.

  6. Select the metrics to view the charts.


10.4.4.2 Monitoring Key Performance Metrics for Oracle SOA Suite

Use Table 10-7 to locate the key performance metrics for Oracle SOA Suite.

Table 10-7 Oracle SOA Suite Key Performance Metrics

Metric Name Location in Fusion Applications Control

Audit Trail Threshold (for BPEL)

  1. From the navigation pane, expand SOA and then soa-infra.

  2. From the SOA Infrastructure menu, choose SOA Administration > BPEL Properties.

  3. From the BPEL Service Engine Properties page, view the Audit Trail Threshold.

From the BPEL Service Engine Properties page, adjust the Audit Trail Threshold to bolster BPEL engine performance and avoid performance overheads of capturing audit information. From the Audit Level list, you can also level of information collected by the instance tracking infrastructure.

Composite-level rate metrics

  1. From the navigation pane, expand SOA and then soa-infra.

  2. Expand the partitions.

  3. Select a specific SOA composite application.

  4. From the SOA Composite menu, choose Monitoring > Performance Summary.

  5. From the BPEL Service Engine Properties page, view the Audit Trail Threshold.

Dispatcher System Threads

Dispatcher Invoke Threads

Dispatcher Engine Threads (for BPEL)

  1. From the navigation pane, expand SOA and then soa-infra.

  2. From the SOA Infrastructure menu, choose SOA Administration > BPEL Properties.

  3. From the BPEL Service Engine Properties page, view the settings for Dispatcher System Threads, Dispatcher Invoke Threads, and Dispatcher Engine Threads.

Adjust these thresholds when the response-time is high.

Tune the thread configuration to either increase or decrease the number depending upon the BPEL engine processing requirement.

Average Request Processing Time (synchronous requests)

Average Request processing time (asynchronous requests)

  1. From the navigation pane, expand SOA and then soa-infra.

  2. From the SOA Infrastructure menu, choose Monitoring > Request Processing.

  3. From the Request Processing page, in the Service Engines and Service Infrastructure sections, view the Average Request Processing Time - Synchronous Requests and the Average Request Processing Time - Asynchronous Requests columns.

Audit trail

  1. From the navigation pane, expand SOA and then soa-infra.

  2. Expand the partitions.

  3. Select a specific SOA composite application.

  4. In the Oracle SOA Composite page, in the Recent Instances section, select an instance.

  5. In the Flow Trace window, select a component instance in the Trace section.

    The audit trail for the instance displays.

State (for a BPEL instance)

  1. From the navigation pane, expand SOA and then soa-infra.

  2. Expand the partitions.

  3. Select a specific SOA composite application.

  4. In the Oracle SOA Composite page, in the Component Metrics section, select a BPEL instance.

  5. In the BPEL Component page, in the Recent Instances table, view the State column.

State (for an Oracle Mediator instance)

  1. From the navigation pane, expand SOA and then soa-infra.

  2. Expand the partitions.

  3. Select a specific SOA composite application.

  4. In the Oracle SOA Composite page, in the Component Metrics section, select an Oracle Mediator instance.

  5. In the Mediator Component page, in the Recent Instances table, view the State column.


10.4.4.3 Monitoring Key Performance Metrics for Oracle Enterprise Scheduler

Use Table 10-8 to locate the key performance metrics for Oracle Enterprise Scheduler.

Table 10-8 Oracle Enterprise Scheduler Key Performance Metrics

Metric Name Location in Fusion Applications Control

Number of active processor threads for each instance

  1. From the navigation pane, expand Scheduling Services.

  2. Select the Oracle Enterprise Scheduler component.

  3. From the Scheduling Service menu, choose Performance > Current Activity.

  4. From the View list, choose Workload by Work Assignment.

  5. In the Work Assignments with active Workshifts report, view the Thread Allocation columns.

Processing Time (for jobs)

Wait Time

  1. From the navigation pane, expand Scheduling Services.

  2. Select the Oracle Enterprise Scheduler component.

  3. From the Scheduling Service menu, choose Performance > Historical Reports.

  4. In the Historical Reports page, from the View list, choose Request Metrics By Work Assignment.

  5. In the Results section, view the Wait Time and Processing Time columns.

Job running time

  1. From the navigation pane, expand Scheduling Services.

  2. Select the Oracle Enterprise Scheduler component.

  3. From the Scheduling Service home page, in the Top 10 Long Running Request tab, select a job.

  4. In the Request Detail page, under Execution Trail, view the Run Time metric.


10.5 Performing Proactive Performance Monitoring with Cloud Control

Managing applications and the underlying middleware technology can be difficult and IT organizations often have to rely on a variety of specialized tools. This can lead to inefficiency and may introduce complexities and risks.

Cloud Control enables you to discover middleware targets. To access these pages, see the following topic:

In addition to drilling down to specific targets for performance metrics, Oracle recommends the following best practices:

10.5.1 Monitoring Middle Tier Targets

After you have added a middle tier target through discovery, you can view general information about the targets, including their status and availability on the Middleware page. You can select a specific type of target, such as Oracle WebLogic Server domain, to narrow the view. You then can drill down into each target to get further details like how the target is performing, where it is deployed, the version, location of its home directory, and so on.

You can also view the number of critical, warning, and error alerts generated for the past 24 hours. These alerts indicate that a particular metric condition has been encountered. For example, an alert is triggered when a metric threshold is reached. Using these details, you can drill down to investigate the target and the problem that triggered the alert.

You can also use Cloud Control to monitor performance metrics as a current real time value (30 seconds, 1 minute, or 5 minutes) or a previous value (past 24 hours, 7 days, or 31 days). The historical information is displayed as graphs and a table. By using graphs, you can easily watch for trends, and by using tables, you can examine details of past metric severity history.

Figure 10-1 shows the Middleware target home page.

Figure 10-1 Middleware Target Home Page of Cloud Control

Description of Figure 10-1 follows
Description of "Figure 10-1 Middleware Target Home Page of Cloud Control"

To access the Middleware target home page in Cloud Control:

  1. From the Targets menu, choose Middleware.

  2. From the Search area, click Advanced Search.

  3. From the Type list, choose a specific target type to monitor, and then click Search. For example, you select the Oracle WebLogic Domain target.

For more information about discovering targets, see Section 2.7.1 and the chapters in the "Managing Oracle Fusion Middleware" part in the Oracle Enterprise Manager Getting Started with Fusion Middleware Management.

10.5.2 Creating Monitoring Templates

Monitoring templates simplify the task of setting up monitoring for large numbers of targets by allowing you to specify the monitoring and policy settings once and applying them as often as needed. You can save, edit, and apply these templates across one or more targets or groups. A monitoring template is specified for a particular target type and can only be applied to targets of the same type. For example, you can configure a monitoring template for Oracle WebLogic Server domains.

To create a monitoring template from Cloud Control:

  1. From the Enterprise menu, choose Monitoring > Monitoring Templates to access the Monitoring Templates main page.

  2. Modify a pre-built monitoring template, or create a new template without any data from another template:

    To modify a pre-build monitoring template:

    1. In the Template Name field, enter Fusion Apps or FMW.

    2. Click option Display Oracle provided templates and Oracle Certified templates.

    3. Click Go.

    4. From the table, select the template, and click Edit.

    To create a new template, click Create.

  3. Fill out the tabs accordingly.

    In the Metric Threshold tab, select the metrics to add to the template. Use the tables in the section for tips on recommended metrics to add to the template.

Use Table 10-9 to help add metrics for the Host target type to a monitoring template.

Table 10-9 Target Type: Host

Metric Category Metric Name Warning Threshold

CPU Usage

CPU System Time (%)

 
 

CPU Utilization (%)

 

Filesystems

Filesystem Space Available (%)

<80 %

Load

CPU in System Mode (%)

<20 %

 

CPU Utilization (%)

<85%

 

Logical Free Memory (%)

<20 %

 

Run Queue Length (1 minute average)

<2

 

Memory Utilization (%)

 
 

Swap Utilization (%)

 
 

Total Processes

<15000

Network Interfaces

Network Interface Total I/O Rate (MB/sec)

 
 

Network Interface Total Error Rate (%)

<1%

Network Interfaces Summary

All Network Interfaces Combined Utilization (%)

<80%

Disk Activity

Average Disk I/O Service Time (ms)

 
 

Average Disk I/O Wait Time (ms)

 
 

Disk Device Busy (%)

<95%

Switch/Swap Activity

Total System Swaps per second)

>3


Use Table 10-10 to help add metrics for the Oracle Access Manager Cluster target type to a monitoring template.

Table 10-10 Target Type: Oracle Access Manager

Metric Category Metric Name Warning Threshold Critical Threshold

Oracle Access Manager Cluster

     

Response

Status

   

Authentications (Aggregated)

Authentication Requests per second

   
 

Authentication Success Failure Ratio

   
 

Average Authentication Latency

   

OAM Application Domains

Application Authentication Requests per second

   
 

Application Authentication Success Rate (%)

   
 

Application Authorization Requests per second

   
 

Application Authorization Success Rate (%)

   

Oracle Access Manager Server

     

Response

Status

   

Resource Utilization

CPU Utilization (%)

80

90

 

Memory Utilization (%)

80

90

Authentications (Aggregated)

Authentication Requests/sec

   
 

Authentication Success Failure Ratio

   
 

Average Authentication Latency

   

Authorizations (Aggregated)

Application Authentication Requests/sec

   
 

Application Authentication Success Failure Ratio

   
 

Application Authorization Requests/sec

   
 

Application Authorization Success Failure Ratio

   

OAM Application Domains

Application Authentication Requests per second

   
 

Application Authentication Success Rate (%)

   
 

Application Authorization Requests per second

   
 

Application Authorization Success Rate (%)

   

Use Table 10-11 to help add metrics for the Oracle Enterprise Scheduler target type to a monitoring template.

Table 10-11 Target Type: Oracle Enterprise Scheduler

Metric Category Metric Name

Scheduler Service

 

Request Processor Metrics

Errored Requests over last hour

 

Average Elapsed Time (ms)

 

Blocked Requests

WorkAssignment Metrics aggregated across Group Members

Ready Requests

 

Average Wait Time for Requests in Ready State (seconds)

 

Errored Requests over last collection interval

Running Requests Summary by Job Definition

Longest Running Request Id

Requests that Need Recovery

Requests that need Manual Recovery

 

Timed-out Requests

Response

Status

Scheduler Service Group

 

Request Processor Metrics

Errored Requests over last hour

 

Blocked Requests

WorkAssignment Metrics aggregated across Group Members

Ready Requests

 

Average Wait Time for Requests in Ready State (seconds)

 

Errored Requests over last collection interval

Running Requests Summary by Job Definition

Longest Running Request Id

Requests that Need Recovery

Requests that need Manual Recovery

 

Timed-out Requests

Response

Status


Use Table 10-12 to help add metrics for the Oracle HTTP Server target type to a monitoring template.

Table 10-12 Target Type: Oracle HTTP Server

Metric Category Metric Name

OHS Server Metrics

Busy Threads (%)

 

Request Processing Time (seconds)

 

Response Data Processed (KB per response)

OHS Virtual Host Metrics

Request Processing Time for a Virtual Host (seconds)

 

Response Data Processed for a Virtual Host (KB per response)

OHS Response Code Metrics

HTTP 4xx errors

 

HTTP 5xx errors

Resource Usage

CPU Usage (%)

 

Memory Usage (%)


Use Table 10-13 to help add metrics for the Oracle Identity Manager target type to a monitoring template.

Table 10-13 Target Type: Oracle Identity Manager

Metric Category Metric Name Warning Threshold Critical Threshold

Oracle Identity Manager Cluster

     

Provisioning Requests

Completed Provisioning Requests

   
 

Failed Provisioning Requests

   

Reconciliations (Last 24 Hours)

Jobs Completed

   

Response

Status

   

Role Grant Requests

Completed Role Grant Requests

   
 

Completed Role Grant Requests Processing Time (per sec)

   
 

Failed Role Grant Requests

   
 

Pending Role Grant Requests

   

Self Service Requests

Completed Self Service Requests

   
 

Completed Self Service Requests Processing Time (per sec)

   
 

Failed Self Service Requests

   
 

Pending Self Service Requests

   

Oracle Identity Manager Server

     

Response

Status

   

Resource Utilization

CPU Utilization (%)

80

90

 

Memory Utilization (%)

80

90

Adapters

Average Adapter Execution Time (ms)

   
 

Completed Adapter Executions

   
 

Maximum Adapter Execution Time (ms)

   
 

Minimum Adapter Execution Time (ms)

   

Use Table 10-14 to help add metrics for the Oracle Internet Directory target type to a monitoring template.

Table 10-14 Target Type: Oracle Internet Directory

Metric Category Metric Name Warning Threshold Critical Threshold

LDAP Operation Response Time

Bind Operation Response Time

   
 

Request Processing Time (ms)

   

LDAP Server Resource Usage

Total CPU Usage (%)

80

90

 

Total Memory Usage (%)

80

90

Response

Status

   

(Critical Events) System Resource Events (3113 Errors)

Number of 3113 Error Occurrences

   

(Critical Events) System Resource Events (3114 Errors)

Number of 3114 Error Occurrences

   

LDAP Failed Bind Operations Profile

Failed Bind Operations

   

LDAP Server Resource Usage

Completed Bind Operations

   
 

Completed Compare Operations

   
 

Completed Modify Operations

   
 

Completed Search Operations

   
 

Total Operations

   

User LDAP Operations Statistics

Failed Base Search Operations

   
 

Failed Bind Operations

   
 

Failed Compare Operations

   
 

Failed Delete Operations

   
 

Successful Base Search Operations

   

To enable the collection of user LDAP Operation Statistics, edit the configuration using Fusion Applications Control:

  1. From the navigation pane, expand the farm and then the Oracle Internet Directory target.

  2. From the Administration menu, choose Server Properties.

  3. Click User Statistics Collection to enable this feature.

  4. Click Apply to save your changes.

  5. From the Administration menu, choose Shared Properties.

  6. Enter a valid DN (for example, cn=orcladmin) to enable user statistics collection for that user.

Use Table 10-15 to help add metrics for the SOA Composite target type to a monitoring template.

Table 10-15 Target: SOA Composite

Metric Category Metric Name

Mediator Case

Invocation count throughput in last 5 minutes

SOA Composite - Response Metrics

Composite Status

SOA Composite - Component Detail Metrics

Component: Business Faults

 

Component: Error Rate (%)

SOA Composite - Services/References Detail Metrics

Service/Reference: Average Incoming Messages Processing Time (ms)

 

Service/Reference: Average Outbound Messages Processing Time (ms)

 

SOA Composite: Error Rate (%)

 

SOA Composite: Synchronous Response Time (ms)

 

SOA Composite: Total Business


Use Table 10-16 to help add metrics for the SOA Infrastructure target type to a monitoring template.

Table 10-16 Target: SOA Infrastructure

Metric Category Metric Name

SOA Infra Response

Up Down Status

SOA Infrastructure - Message Detail Metrics

Errors (minute)

SOA Infrastructure - Service Engine Detail Metrics

Service Engine: Error Rate (%)


Use Table 10-17 to help add metrics for the Oracle WebLogic Server target type to a monitoring template.

Table 10-17 Target: Oracle WebLogic Server Metrics

Metric Category MetricName Warning Threshold Critical Threshold

Datasource Metrics

Connections in Use

>250

>400

 

Connection Requests that Waited (%)

>10%

>20%

 

Connection Creation Time (ms)

   

JVM Garbage Collectors

Garbage Collector - Percent Time spent (elapsed)

>10%

>20%

JVM Metrics

Heap Usage

>90%

>98%

Response

Status

 

=Down

Server Servlet/JSP Metrics

Request Processing Time (ms)

>10s

>15s

Server Work Manager Metrics

Work Manager Stuck Threads

>5

>10

JVM Threads

Deadlocked Threads

>2

>5

Module Metrics By Server

Active Sessions

   

10.5.3 Creating Blackouts

Blackouts allow you to suspend collection of metrics on a target when performing scheduled maintenance on the target. Blacking out a target suspends monitoring on the target for the duration of the blackout. Blackouts are named entities that mainly consist of a list of targets that participate in the blackout and the schedule that defines when the blackout is in effect. Blackouts may be defined on a single target or on aggregate targets such as groups, hosts, systems, or web applications.

To create a blackout from Cloud Control:

  1. From the Enterprise menu, choose Monitoring > Blackouts to access the Blackouts main page.

  2. From the table, click Create.

    Cloud Control displays a wizard page to guide you through the steps required to create a blackout. Click Help from any wizard page for more information on specific steps.

10.5.4 Setting Up Notifications

You can associate corrective actions with metrics whose alerts trigger them.

To register corrective actions for these notifications from Cloud Control, From the Setup menu, choose Notifications > Notification Methods access the Notifications Methods page.

See the "Notifications" chapter in the Oracle Enterprise Manager Cloud Control Administrator's Guide to complete the configuration.

10.6 Tuning Middle Tiers for Oracle Fusion Applications

One of the most challenging aspects of performance tuning is knowing where to begin. Start with the following documentation resources: