This section contains the typical server and domain tasks you can perform with Oracle CEP Visualizer.
Oracle CEP Visualizer is fairly self-explanatory and intuitive, so not all tasks are discussed here, but rather, just those that are most common and typical and from which other similar tasks can be deduced.
This chapter describes:
Using Oracle CEP Visualizer, you can perform a variety of server management tasks, including managing:
Oracle CEP supports Jetty (see http://www.mortbay.org/jetty/
) as the Java Web server to deploy HTTP servlets and static resources.
Oracle CEP support for Jetty is based on Version 1.2 the OSGi HTTP Service. This API provides the ability to dynamically register and unregister javax.servlet.Servlet
objects with the run time and static resources.
Oracle CEP allows you to configure how your application prioritizes the execution of its work. Based on rules you define and by monitoring actual run time performance, you can optimize the performance of your application and maintain service level agreements. You define the rules and constraints for your application by defining a work manager.
For more information, see:
"Configuring Jetty for Oracle CEP" in the Oracle CEP Administrator's Guide
"Jetty Work Managers" in the Oracle CEP Administrator's Guide
Oracle CEP provides standards-based interfaces that are fully compliant with the Java Management Extensions (JMX) specification. Software vendors can use these interfaces to monitor Oracle CEP MBeans, to change the configuration of an Oracle CEP domain, and to monitor the distribution (activation) of those changes to all server instances in the domain.
Oracle CEP Visualizer and the wlevs.Admin
command line tool both use JMX to connect to a server. However, to use these tools, and the JMX interfaces in general, you must configure Oracle CEP with the JMX configuration information in the config.xml
file.
For more information, see:
"Configuring JMX for Oracle CEP" in the Oracle CEP Administrator's Guide
Oracle CEP supports Java Database Connectivity (JDBC) 3.0 for relational database access.
The JDBC API provides a standard, vendor-neutral mechanism for connecting to and interacting with database servers and other types of tabular resources that support the API. The JDBC javax.sql.DataSource
interface specifies a database connection factory that is implemented by a driver. Instances of DataSource
objects are used by applications to obtain database connections (instances of java.sql.Connection
). After obtaining a connection, an application interacts with the resource by sending SQL commands and receiving results.
For more information, see:
"Configuring JDBC for Oracle CEP" in the Oracle CEP Administrator's Guide
Oracle CEP includes an HTTP publish-subscribe server to which applications can publish messages. Applications publish messages to a particular channel; other applications can then subscribe to this channel to receive these published messages.
You can use Oracle CEP Visualizer to modify existing channels, as well as create new ones and delete existing ones. When you configure channels with Oracle CEP Visualizer, they are permanent and survive server restart. Channels configured using APIs from a custom http pub-sub adapter are dynamic and do not survive server restart.
Oracle CEP Visualizer includes the following preconfigured channels that are used by Oracle CEP Visualizer itself; they cannot be deleted or modified:
/evsmonitor
/evsalert
/evsdomainchange
For more information, see:
Section 3.5, "Managing HTTP Publish-Subscribe Server Channels"
Section 4.5.1, "How to Configure Security for an HTTP Publish-Subscribe Channel"
"Configuring HTTP Publish-Subscribe for Oracle CEP" in the Oracle CEP Administrator's Guide
Event types define the properties of the events that are handled by Oracle CEP applications. All the event types used by the applications of a server make up the event type repository.
For more information, see:
"Creating Oracle CEP Event Types" in the Oracle CEP IDE Developer's Guide for Eclipse
The Oracle CEP event repository feature allows you to persist the events that flow out of a component of the event processing network (EPN) to a store, such as a database table, and then play them back at a later stage or explicitly query the events from a component such as an event bean. By default, Oracle CEP stores recorded events in a database, which means that before you can start using the record and playback feature in your own application, you must specify where the database server is located along with the name of the database server that will contain the recorded events.
For more information, see:
"Storing Events in the Persistent Event Store" in the Oracle CEP IDE Developer's Guide for Eclipse
An Oracle CEP multi-server domain (or cluster) is a set of two or more servers logically connected for the purposes of management, and physically connected using a shared User Datagram Protocol (UDP) multicast address and port. All servers in an Oracle CEP multi-server domain are aware of all other servers in the domain and any one server can be used as an access point for making changes to the deployments in the domain.
Oracle CEP supports the following clustering systems:
Oracle Coherence: a JCache-compliant in-memory distributed data grid solution for clustered applications and application servers. It coordinates updates to the data using cluster-wide concurrency control, replicates data modifications across the cluster using the highest performing clustered protocol available, and delivers notifications of data modifications to any servers that request them. You take advantage of Oracle Coherence features using the standard Java collections API to access and modify data, and use the standard JavaBean event model to receive data change notifications.
Note: Before you can use Oracle CEP with Oracle Coherence, you must obtain a valid Oracle Coherence license such as a license for Coherence Enterprise Edition, Coherence Grid Edition, or Oracle WebLogic Application Grid. For more information on Oracle Coherence, seehttp://www.oracle.com/technology/products/coherence/index.html . |
For more information, see:
"Administrating Oracle CEP Multi-Server Domains" in the Oracle CEP Administrator's Guide
A cache is a temporary storage area for events, created exclusively to improve the overall performance of your Oracle CEP application; it is not necessary for the application to function correctly. Oracle CEP applications can optionally publish or consume events to and from a cache to increase the availability of the events and increase the performance of their applications.
A caching system refers to a configured instance of a caching implementation. A caching system defines a named set of configured caches as well as the configuration for remote communication if any of the caches are distributed across multiple machines.
Oracle CEP supports the following caching systems:
Oracle CEP local cache: a local, in-memory single-JVM cache.
Oracle Coherence: a JCache-compliant in-memory distributed data grid solution for clustered applications and application servers. It coordinates updates to the data using cluster-wide concurrency control, replicates data modifications across the cluster using the highest performing clustered protocol available, and delivers notifications of data modifications to any servers that request them. You take advantage of Oracle Coherence features using the standard Java collections API to access and modify data, and use the standard JavaBean event model to receive data change notifications.
Note: Before you can use Oracle CEP with Oracle Coherence, you must obtain a valid Oracle Coherence license such as a license for Coherence Enterprise Edition, Coherence Grid Edition, or Oracle WebLogic Application Grid. For more information on Oracle Coherence, seehttp://www.oracle.com/technology/products/coherence/index.html . |
Third-party caches: you can create a plug-in to allow Oracle CEP to work with other, third-party cache implementations.
For more information, see:
"Configuring Oracle CEP Caching" in the Oracle CEP IDE Developer's Guide for Eclipse
Oracle CEP Visualizer allows you to change the server-wide logging configuration, such as the severity of log messages you want the server to print out, the name of the log file, and so on. You can also view the information in the log files for a particular module, but you cannot change it.
For more information, see:
"Configuring Logging and Debugging for Oracle CEP" in the Oracle CEP Administrator's Guide
This section describes:
For more information, see Section 3.1.1, "Jetty".
Using the Oracle CEP Visualizer, you can view the Jetty Web server configuration for a selected Oracle CEP server.
To view Jetty web server configuration:
In the left pane, click the Domain > Server node, where Domain refers to the name of your Oracle CEP domain and Server refers to the name of the server instance.
In the right pane, click the HTTP Server tab.
In the right pane, the properties of the Jetty server are displayed:
The name of the Jetty server.
The network I/O object to which the Jetty server is bound.
The work manager name to which the Jetty server is bound.
The list of Web applications that are deployed to this Jetty server, along with the path of the application and its context path.
You can only view the configuration of the Jetty servers configured in your Oracle CEP server using Oracle CEP Visualizer. To change the configuration, you must manually update the server's config.xml
file.
For details, see "Configuring Jetty for Oracle CEP" in the Oracle CEP Administrator's Guide.
Using the Oracle CEP Visualizer, you can view the work manager configuration for a selected Oracle CEP server.
To view the work manager configuration:
In the left pane, click the Domain > Server node, where Domain refers to the name of your Oracle CEP domain and Server refers to the name of the server instance.
In the right pane, click the Work Manager tab.
The Work Manager tab appears as shown in Figure 3-1.
In the Work Manager table, select the work manager you want to configure by clicking on its name.
Click the Change button at the bottom of the page.
Update the work manager configuration properties:
Min threads
—The minimum number of threads that the server allocates so as to reduce the initial time it takes to perform a task.
Max threads
—The maximum number of concurrent threads that execute requests from the constrained work set.
Fair Share
—The average thread-use time required to process requests.
Click Save to save your changes or Cancel to cancel the update.
You cannot delete existing work managers or create new ones using Oracle CEP Visualizer; rather, you must manually update the server's config.xml
file.
For details, see "Jetty Work Managers" in the Oracle CEP Administrator's Guide.
You cannot delete existing work managers or create new ones using Oracle CEP Visualizer; rather, you must manually update the server's config.xml
file.
For details, see "Jetty Work Managers" in the Oracle CEP Administrator's Guide.
This section describes:
For more information, see Section 3.1.2, "JMX".
Using the Oracle CEP Visualizer, you can view the JMX configuration for a selected Oracle CEP server.
To view JMX configuration:
In the left pane, click the Domain > Server node, where Domain refers to the name of your Oracle CEP domain and Server refers to the name of the server instance.
In the right pane, click the JMX tab.
The JMX tab appears as Figure 3-2 shows.
The JMX properties are displayed in the table:
jndi-service-name
—The name of the JNDI service to which the JMX server will bind its object.
rmi-service-name
—The name of the RMI service with which the JMX server will register to receive calls.
rmi-jrmp-port
—The port on which to listen for RMI JRMP JMX requests.
rmi-registry-port
—The port on which to start the RMIRegistry.
Note: Oracle CEP does not support the JRMP protocol: an Oracle CEP JMX client does not use thermi-jrmp-port or rmi-registry-port properties. Instead, JMX clients must use the more secure MSA protocol for both local and remote access to the Oracle CEP JMX server. When you connect to the Oracle CEP JMX server that is running on localhost or on a remote host, you must always use the JMX URL service:jmx:msarmi:// HOST-NAME : PORT /jndi/jmxconnector so that you are always using the MSA connector (where HOST-NAME is either localhost or the name of the remote host and PORT is the Oracle CEP server JNDI port). For more information, see "Accessing the Oracle CEP JMX Server" in the Oracle CEP Administrator's Guide. |
You can only view the JMX configuration of your Oracle CEP server using Oracle CEP Visualizer. To change the configuration, you must manually update the server's config.xml
file.
For more information, see "Configuring JMX for Oracle CEP" in the Oracle CEP Administrator's Guide.
This section describes:
For more information, see Section 3.1.3, "Data Sources".
Using the Oracle CEP Visualizer, you can view the data source configuration for a selected Oracle CEP server.
To view a data source configuration:
In the left pane, click the Domain > Server node, where Domain refers to the name of your Oracle CEP domain and Server refers to the name of the server instance.
In the right pane, click the DataSource tab.
The DataSource tab appears as Figure 3-3 shows.
Using the Oracle CEP Visualizer, you can add the data source configuration for a selected Oracle CEP server.
To add a data source configuration:
In the left pane, click the Domain > Server node, where Domain refers to the name of your Oracle CEP domain and Server refers to the name of the server instance.
In the right pane, click the DataSource tab.
The DataSource tab appears as Figure 3-4 shows.
Click Add.
The New Datasource dialog appears as Figure 3-5 shows. There are three accordion tabs:
Data Source: use this tab to identify the data source and specify whether or not to use a global transaction protocol.
Global Tx Protocol: use this tab to specify connection properties and whether or not to use XA.
Connection Pool: use this tab to specify connection pool properties.
Click the Data Source tab.
The DataSource tab appears as Figure 3-5 shows.
Figure 3-5 New Datasource: Data Source Tab
Configure the DataSource tab as Table 3-1 describes.
Table 3-1 New Datasource: Data Source Parameters
Parameter | Description |
---|---|
|
The name for this data source configuration. |
|
JNDI path to where this data source will be bound. This is the name your Oracle CEP application uses to look up the data source in JNDI. |
|
Select the protocol for Oracle CEP to use for the transaction branch when processing a global transaction:
|
Click the Global Tx Protocol tab.
The Global Tx Protocol tab appears as Figure 3-6 shows.
Figure 3-6 New Datasource: Global Tx Protocol Tab
Configure the Global Tx Protocol tab as Table 3-2 describes.
Table 3-2 New Datasource: Global Tx Protocol Parameters
Parameter | Description |
---|---|
|
Select the type of JDBC driver to use:
|
|
Specify the database connection URL appropriate for your database. This URL includes the name of the database, the host and port of the computer on which the database server is running, and so on |
|
Specify database user account name that you want to use for each connection in the data source. |
|
Specify database user password that you want to use for each connection in the data source |
|
Specify whether or not to use distributed transactions:
|
Click the Connection Pool tab.
The Connection Pool tab appears as Figure 3-7 shows.
Figure 3-7 New Datasource: Connection Pool Tab
Configure the Connection Pool tab as Table 3-3 describes.
Table 3-3 New Datasource: Connection Pool Parameters
Parameter | Description |
---|---|
|
Specify the number of physical connections to create when creating the connection pool. |
|
Specify the maximum number of physical connections that this connection pool can contain. |
|
Specify how many connections to add when all the connections in the connection pool are in use and the connection pool receives a new connection request. |
Click Save.
The new datasource is added to the Oracle CEP server configuration.
Using the Oracle CEP Visualizer, you can edit the data source configuration for a selected Oracle CEP server.
To edit data source configuration:
In the left pane, click the Domain > Server node, where Domain refers to the name of your Oracle CEP domain and Server refers to the name of the server instance.
In the right pane, click the DataSource tab.
The DataSource tab appears as Figure 3-8 shows.
In the Data Sources table, select the data source you want to edit by clicking on its name.
Click Edit.
The Datasource dialog appears as Figure 3-9 shows.
Click the Data Source tab.
The DataSource tab appears as Figure 3-9 shows.
Figure 3-9 Edit Datasource: Data Source Tab
Configure the DataSource tab as Table 3-4 describes.
Table 3-4 Edit Datasource: Data Source Parameters
Parameter | Description |
---|---|
|
The name for this data source configuration. |
|
JNDI path to where this data source will be bound. This is the name your Oracle CEP application uses to look up the data source in JNDI. |
|
Select the protocol for Oracle CEP to use for the transaction branch when processing a global transaction:
|
Click the Global Tx Protocol tab.
The Global Tx Protocol tab appears as Figure 3-10 shows.
Figure 3-10 Edit Datasource: Global Tx Protocol Tab
Configure the Global Tx Protocol tab as Table 3-5 describes.
Table 3-5 Edit Datasource: Global Tx Protocol Parameters
Parameter | Description |
---|---|
|
Select the type of JDBC driver to use:
|
|
Specify the database connection URL appropriate for your database. This URL includes the name of the database, the host and port of the computer on which the database server is running, and so on |
|
Specify database user account name that you want to use for each connection in the data source. |
|
Specify database user password that you want to use for each connection in the data source |
|
Specify whether or not to use distributed transactions:
|
Click the Connection Pool tab.
The Connection Pool tab appears as Figure 3-11 shows.
Figure 3-11 Edit Datasource: Connection Pool Tab
Configure the Connection Pool tab as Table 3-6 describes.
Table 3-6 Edit Datasource: Connection Pool Parameters
Parameter | Description |
---|---|
|
Specify the number of physical connections to create when creating the connection pool. |
|
Specify the maximum number of physical connections that this connection pool can contain. |
|
Specify how many connections to add when all the connections in the connection pool are in use and the connection pool receives a new connection request. |
Click Save.
The datasource is updated in the Oracle CEP server configuration.
This section describes:
Section 3.5.1, "How to View HTTP Publish-Subscribe Server Channels"
Section 3.5.2, "How to Add an HTTP Publish-Subscribe Server Channel"
Section 3.5.3, "How to Delete an HTTP Publish-Subscribe Server Channel"
Section 3.5.4, "How to View Messages Published to HTTP Publish-Subscribe Server Channels"
For more information, see Section 3.1.4, "HTTP Publish-Subscribe Server".
Using the Oracle CEP Visualizer, you can view the HTTP publish-subscribe server channels currently open on the Oracle CEP server, including:
Static channels: those channels configured in the Oracle CEP server config.xml
and used by Oracle CEP Visualizer itself.
Dynamic channels: those channels that are not configured in the Oracle CEP server config.xml
but created dynamically when the Oracle CEP sever is running. You can view statistics for dynamic channels, including the number of messages sent to this channel and the number of subscribers. Dynamic channel configuration is read-only.
User-defined channels.
To view HTTP publish-subscribe server channels:
Be sure you log on to Oracle CEP Visualizer using an administration user.
For more information, see:
"Configuring Security for Oracle CEP" in the Oracle CEP Administrator's Guide.
In the left pane, click the Domain > Server > Services > Http Pub/Sub Server node, where Domain refers to the name of your Oracle CEP domain and Server refers to the name of the server instance.
A table appears in the right pane with the list of HTTP pub-sub servers configured for Oracle CEP.
In the right pane, click the name of the HTTP pub-sub server in the table. The default server is called pubsub
.
The HTTP publish-subscribe server properties dialog appears as Figure 3-12 shows.
Figure 3-12 HTTP Publish-Subscribe Server Channel List
All active channels are shown in the Channels table. The Status column indicates the type of channel: static, dynamic, or user-defined.
Using the Oracle CEP Visualizer, you can add an HTTP publish-subscribe server channel.
To add an HTTP publish-subscribe server channel:
Be sure you log on to Oracle CEP Visualizer using an administration user.
For more information, see:
"Configuring Security for Oracle CEP" in the Oracle CEP Administrator's Guide.
In the left pane, click the Domain > Server > Services > Http Pub/Sub Server node, where Domain refers to the name of your Oracle CEP domain and Server refers to the name of the server instance.
A table appears in the right pane with the list of HTTP pub-sub servers configured for Oracle CEP.
In the right pane, click the name of the HTTP pub-sub server in the table. The default server is called pubsub
.
In the working area towards the bottom of the right pane, enter the name of the new channel in the Channel Pattern text box.
The channel must start with a /
, such as /mychannel
.
If you have security enabled, select the security roles that are allowed to publish and subscribe to the channel.
Select more than one by holding down the Ctrl key.
Click the Add Channel.
The new channel appears in the Channels table at the top right of the pane.
Using the Oracle CEP Visualizer, you can add an HTTP publish-subscribe server channel.
To delete an HTTP publish-subscribe server channel:
Be sure you log on to Oracle CEP Visualizer using an administration user.
For more information, see:
"Configuring Security for Oracle CEP" in the Oracle CEP Administrator's Guide.
In the left pane, click the Domain > Server > Services > Http Pub/Sub server node, where Domain refers to the name of your Oracle CEP domain and Server refers to the name of the server instance.
A table appears in the right pane with the list of HTTP pub-sub servers configured for Oracle CEP.
In the right pane, click the name of the HTTP pub-sub server in the table. The default server is called pubsub
.
In the Channels table, click the name of the channel you want to delete.
Click Delete Channel at the bottom of the pane.
Oracle CEP includes an HTTP publish-subscribe server to which applications can publish messages. Applications publish messages to a particular channel; other applications can then subscribe to this channel to receive these published messages.
You can use Oracle CEP Visualizer to view the messages that are currently being published to a channel, including:
Static channels: those channels configured in the Oracle CEP server config.xml
and used by Oracle CEP Visualizer itself.
Dynamic channels: those channels that are not configured in the Oracle CEP server config.xml
but created dynamically when the Oracle CEP sever is running. You can view statistics for dynamic channels, including the number of messages sent to this channel and the number of subscribers. Dynamic channel configuration is read-only.
User-defined channels.
Note: When one application (application-1) advertises a channel that a second application (application-2) subscribes to and uses as a foreign stage, you cannot view the details of the advertised channel from application-2. To view the details of this channel, you must do so from application-1. |
For more information, see:
Section 3.5.1, "How to View HTTP Publish-Subscribe Server Channels"
"Event Record and Playback Example" in the Oracle CEP Getting Started
To view messages published to HTTP publish-subscribe server channels:
In the top pane, click Viewstream.
In the right pane, click Initialize Client.
In the Subscribe Channel text box, enter the name of the channel to which the Oracle CEP server is publishing messages.
For example, in the Record and Playback example, included in the Oracle CEP installation, the HTTP pub-sub adapter publishes to a channel called /playbackchannel
.
Click Subscribe.
The Received Messages text box displays events being published to the channel as Figure 3-13 shows.
To unsubscribe to the channel, click Unsubscribe.
This section describes:
For more information, see Section 3.1.5, "Event Type Repository".
Using the Oracle CEP Visualizer, you can view the event type repository.
To view the event type repository:
In the left pane, click Domain > Server > Services > Event Type Repository, where Domain refers to the name of your Oracle CEP domain and Server refers to the name of the server instance.
The right pane displays the Event Name table that lists all the event types used by the applications of the server.
In the right pane, click the name of an event in the Event Name table. The text box at the bottom displays the properties of the event type. For example, a simple Name
event type that has three properties, first
and last
which are Strings
and age
which is an integer, might look like:
{first=java.lang.String, last=java.lang.String, age=int}
You can only view the event type repository, along with the its event types, configured for an Oracle CEP server using Oracle CEP Visualizer.
For details, see "Creating Oracle CEP Event Types" in the Oracle CEP IDE Developer's Guide for Eclipse.
This section describes:
For more information, see Section 3.1.6, "Persistent Event Store".
Using the Oracle CEP Visualizer, you can view the persistent event store.
To view the persistent event store:
In the left pane, click Domain > Server > Services > Event Repository, where Domain refers to the name of your Oracle CEP domain and Server refers to the name of the server instance.
The right pane shows the event stores that have been configured. In particular:
RDBMS Provider Name displays the name of the store provider
Data Source displays the JDBC data source associated with the provider.
You can only view the event store configured for an Oracle CEP server using Oracle CEP Visualizer. To change the configuration, you must manually update the server's config.xml
file.
For details, see "Storing Events in the Persistent Event Store" in the Oracle CEP IDE Developer's Guide for Eclipse.
This section describes:
Section 3.8.3, "How to View Oracle Coherence Cluster Topologies"
Section 3.8.4, "How to Monitor Nodes in an Oracle Coherence Cluster"
For more information, see:
You can view the default and user-defined cluster groups, what servers belong to those groups, and what applications are deployed to those groups.
By default, there is a group for each server with the same name as the server and a group named AllDomainMembers which represents all the servers in the domain. In addition, you can define custom groups when you configure your cluster.
You may deploy an application to a cluster group or to an individual server. When you deploy to a cluster group, the application belongs to the group, not the individual servers in the group. When you deploy to an individual server, the application belongs to the server's own group.
For more information, see
Section 2.3.2, "Deploying an Application in a Multi-Server Domain"
"Groups" in the Oracle CEP Administrator's Guide
To view cluster group membership:
In the left pane, click the Domain node, where Domain refers to the name of your Oracle CEP domain.
In the right pane, click the Cluster Groups/Server tab.
The Cluster Groups/Server tab appears as Figure 3-14 shows.
Use the Cluster Groups/Server tab to examine the server and application contents of various cluster groups.
For example:
Group testgroup
contains two servers (WLEvServer-1
and WLEvServer-2
) and one application (helloworld
) as Figure 3-14 shows.
Group WLEvServer-1
contains one server (WLEvServer-1
) and no applications. The helloworld
application listed under its Applications
node belongs to group testgroup
, not to server WLEvServer-1
.
Group WLEvServer-2
contains one server (WLEvServer-2
) and one application (fx
). The fx
application was deployed to server WLEvServer-2
. The helloworld
application listed under its Applications
node belongs to group testgroup
, not to server WLEvServer-2
.
Using Oracle CEP Visualizer, you can view all cluster topologies regardless of cluster implementation. You can also view cluster group properties and server instance properties.
If you are using Oracle Coherence for clustering, you can view Oracle Coherence topologies exclusively. For more information, see Section 3.8.3, "How to View Oracle Coherence Cluster Topologies".
To view all cluster topologies:
In the left pane, click the Domain node, where Domain refers to the name of your Oracle CEP domain.
In the right pane, click the Cluster tab.
In the right pane, click the Topology tab.
The Topology tab appears as Figure 3-15 shows.
This tab shows all cluster groups regardless of the cluster implementation.
For information on the various tools along the top of the topology canvas, see Section 3.8.7, "Managing the Cluster Topology Diagram".
To view the properties for a given group, click on the group in the Group List.
To view the properties for a given server instance, click on the server instance in the Group List.
To view details on a given server instance, click the Group Member tab and select the server instance as Figure 3-16 shows.
Use the Group Member tab to customize the group table:
To change the order of columns, click on the column name in the cache chart and drag left or right.
To change the sort order of a column, click the triangle to the right of the column name in the cache chart.
Using Oracle CEP Visualizer, if you are using Oracle Coherence clustering, you can view Oracle Coherence cluster topologies, cluster group properties, and server instance properties.
To view all clustering topologies regardless of clustering implementation, see Section 3.8.2, "How to View all Cluster Topologies".
To view Oracle Coherence cluster topologies:
In the left pane, click the Domain node, where Domain refers to the name of your Oracle CEP domain.
In the right pane, click the Coherence tab.
In the right pane, click the Topology tab.
The Topology tab appears as Figure 3-17 shows.
Figure 3-17 Oracle Coherence Cluster Topology Tab
This tab shows all cluster groups that the Oracle Coherence clustering implementation manages.
For information on the various tools along the top of the topology canvas, see Section 3.8.7, "Managing the Cluster Topology Diagram".
To view the properties for a given group, click on the group in the Group List.
To view the properties for a given server instance, click on the server instance in the Group List.
Using Oracle CEP Visualizer, you can compare a combination of properties for any and all nodes in an Oracle Coherence cluster. For a selected node in an Oracle Coherence cluster, you can view a select list of properties.
Once you have determined the root cause of a problem, you can tune Oracle Coherence parameters to correct the problem. For more information, see Section 3.8.6, "How to Tune Oracle Coherence".
To monitor nodes in an Oracle Coherence cluster:
In the left pane, click the Domain node, where Domain refers to the name of your Oracle CEP domain.
In the right pane, click the Coherence tab.
In the right pane, click the Multi-Nodes Monitor tab.
The Multi-Nodes Monitor tab appears as Figure 3-14 shows.
Use the Multi-Nodes Monitor tab to customize the group table:
To change the order of columns, click on the column name in the cache chart and drag left or right.
To change the sort order of a column, click the triangle to the right of the column name in the cache chart.
Use the Multi-Nodes Monitor tab to compare any combination of the properties that Table 3-7 lists for any nodes in an Oracle Coherence cluster:
Expand a group and check one or more nodes.
Drag a property from the Drag Property to Watch area to either graph to watch that property or, select a property and click Add to Left or Add to Right.
You may specify at most one property per graph.
A line is drawn for each selected node. The legend below the graph distinguishes graph data for each selected node by color.
To watch a different property, drag a new property and drop it onto the graph or, select a new property and click Add to Left or Add to Right.
To change the scale of a graph, drag the slider next to the vertical axis.
Table 3-7 Properties You Can Watch on the Multi-Nodes Monitor Tab
Property | Description |
---|---|
|
The total amount of free memory (in MB) for the selected node. |
|
The total amount of memory available (in MB) for the selected node. |
|
The total number of Oracle Coherence packets sent by the selected node. |
|
The total number of Oracle Coherence packets received by the selected node. |
|
The total number of Oracle Coherence received packets that the selected node can buffer. |
|
The total number of Oracle Coherence published packets that the selected node can buffer. |
To view more details for a particular node, click the Node Detail View tab.
The Node Detail View tab appears as Figure 3-19 shows.
Use the Node Detail View tab to compare the properties that Table 3-8 lists for a selected node:
Select a node from the Nodes pull-down menu.
The properties for the selected node are shown in the Nodes Properties list.
A line is drawn for the selected node.
To change the scale of a graph, drag the slider next to the vertical axis.
Table 3-8 Properties You Can Watch on the Node Detail View Tab
Property | Description |
---|---|
|
The total amount of free memory (in MB) for the selected node. |
|
The total amount of memory available (in MB) for the selected node. |
|
The total number of Oracle Coherence packets sent by the selected node. |
|
The total number of Oracle Coherence packets received by the selected node. |
Using Oracle CEP Visualizer, you can monitor a wide variety of Oracle Coherence cache parameters and graphically compare parameter values to locate and diagnose performance and operational problems.
Once you have determined the root cause of a problem, you can tune Oracle Coherence parameters to correct the problem. For more information, see Section 3.8.6, "How to Tune Oracle Coherence".
To monitor an Oracle Coherence Cache:
In the left pane, click the Domain node, where Domain refers to the name of your Oracle CEP domain.
In the right pane, click the Coherence tab.
In the right pane, click the Cache Chart tab.
The Multi-Nodes Monitor tab appears as Figure 3-14 shows.
Use the Cache Chart tab to view any combination of the columns that Table 3-9 lists for one or more selected caches:
Check one or more caches in the cache chart.
To add a column to the cache chart, check the column in the Columns list.
To remove a column from the cache chart, uncheck the column in the Columns list.
To change the order of columns, click on the column name in the cache chart and drag left or right.
To change the sort order of a column, click the triangle to the right of the column name in the cache chart.
Table 3-9 Columns and Properties for the Cache Chart Tab
Property | Description |
---|---|
|
The name of the cache. |
|
The total number of objects in the selected cache. |
|
The total number times an Oracle Coherence cache client has accessed the selected cache. |
|
The total number times an Oracle Coherence cache client has accessed the selected cache and failed to find the desired object. |
|
The total number times Oracle Coherence has reached its maximum size and had to delete some objects to return to a configured smaller size for the selected cache. |
|
The total number of times Oracle Coherence has written to the selected cache's backing store. |
|
The total number of times Oracle Coherence has read from the selected cache's backing store. |
|
The node identifier for the selected cache. |
|
The total number of times the selected cache's backing store has failed to service an Oracle Coherence Store Write or Store Read. |
|
The average time (in milliseconds) taken by Oracle Coherence to find an object in the selected cache. |
|
The average time (in milliseconds) taken by Oracle Coherence to retrieve an object from the selected cache. |
|
The average time (in milliseconds) taken by Oracle Coherence to determine that an object does not exist in the selected cache. |
|
The average time (in milliseconds) taken by Oracle Coherence to add a new object to the selected cache. |
|
The total time (in milliseconds) taken by Oracle Coherence to find an object in the selected cache. |
|
The total time (in milliseconds) taken by Oracle Coherence to determine that an object does not exist in the selected cache. |
|
The total time (in milliseconds) taken by Oracle Coherence to delete some objects from the selected cache to return to a configured smaller size after having reached its maximum size. |
|
The total time (in milliseconds) taken by Oracle Coherence to read from the selected cache's backing store. |
|
The total time (in milliseconds) taken by Oracle Coherence to write to the selected cache's backing store. |
|
The total time (in milliseconds) taken by Oracle Coherence to retrieve objects from the selected cache. |
|
The total time (in milliseconds) taken by Oracle Coherence to add new objects to the selected cache. |
Use the Cache Chart tab to compare any combination of the properties that Table 3-9 lists for one or more selected caches:
Check one or more caches in the cache chart.
Drag a property from the Drag Property to Watch area to either graph to watch that property or, select the property and click Add to Left or Add to Right.
You may specify at most one property per graph.
A line is drawn for each selected cache. The legend below the graph distinguishes graph data for each selected cache by color.
To watch a different property, drag the new property and drop it onto the graph or, select a different property and click Add to Left or Add to Right.
To change the scale of a graph, drag the slider next to the vertical axis.
Using Oracle CEP Visualizer, you can view and modify a variety of Oracle Coherence parameters to fine tune Oracle Coherence performance.
Note: Not all Oracle Coherence parameters can be modified. For more information, refer to your Oracle Coherence documentation. |
To determine the root cause of a problem, you can monitor Oracle Coherence parameters. For more information, see:
To tune Oracle Coherence:
In the left pane, click the Domain node, where Domain refers to the name of your Oracle CEP domain.
In the right pane, click the Coherence tab.
In the right pane, click the Tuning tab.
The Tuning tab appears as Figure 3-21 shows.
To tune parameters and invoke operations for caches, select the Cache Tuning accordion tab and select a cache as Figure 3-21 shows.
Table 3-10 lists the properties you can view and tune for the selected cache. All properties are based on Oracle Coherence http://download.oracle.com/otn_hosted_doc/coherence/340/com/tangosol/net/management/Registry.html
.
Table 3-10 Cache Tuning: Properties
Property | Description |
---|---|
|
The name of the selected cache (read-only). |
|
The service associated with this cache (read-only). |
|
The Valid values are doubles in the interval [0.0, 1.0].. |
|
The number of seconds that an entry added to a write-behind queue will sit in the queue before being stored via a |
|
The number of milliseconds that the MBeanServer will keep a remote model snapshot before refreshing. |
|
The number of milliseconds between cache flushes. Value of zero indicates that the cache will never flush. |
|
The Valid values are doubles in the interval[0.0, 1.0]. If zero, refresh-ahead scheduling will be disabled. |
|
The maximum size of the write-behind queue for which failed |
|
The limit of the cache size measured in units. The cache will prune itself automatically once it reaches its maximum unit level. This is often referred to as the `high water mark` of the cache. |
|
The number of units to which the cache will shrink when it prunes. This is often referred to as a `low water mark` of the cache. |
To apply changes, click the Save button.
To discard changes, click the Cancel button.
Table 3-11 lists the operations you can invoke for the selected cache.
To tune parameters and invoke operations for cluster nodes, select the Node Tuning accordion tab and select a node as Figure 3-22 shows.
Table 3-10 lists the properties you can view and tune for the selected cache. All properties are based on Oracle Coherence http://download.oracle.com/otn_hosted_doc/coherence/340/com/tangosol/net/management/Registry.html
.
Table 3-12 Node Tuning: Properties
Property | Description |
---|---|
|
The name of the selected node (read-only). |
|
The buffer size of the unicast datagram socket used by the Publisher, measured in the number of packets. Changing this value at runtime is an inherently unsafe operation that will pause all network communications and may result in the termination of all cluster services. |
|
The buffer size of the unicast datagram socket used by the Receiver, measured in the number of packets. Changing this value at runtime is an inherently unsafe operation that will pause all network communications and may result in the termination of all cluster services. |
|
The maximum number of packets to send without pausing. Anything less than one (for example, zero) means no limit. |
|
The number of milliseconds to pause between bursts. Anything less than one (for example, zero) is treated as one millisecond. |
|
Specifies which logged messages will be output to the log destination. Valid values are:
|
|
Specifies how messages will be formatted before being passed to the log destination. The value of the message-format element is static text with the following replaceable parameters:
|
|
The maximum number of characters that the logger daemon will process from the message queue before discarding all remaining messages in the queue. Valid values are integers in the range [0...]. Zero implies no limit. |
|
The percentage (0 to 100) of the servers in the cluster that a packet will be sent to, above which the packet will be multicasted and below which it will be unicasted. |
|
The minimum number of milliseconds that a packet will remain queued in the Publisher`s re-send queue before it is resent to the recipient(s) if the packet has not been acknowledged. Setting this value too low can overflow the network with unnecessary repetitions. Setting the value too high can increase the overall latency by delaying the re-sends of dropped packets. Additionally, change of this value may need to be accompanied by a change in |
|
The minimum number of milliseconds between the queueing of an Ack packet and the sending of the same. This value should be not more then a half of the |
|
The maximum total number of packets in the send and resend queues that forces the publisher to pause client threads. Zero means no limit. |
|
The number of milliseconds to pause client threads when a traffic jam condition has been reached. Anything less than one (for example, zero) is treated as one millisecond. |
To apply changes, click the Save button.
To discard changes, click the Cancel button.
Table 3-11 lists the operations you can invoke for the selected node.
To tune parameters and invoke operations for nodes, select the Node Tuning accordion tab and select a node as Figure 3-22 shows.
Table 3-10 the properties you can view and tune for the selected cache. All properties are based on Oracle Coherence http://download.oracle.com/otn_hosted_doc/coherence/340/com/tangosol/net/management/Registry.html
.
Table 3-14 Service Tuning: Properties
Property | Description |
---|---|
|
The name of the selected service (read-only). |
|
The default timeout value in milliseconds for requests that can be timed-out (for example, implement the |
|
The amount of time in milliseconds that a task can execute before it is considered hung. Note that a posted task that has not yet started is never considered as hung. |
|
The default timeout value in milliseconds for tasks that can be timed-out (for example, implement the |
|
The number of threads in the service thread pool. |
To apply changes, click the Save button.
To discard changes, click the Cancel button.
Table 3-11 lists the operations you can invoke for the selected service.
This section describes the various tools along the top of the Topology canvas as Figure 3-24 shows.
You use these tools to manage the topology diagram of your cluster topology.
Use the Choose Layout pull-down menu to select alternate ways of distributing cluster groups. You can choose any of:
organic
hierarchic
orthogonal
Use the Zoom slider to increase or decrease the zoom level. This is an alternative to using the Zoom In and Zoom Out buttons (see Section 3.8.7.4, "Zoom In and Zoom Out").
Click the Fit Content button to adjust the zoom level automatically to make all of the diagram visible in the current browser window.
Click the Zoom In and Zoom Out buttons to change the zoom level. This is an alternative to using the Zoom slider (see Section 3.8.7.2, "Zoom").
Click the Toggle Overview button to alternately hide and show the overview diagram on the left.
This section describes:
For more information, see Section 3.1.9, "Logs".
Using the Oracle CEP Visualizer, you can configure the logging system of a selected Oracle CEP server. By default, this logging configuration applies to all components. To configure component-specific logging options, see Section 3.9.2, "How to Configure Component Logging".
To configure the Oracle CEP server logging service:
In the left pane, click the Domain > Server node, where Domain refers to the name of your Oracle CEP domain and Server refers to the name of the server instance.
In the right pane, click the Logging tab.
Click the Logging Services tab.
The Logging Services tab appears as Figure 3-25 shows.
Click Edit.
Edit the dialog as Table 3-16 describes.
Table 3-16 Logging Services Options
Attribute | Description |
---|---|
|
Specify the name of the logging service as the Oracle CEP server |
|
Specify the default log severity at which Oracle CEP server logs messages. |
|
Specify whether or not to keep old log files indefinitely:
|
|
Specify when Oracle CEP server should close the existing log file and open a new one:
|
|
When you specify |
|
The name of the base log file. Default: |
|
Specify whether or not Oracle CEP server closes the existing log file and creates a new one each time the Oracle CEP server starts up:
|
Log File Severity |
Specify the default log file severity. Oracle CEP server (and, by default, all components), log messages at this severity:
|
Click the Save button to commit your changes.
Using the Oracle CEP Visualizer, you can configure the logging properties of a selected component. To configure logging properties that apply to all components, see Section 3.9.1, "How to Configure the Oracle CEP Server Logging Service".
To configure component logging:
In the left pane, click the Domain > Server node, where Domain refers to the name of your Oracle CEP domain and Server refers to the name of the server instance.
In the right pane, click the Logging tab.
Click the Component Log Setting tab.
The Component Log Setting tab appears as Figure 3-26 show.
To add a component log configuration:
Click Add.
Enter the name of the component in the Name field and select the severity level from the Level drop-down menu.
Click Save.
The component and the severity level is displayed in the table.
To edit an existing component log configuration:
Select the component entry in the table.
Click Edit.
Select the severity level from the Level drop-down menu.
Click Save.
To delete an existing component log configuration:
Select the component entry in the table.
Click Delete.
A confirmation dialog appears as Figure 3-27 shows.
Figure 3-27 Component Log Configuration Delete Confirmation
Click Yes.
Using the Oracle CEP Visualizer, you can run queries on the logs of a selected Oracle CEP server. The Query Logs feature allows you to view the information in the selected log files.
To query logs:
In the left pane, click the Domain > Server node, where Domain refers to the name of your Oracle CEP domain and Server refers to the name of the server instance.
Click Services and then click Log Query.
The Log Query screen is displayed, as shown in Figure 3-28.
Select the following options in the Log Query screen:
LogFile
: Select the log file you want to query from the drop-down.
Severity
: Select the severity of the log file that you selected in the LogFile drop-down.
MaxCount
: Enter the maximum count of rows of log you wish to view for the selected log file.
StartTime
: Select the time when the query should start running.
EndTime
: Select the time when the query should stop.
Click Start Query.
All the log messages that match your query criteria for the selected log file of the selected Oracle CEP Server are displayed in the Logs pane, as shown in Figure 3-29.
Figure 3-29 Log Query Screen - Logs Displayed
If more messages are returned than can be displayed in the Logs pane, the Previous and Next buttons activate. Click the Previous and Next buttons to page through the messages.
Using the Oracle CEP Visualizer, you can view the console output of a selected Oracle CEP server.
To view console output:
In the left pane, click the Domain > Server node, where Domain refers to the name of your Oracle CEP domain and Server refers to the name of the server instance.
Click Services and then click Console Output.
The Console Output screen is displayed, as shown in Figure 3-30.
Figure 3-30 Sample Console Output for HelloWorld Application
Click the Clean Text button to clear the text in the Console Output window.
Click the Pause button to pause the output of console messages.
Click the Resume button to resume the output of console messages.