Skip Headers
Oracle® Cloud Using Oracle Java Cloud Service
Release 12.2

Part Number E27039-02
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

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

3 Monitoring Oracle Java Cloud Service

This section describes how to monitor Oracle Java Cloud Service (Java Cloud Service). To learn more about functionality common to all Oracle Cloud services, see "Operating and Monitoring Cloud Services" in Getting Started with Oracle Cloud.

Topics:

Monitoring Service Notifications

Use the Notifications page to monitor upcoming blackouts that Oracle initiates to schedule maintenance jobs. If current notifications exist, the number of notifications appears; otherwise, zero appears.

Description of notifications.gif follows
Description of the illustration notifications.gif

To learn more, see "Monitoring Service Notifications" in Getting Started with Oracle Cloud.

Monitoring Service Utilization

Use the Utilization tab on the Services page to view a summary of current usage including CPU usage, deployed applications, memory usage, and request rate. Service administrators use this page to monitor the basic health of all of the services under their control and across all identity domains. For example, if a particular service instance does not have enough memory or is consistently using a high percentage of its available CPU, the administrator can choose to purchase more capacity.

Description of utilizations.gif follows
Description of the illustration utilizations.gif

To learn more, see "Monitoring Service Utilization" in Getting Started with Oracle Cloud.

Monitoring Status History

Use the Status History page to monitor the percentage of time your service is running in a daily, weekly, or monthly view.

Description of status_history.gif follows
Description of the illustration status_history.gif

To learn more, "Monitoring Status History" in Getting Started with Oracle Cloud.

Using the Oracle Java Cloud Service Control

The Java Cloud Service Control is the management console that enables you to deploy and monitor hosted applications. Using the Java Cloud Service Control, you can:

The primary user of the Java Cloud Service Control is the service administrator. The service administrator has privileges to access the Java Cloud Service Control. The administrator can deploy and redeploy applications, as well as start and stop deployed applications

Topics:

Accessing the Oracle Java Cloud Service Control

You access your Java Cloud Service Control environment using the credentials you received by e-mail when your signed up for your trial service or purchased your service.

Tip:

If you are logging in for the first time, use the temporary password you received by email or from your administrator. You will be prompted to change your password immediately.

Topics:

Accessing the Java Cloud Service Control from a URL

To access your Java Cloud Service Control using the provided URL:

  1. In your web browser, go to the Java Service Console URL provided by email or by your administrator.

    The Sign In page appears.

  2. Enter your Sign In credentials and click Sign In. (Note that you need Service Owner credentials to access this console.)

    The Java Cloud Service Control home page appears.

Accessing the Java Cloud Service Control from the My Services Page

To access your Java Cloud Service Control from My Services:

  1. Go to the Oracle Cloud home page (http://cloud.oracle.com).

  2. Click Sign In.

    The Sign In page appears.

  3. On the Sign In page:

    • Data Center - Select a data center.

    • Click Sign in to My Services

  4. If prompted, enter your service owner's credentials. (Note that you need Service Owner credentials to access the My Services page.)

    The My Services page appears.

  5. Locate the appropriate Java Cloud Service.

  6. Under the Actions column, click the Service Console icon to the right of the service name.

    Description of serv_console_icon.gif follows
    Description of the illustration serv_console_icon.gif

    Oracle Java Cloud Service Control home page appears.

Accessing the Java Cloud Service Control from the Services Page

To access your Java Cloud Service Control from the Services page:

  1. Go to the Oracle Cloud home page (http://cloud.oracle.com).

  2. Click Sign In.

    The Sign In page appears.

  3. On the Sign In page:

    • Data Center - Select a data center.

    • Click Sign in to My Services

  4. If prompted, enter your service owner's credentials. (Note that you need Service Owner credentials to access the My Services page.)

    The My Services page appears.

  5. Select a Java Cloud Service.

    The Services page appears.

  6. Select any tab that includes the Service Console button.

  7. Click the Service Console button.

    Description of serv_console_button.gif follows
    Description of the illustration serv_console_button.gif

    The Java Cloud Service Control home page appears.

Accessing the Java Cloud Service Control from the Service Instances Pane

When you are using the Java Cloud Service Control, you can go to the Service Instances pane by clicking the Java Cloud Services link in the breadcrumbs display.

Description of breadcrumbs_jcs.gif follows
Description of the illustration breadcrumbs_jcs.gif

The Service Instances pane lists all service instances within the current identity domain. (In the following figure, there is only one service instance.)

Description of service_instances.gif follows
Description of the illustration service_instances.gif

To display the Java Cloud Service Control showing information for a selected service, click the Manage icon in its row in the Service Instances pane.

About the Java Cloud Service Control Home Page

As shown in the next illustration, the Oracle Java Cloud Service Control home page is divided into panes.

Description of js_control.gif follows
Description of the illustration js_control.gif

The Oracle Java Cloud Service Control home page provides statistics on the following: performance, data sources, response and load,Java Cloud Service jobs, applications, and resource usage. Note that all metrics represent the most recent values available. For all "per minute" statistics, they are per minute in the last five minutes.

Resolving Performance Issues

The following are indications of performance issues:

  • Response times are slow or request throughput is high.

  • Server CPU or Java Heap memory usage is high.

If you notice performance issues with your application, upgrading the underlying Java Cloud Service instance may help resolve the problem.

Additional information is available in the service logs. To view log messages, click the View Log Messages link in the Servlets and JSPs area of the Performance Summary pane. That link displays the Log Messages - <service-name> page, where you can select a date range, message type, and so on, and can view or export messages to a file, as shown in the following illustration.

Description of log_messages.gif follows
Description of the illustration log_messages.gif

Deploying, Redeploying, and Deleting Applications

To deploy, redeploy, and delete an application, use the Applications pane of the Home page.

Description of js_control_app.gif follows
Description of the illustration js_control_app.gif

Deploying an Application

Once deployed, an application goes through a number of checks to ensure compliance with Oracle standards. These checks include a virus scan and a whitelist validation. Once the application passes these tests, deployment of the application begins. To learn more, see "About Java Cloud Service Whitelist".

Note that deployment is asynchronous. You will be prompted to verify the status of the job submitted for deployment.

The application archive path is the directory location of the application to be deployed. Browse your local desktop for the archive and then the UI uploads this WAR (Web Application Archive) file or EAR (Enterprise Archive) file to be deployed.

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

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. For information about how to see the logs for a job, see "Viewing Activity Logs".

If whitelist validation fails, deploy is never run and so there will be no deploy log.

Deleting an Application

When an application is no longer needed, click Delete Application to remove it from the Java Cloud Service Control.

Redeploying an Application

Click Deploy New or Redeploy to upgrade or otherwise make changes to an application. In most situations you would stop the application, make the requisite changes, then redeploy the application.

Starting and Stopping Applications

Once an application is deployed, click Start and Stop to start and stop the application as needed. If the application is exposed to external users, inform them of potential downtime before stopping the application.

Viewing Application-Specific Statistics

To view application-specific statistics, click the application name. The application's home page appears. Use this page to view the statistics of a particular application.

Description of js_app.gif follows
Description of the illustration js_app.gif

The application home page provides an overview of how well the application is working. The page provides availability and performance metrics, as well as version, state of the application, and application URLs to test the application.

An Application menu is on the top-left side of the page.

Description of js_app_menu.gif follows
Description of the illustration js_app_menu.gif

Use ADF Performance to examine performance information that may help you to identify problems that may be slowing down applications.

Tip:

If your application is running slowly, consider upgrading your service to the next performance level.

In addition, you can perform the following operations from the Application menu: Start Up, Shut Down, Redeploy, and Delete Application.

Viewing Activity Logs

You can access activity logs using the Java Cloud Service Jobs pane, which is at the bottom of the Java Cloud Service Control home page.

Description of js_app_act.gif follows
Description of the illustration js_app_act.gif

When you choose a Job ID in the Java Cloud Service Jobs section of the Java Cloud Service Control home page, the View Java Cloud Service Control Job Logs drop-down menu becomes active, and you can choose from the following list of activity logs:

  • Virus Scan

  • Application Whitelist Validation

  • Deploy Application

These logs are text documents that you can either open or save, and they are the result of background jobs that ran against the application to check relevant information, for example, to determine whether the file contains a virus or could otherwise cause problems. These background jobs run asynchronously.

Monitoring a Java Service Using the Command Line Interface

By installing the Oracle Java Cloud Service SDK (software development kit), you have access to a command line interface (CLI). To learn more about downloading the Oracle Java Cloud Service SDK, see "About Installing the Java Cloud Service SDK".

The CLI includes some commands that enable you to manage and monitor applications deployed on a Java Cloud Service instance. Each command in the CLI initiates an asynchronously executed job within the Oracle Cloud for a specific Java Cloud Service instance. Users can view the existing jobs for a specific Java service, view status, and review associated log files.

You can use the CLI to monitor a Java Cloud Service instance as follows:

To learn more about the commands available in the CLI, download the Java Cloud Service SDK and see the documentation available in the /doc directory.