|
Oracle® BPEL Process Analytics User's Guide
10g Release 2 (10.1.2) Part No. B15597-01 |
|
 Previous |
 Next |
|
Oracle® BPEL Process Analytics User's Guide
10g Release 2 (10.1.2) Part No. B15597-01 |
|
|
Previous |
Next |
The Oracle BPEL Process Analytics administrator configures the Dashboard using the Dashboard Configuration Console section of the Admin Console. The Dashboard Configuration Console allows the administrator to configure page layout and the content of Dashboard pages. If you are reading this chapter, it is assumed that you are an Oracle BPEL Process Analytics administrator.
This chapter includes the following topics:
The Dashboard consists of a number pages that present modeled data. Each page presents one type of modeled data (composite events, KPIs, metrics, or alerts) in a variety of tables and charts.
Figure 3-1 shows a sample Dashboard page containing a table of alerts and two KPI charts. Metrics are presented in similar pages. A Dashboard page that presents KPIs or metrics can contain up to two columns of view panes and an unlimited number of rows. A view pane is the part of the page in which a table or chart is presented. Figure 3-1, for example, shows three view panes: Alert View, Loan Requests by Car Make Model Today, and Avg Approval time by Car Make Model Today.
Figure 3-2 shows a sample Dashboard page containing the Real-Time Viewer. The Real-Time Viewer provides a chart that displays composite event instances, in real-time and a table that summarizes the state of the composite events. (Complete information on reading the data presented in the Real-Time Viewer is presented in "Viewing Events and Composite Event Instances".)
When you configure the Dashboard for a user, you can create custom pages, for which you specify the contents and layout, use the default pages provided by Oracle BPEL Process Analytics, or both.
The default pages, described in detail in "Default Dashboard Pages" are:
Real-Time Viewer
Default KPI View
Default Metric View
These default pages are intended to make it easy for you to get started with Dashboard configuration.
You might want to begin Dashboard configuration by using the default pages, and then create customized pages as you get more familiar with the data being returned and the data desired by Dashboard users.
After you have created customized Dashboard pages, or have decided to use the default pages, you assign the Dashboard pages to user accounts. A user will not be able to view a Dashboard page until it is assigned to that user's account. See "Assigning Default and Customized Dashboard Pages to a User Account" for more information.
Oracle BPEL Process Analytics provides four view pane types for displaying data in Dashboard pages, as described in the following topics:
As shown in Figure 3-3, Oracle BPEL Process Analytics provides the following types of view panes for displaying KPI data in the dashboard:
This view type includes multiple KPIs over a single time period or time interval presented in a pie chart, vertical bar chart, horizontal bar chart, radar chart, gauge chart, or a table.
This view type includes multiple KPIs over two or three time periods presented in a vertical bar chart, horizontal bar chart, radar chart, gauge chart, or a table.
This view type includes one KPI data series over time presented in a bar chart (clustered or stacked), line chart, or area chart.
This view type includes multiple KPI data series over time presented in a bar chart (clustered or stacked), line chart, or area chart.
This view type includes a single KPI over time with both actual and target values, presented in a combination bar-line chart or a table of actual and target values. In the combination bar-line chart, actual data is presented as bars, and target data is presented as points connected by a line.
This view type lists cause and effect KPIs for the specified KPI in a table.
As shown in Figure 3-4, Oracle BPEL Process Analytics provides the following types of view panes for displaying metric data in the Dashboard:
Bar
This view type includes multiple metrics over a single time period or time interval, presented in a clustered or stacked bar chart.
Line
This view type includes multiple metrics over a single time period or time interval, presented in a line chart.
Area
This view type includes multiple metrics over a single time period or time interval, presented in an area chart.
Table
This view type includes multiple metrics over a single time period or time interval, presented in a table.
Point
This view type includes multiple metrics over a single time period or a time interval, presented as points in a chart.
Alert view panes display KPI and Metric alerts in a table, which provides each alert name, alert type, and the time at which each alert was sent, as shown in Figure 4-28. Alert View Panes are configured by default. As the administrator, you can specify whether or not to include the Alert View pane in a Dashboard page, but you cannot control which alerts are included in the display.
A pending composite event is one for which an end event has not yet been received and that has not timed out. In Figure 3-2, the last six composite events displayed in the chart are pending composite events (assuming they have not timed out.)
A pending activities view pane shows the following statistics on composite event instances that are pending:
Last pending pie chart
A pie chart is presented to show what percentage of each event instance contained in a specified composite event is considered to be the last pending. An event in a composite event instance is considered to be the last pending if it is the most recently received event within the composite event instance and the composite event has not timed out. For example, the LoanFlow composite event contains these events, which occur in the sequence shown, where LoanOfferResponse is the end event:
LoanRequest
LoanRequestApproved
LoanOfferSelected
LoanOfferResponse
Assume that for the current time period, 10 composite event instances are pending, with the totals for the most recently received events (last pending) as follows:
LoanRequest - 5
LoanRequestApproved - 3
LoanOfferSelected - 2
In other words, for the 10 incomplete composite event instances, five have just completed the LoanRequest event; three have completed the LoanRequest event and the LoanRequestApproved event; and two have completed the LoanRequest event, the LoanRequestApproved event, and the LoanOfferSelected event. The LoanOfferResponse event is not considered, because it is an end event and receipt of that event indicates that the composite event is no longer pending.
Thus, the pie chart for this example would consist of three wedges. The LoanRequest event would be represented by 50% of the pie; the LoanRequestApproved event would be represented by 30% of the pie; and the LoanOfferSelected event would be represented by 20% of the pie.
Duration bar chart
A bar chart is presented to show the duration for each event in a pending composite event instance. (This corresponds to the Duration column in the table presented in Figure 3-2.) The duration for an event is defined as the average time between the specified event and the previous event in the sequence.
For example, assume the sequence shown for the last pending example, and assume the bar chart shows the following values:
LoanRequest - 00:00:00
LoanRequestApproved - 00:01:31
LoanOfferSelected - 00:00:53
LoanOfferResponse - 00:00:30
These values indicate that, on average, the time between a LoanRequest event occurring and a LoanRequestApproved event occurring is 1 minute, 31 seconds; the average time between a LoanRequestApproved event occurring and a LoanOfferSelected event occurring is 53 seconds; and the average time between a LoanOfferSelected event occurring and a LoanOfferResponse event occurring is 30 seconds.
|
Note: The duration bar chart is only presented when the layout of the Pending Activities view pane is specified as full-width. When the layout is specified as half-width, only the last pending pie chart is displayed. See "Specifying the Page Layout for Custom Dashboard Pages" for more information on view pane widths. |
Figure 3-5 provides an example of a full-width Pending Activities view pane.
By default, Oracle BPEL Process Analytics provides the following preconfigured pages:
This page contains a chart and table of composite event instances, as shown in Figure 3-2. All adjustments to the Real-Time Viewer are made by the Dashboard user when viewing the Real-Time Viewer page. Adjustments that the Dashboard user can make include the following:
The composite event or group to display
The dimension, if any, that should be used to separate the presentation of events
The events to display, based on their current state
The window of time over which events are to be displayed
Whether or not lines connecting composite events should be included in the chart
|
Note: If given access to the Real-Time Viewer, a Dashboard user can view all composite events underlying the modeled KPIs and metrics. If granting this level of access to a given Dashboard user is considered a security risk, you should not grant that Dashboard user access to the Real-Time Viewer. |
This page displays all of the KPIs in various view panes. If possible, one pane of each view pane chart is displayed. In addition, one view pane is a multi-KPI chart (if more than one KPI exists that share a dimension), and another view pane is a full-width table containing multiple KPIs for a single composite event.
Adjustments that the Dashboard user can make to a Default KPI View differ depending on the view pane type, but in general, adjustments involve choosing KPIs and dimension columns for the view pane. Each view pane in the KPI view allows navigation to the KPI detail page. Charts that display KPIs across different dimension values provide links to view a lower level of the hierarchy (if the displayed dimension column is not the lowest level of the dimension hierarchy). Dimensional drill-downs are displayed in the KPI detail page.
This page contains one view pane for each event type on which a metric is defined. All metrics, except those that are of type TEXT, are graphed. A table presented as a full-width view pane includes all metrics.
Metrics are displayed in chronological order. Dashboard users can adjust a metric view pane by specifying the number of metrics to display in the chart or table, or by specifying a begin and end date for the time span to include.
Minimally, you must assign one or more default Dashboard pages to an account for a Dashboard user with access to that account to view those pages. See "Assigning Default and Customized Dashboard Pages to a User Account" for more information.
If you want to design custom Dashboard pages for an account, follow these steps:
Design customized view panes and dashboard pages for the user, as described in "Designing Customized View Panes and Dashboard Pages".
Assign the customized Dashboard pages to a user account, as described in "Assigning Default and Customized Dashboard Pages to a User Account".
See "Refining Custom and Default Dashboard Pages" for addition options that Oracle BPEL Process Analytics offers for configuring Dashboard pages.
To design customized dashboard pages, you must first specify each of the panes that will be presented in those pages. The following topics provided step-by-step instructions:
Designing KPI view panes for a user involves selecting the type of chart or table in which you want data presented, specifying whether you want the KPI view pane presented in a half-width view pane or a full-width view pane, selecting the KPIs you want to display in the table or chart, and selecting which dimensions (if any) you want to include in the table or chart. (See "Specifying the Page Layout for Custom Dashboard Pages" for information about specifying half-width and full-width view panes.)
Before you an design KPI view panes, you must have created the user and assigned KPIs to that user. See "Creating and Managing User Accounts" for more information.
To design a KPI view pane for a user:
In the Admin Console, click Dashboard Configuration.
In the Users table, click the pencil icon corresponding to the user for whom you want to configure a KPI view pane.
Click the Create button associated with the KPI View Panes table to open the Create View Pane Wizard.
Follow the steps through the wizard. If you need help using a wizard page, click the Help link on that page.
Designing Metric view panes for a user involves selecting the type of chart or table in which you want metrics presented; specifying a name for the view pane, a name for the chart or table that will be presented in the view pane, specifying whether you want the Metric view pane presented in a half-width view pane or a full-width view pane, and selecting the metrics you want to display in the table or chart. (See "Specifying the Page Layout for Custom Dashboard Pages" for information about specifying half-width and full-width view panes.)
Before you can design Metric view panes, you must have created the user and assigned metrics to that user. See "Creating and Managing User Accounts" for more information.
To design a Metric view pane for a user:
In the Admin Console, click Dashboard Configuration.
In the Users table, click the pencil icon corresponding to the user for whom you want to configure the Metric view pane.
Click the Create button associated with the Metric View Panes table. The Create Metric View Pane Wizard opens.
Follow the steps through the wizard. If you need help using a wizard page, click the Help link on that page.
Specifying Pending Activities view panes for a user involves specifying a name for the view pane and a name for the chart that will be presented in the view pane, specifying whether you want the view pane presented in a half-width view or a full-width view, and selecting the composite event you want to display in the chart (See "Specifying the Page Layout for Custom Dashboard Pages" for information about specifying half-width and full-width view panes.)
See "Pending Activities View Panes" for a description of the values presented in a Pending Activities view pane.
To design a Pending Activities view pane for a user:
In the Admin Console, click Dashboard Configuration.
In the Users table, click the pencil icon corresponding to the user for whom you want to configure the Pending Activities view pane.
Click the Create button associated with the Pending Activities view panes table. The Create Pending Activities View page opens.
In the Enter View Pane Name field, enter a unique name for view pane.
In the Enter Chart Title field, enter a title for the chart.
From the Choose Chart Width box, select a width for the view pane.
From the Select Composite Event box, select the composite event for which you want to display statistics in the chart.
Click Apply. The Dashboard Configuration Console page opens.
Once view panes are defined, you can specify how you want them presented on Dashboard pages. Typically, several view panes are presented on a Dashboard page, as described in "Specifying the Page Layout for Custom Dashboard Pages".
When you specify the Dashboard page layout, you can indicate whether or not the Alert View table and the Pending Activities view pane will be included in the Dashboard page. The Alert View table is presented as a full-width table by default.
To design a Dashboard page:
In the Admin Console, click Dashboard Configuration.
In the Users table, click the pencil icon corresponding to the user for whom you want to configure the Dashboard page.
Click the Create button associated with the Dashboard Pages table to open the Create Dashboard Page Wizard.
Follow the steps through the wizard. If you need help using a wizard page, click the Help link on that page.
When you configure custom pages, you can set the view panes within it as either half width or full width. Half-width view panes are presented in two columns; full-width view panes span two columns. For example, you can construct a view to contain two rows of half-width panes, and one row with a full-width pane, as shown in Figure 3-6.
Dashboard pages must be assigned to a user account before they are visible to users who have been granted access to that account. Each Dashboard page can be assigned to one and only one Oracle BPEL Process Analytics user. However, you can specify a JAAS provider to specify users and classes of users to which Dashboard access is granted, so that you do not have to create Dashboard pages for each Dashboard user. See "User Management for Oracle BPEL Process Analytics Console Access" for more information.
To assign Dashboard pages:
In the Admin Console, click Dashboard Configuration.
In the Users table, click the pencil icon corresponding to the user for whom you want to assign Dashboard views.
Click Assign/Unassign.
Move the Dashboard views from the Available box to the Assigned box, to specify the pages you want to assign to the user.
Click Apply.
|
Note: If given access to the Real-Time Viewer, a Dashboard user can view all composite events underlying the modeled KPIs and metrics. If granting this level of access to a given Dashboard user is considered a security risk, you should not grant that Dashboard user access to the Real-Time Viewer. |
You can make refinements to both custom and default dashboard pages to specify colors used for presenting dimensions in the Dashboard, the Dashboard screen size, and the Dashboard brand icon. Step-by-step instructions on making these refinements are described in the following topics:
The Dashboard Configuration Console offers a control to specify the Dashboard screen size resolution, so that view panes can be optimized for presentation in that screen size resolution. The Dashboard screen size resolution is set for all Dashboard users, not on a per-user basis. Therefore, specify a screen size resolution setting that will work for all your Dashboard users.
To set the Dashboard screen size resolution:
In the Admin Console, click Dashboard Configuration to open the Dashboard Configuration Console.
Click Change Target Screen Size.
Select a screen size resolution that best represents the screen size that your Dashboard users have. The choices are:
800 x 600 pixels
1024 x 768 pixels
1280 x 1024 pixels
Optionally, scroll down the see how the charts will look using the various resolutions.
Click Set Target Screen Size.
By default, when a dimension is created, Oracle BPEL Process Analytics assigns a color to the dimension, and represents each value for that dimension with a different shade of the assigned color.
|
Note: If a new value for a dimension is returned after the dimension has been defined and colors have been specified for its values (either explicitly by you, or by default), that value will have a light blue color assigned to it automatically.For instance, assume you have defined a CarModel dimension and have loaded these dimension values: Toyota, Saturn, Nissan, and Ford. The dimension color map is initialized with this data, and either you or Oracle BPEL Process Analytics specify colors for those four car models. Now, if a new car model, Honda, is returned in an event, there is no color assigned to it, so Oracle BPEL Process Analytics uses a default color of light blue to represent Honda in charts that display the CarModel dimension. In such a situation, you can use the steps described in "Mapping Dimension Color Values" to set the color for the new dimension, as desired. |
If desired, you can override the default and specify the colors you want the Dashboard to use for each dimension that it presents in a chart in a view pane. (Colors used for KPI detail pages are determined by Oracle BPEL Process Analytics and cannot be altered.) You can perform this step before or after you assign Dashboard pages to a user.
Before you change the default, or currently assigned color values, you can preview them in a sample pie chart and bar graph.
The following topics describe how to perform these tasks:
The following list provides the steps for previewing dimension color values:
In the Admin Console, click Dashboard Configuration to open the Dashboard Configuration Console.
Click Edit Dimension Colors to open the Edit Dimension Colors page. Note that the Sample Charts contain no data, as shown in Figure 3-7.
Click Expand All. The dimension columns are displayed.
Click the name of the column for which you want to preview dimension color values. The Sample Charts display the current colors assigned to that column.
Figure 3-8 provides an example of how the Sample Charts appear when the CarMakeModelID column in Figure 3-7 is clicked.
The following list provides the steps for mapping dimension color values:
In the Admin Console, click Dashboard Configuration to open the Dashboard Configuration Console.
Click Edit Dimension Colors to open the Edit Dimension Colors page.
Expand the navigation tree to display the dimension for which you want to set color values.
Select a dimension value from the navigator tree, and then either click a color in the Color Palette, or enter the hexidecimal RGB value for the color in the Color box.
Click Apply Color.
When you click Apply Color, the page refreshes and displays the color you selected in a pie chart and a bar chart to give you an opportunity to see how the selected color appears beside other dimension colors.
Repeat steps 4 and 5 for each dimension value in the dimension, or until the colors for each dimension suit your needs.
Click OK. The Dashboard Configuration Console page opens.
By default, the brand icon that appears at the top of each Dashboard page is BPA Dashboard. If desired, you can change the brand icon to an icon of your choice.
To assign a Dashboard brand icon:
In the Admin Console, click Dashboard Configuration.
Click Change Brand Icon. The Dashboard Configuration: Brand Icon page opens.
In the File Name field, specify the path and file name of the image that you want to replace the default icon.
Click Apply.
If you have previously replaced the default Dashboard Brand Icon (which is a graphic with the text BPA Dashboard), and you want to restore the default icon, follow these steps:
In the Admin Console, click Dashboard Configuration.
Click Change Brand Icon. The Dashboard Configuration: Brand Icon page opens.
Click Restore Default Brand Icon.
Click Apply.
