Understanding the Regions of the Oracle Java Cloud Service - SaaS Extension Control Home Page

The Oracle Java Cloud Service - SaaS Extension Control home page provides statistics on performance, data sources, response and load, using Oracle Java Cloud Service - SaaS Extension jobs, applications, and resource usage.

The metrics shown represent the most recent values available. For all "per minute" statistics, they are per minute in the last five minutes.

The Oracle Java Cloud Service - SaaS Extension Control page is made up of the following regions:

Region Description

Restart Service

If the Oracle Java Cloud Service - SaaS Extension instance somehow reaches an inconsistent state, for example, due to a network error, you can use the Restart Service option to restart the service, which will restart all the managed nodes in the service's domain.

See Restarting a Java Service Instance.

Performance Summary

Displays usage metrics for a single Oracle Java Cloud Service - SaaS Extension. All metrics represent the most recent values available. The metric descriptions are:

General

  • Service Version - the version number of the running Oracle Java Cloud Service - SaaS Extension.

  • Customer Disk Usage - the amount of disk space, in megabytes, the customer has consumed.

Servlets and JSPs

  • Active Sessions - Number of active sessions

  • Request Processing Time (ms) - Time spent processing each request.

  • Requests (per minute) - Average number of invocations per minute of the selected servlet or JSP in the last five minutes

JDBC Usage

  • Open JDBC Connections - Number of JDBC (Java Database Connectivity) connections currently in use

  • JDBC Connection Creates (per minute) - Number of database connections created per minute in the last five minutes

You can also download your service-specific log files using the View Log Messages link. Clicking this link takes you to the Log Messages page. This page display the log messages based on the search criteria which you provided.

See Viewing the Service and Application Logs.

Data Sources

Identifies the data sources accessed by the service.

Response and Load

Use this region to review the response and load charts associated with each server in the Java service. Using this data, you can determine if the servers are behaving as expected, if any server is overloaded, or if a server is taking too long to respond and load.

If a server is overloaded or taking too long to respond and load, request an upgrade (add more servers) or ask the Cloud administrator to restart your servers if they are performing poorly.

Jobs

The Jobs region shows the jobs submitted for this service and the status for each of these jobs. You can also get additional details (view logs) for each of these jobs.

Click an Activity ID and select View Activity Logs. For a typical deploy job, there are five logs: Virus Scan, Application Whitelist Validation, WLS Compile, Cloud Compile, and Deploy Application. These logs are text documents that you can either open or save. These logs are the result of background jobs that ran against the application and determined whether the application contains a virus or could otherwise cause problems.

If a deploy job fails, the best course of action is to view the logs for the job. Depending on the different job logs available, you can determine where the failure occurred.

If there are Java API validations, the Whitelist Validation may not reject the application from being deployed. Instead, it would create a warning report against the violations.

You can refresh the Jobs region using the Refresh control located at the top right of the region. This is useful when you have just submitted a job and you want to see if the status has changed. By default, the refresh control is set to manual. You can change it to auto-refresh using the available time intervals.

See Viewing the Activity Logs.

Applications

Use this region to see the list of applications available for this service. To study the statistics associated with a particular application and to view its log files, click the name of the application.

  • View

    By using the View list, you can conveniently choose the columns to be displayed in the table.

    To test an application, click the Test Application icon associated with the application. This launches a dialog containing a list of URLs from which you can access the application. Click a given URL and the application appears in a new window.

  • Deploy New

    Once your application is ready for use, you can upload the application for deployment. The application goes through a number of checks to ensure compliance with Oracle standards. These checks include a virus scan and a whitelist validation.

    After the application passes these tests, deployment of the application begins. Note that deployment is asynchronous. You will be prompted to verify the status of the job submitted for deployment.

    You can check the status of the deployment by manually refreshing the Jobs table at the bottom of the page. You can also use the control on the top right corner of the table to set the auto-refresh interval for the table.

    Note: The welcome-app is pre-deployed to each service instance. It provides links to the SDK documentation, samples, blogs, and white papers, and more.

  • Delete Application

    When an application is no longer of value, delete it from the Oracle Java Cloud Service - SaaS Extension Control.

  • Redeploy

    Use this option when you upgrade or make changes to an application.

  • Start and Stop

    You can easily start and stop an application. Use these options after you have deployed the application.

    Note: If these applications are exposed to your external users, you need to inform these users of potential downtime when you stop the application.

See Managing Applications.

Libraries

Use this region to see the list of libraries available for this service.

  • View

    By using the View list, you can conveniently choose the columns to be displayed in the table.

  • Deploy New

    Once your library is ready for use, you can upload the library for deployment.

  • Delete Library

    When a library is no longer of value, delete it from the Oracle Java Cloud Service - SaaS Extension Control.

  • Redeploy

    Use this option when you upgrade or make changes to a library.

Resource Usage

Use this region to review the CPU and Heap usage for each server in the Java service. Using this data, you can determine if the servers are behaving as expected, if any server is overloaded or using too much of the resources.If a server is overloaded or using too many resources, request an upgrade (add more servers) or ask the Cloud administrator to restart your servers if they are performing poorly.