Skip Headers
Oracle® Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle Business Process Management Suite
11g Release 1 (11.1.1.7)

Part Number E10226-20
Go to Documentation Home
Home
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

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

22 Monitoring Human Workflow Service Components and Engines

This chapter describes how to monitor human task service components and the human workflow service engine, including monitoring workflow service component and service engine instances and faults, viewing task status, monitoring active requests and operation performance statistics, and monitoring deployed human workflows.

This chapter includes the following sections:

For more information, see the following sections:

22.1 Monitoring Recent Human Task Service Component Instances and Faults

You can monitor recent instances and faults for human task service components. Each service component in a SOA composite application has its own instance ID. These IDs are different from the overall instance ID of the SOA composite application of which each service component is a part.

To monitor human task service component instances and faults:

  1. Access this page through one of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Select Home.

    2. Select the Deployed Composites tab.

    3. In the Composite section, select a specific SOA composite application.

    1. Under soa-infra, select a specific SOA composite application.


  2. Select the human task service component in the Component Metrics table.

    The upper part of the Dashboard page displays the following details:

    • Recent instances of the human task service component, including the instance ID of the service component, the state of the instance (for example, completed or running), the instance start time, the last modification time, and links to log files describing the instances.

    • Recent faults in the human task service component, including the error message, whether the fault is recoverable, the time at which the fault occurred, the instance ID of the human task service component, and links to log files describing the faults.

    Description of hwf_comp_dash_upper.gif follows
    Description of the illustration hwf_comp_dash_upper.gif

  3. In the Recent Instances section, perform the following tasks:

    1. In the Instance ID column, click an instance ID for a service component to monitor the current status of a task on which approval actions are being taken.

    2. In the Logs column, click a specific log to access the Log Messages page with filtered messages specific to that instance.

    3. Click Show More below the section to access the Instances page of the service component.

  4. In the Recent Faults section, perform the following tasks:

    1. In the Error Message column, click an error message to display complete information about the fault. If the fault is identified as recoverable, click the Recover Now link to perform fault recovery.

    2. In the Recovery column, click a fault identified as Recoverable to perform fault recovery at the component instance level.

    3. In the Logs column, click a specific log to access the Log Messages page with filtered messages specific to that instance.

    4. Click Show More below the section to access the Faults page of the service component.

    The lower part of the Dashboard page displays the following details:

    • A graphical representation of business outcomes.

    • Assignees that take the longest time to respond to and act upon tasks.

    • The number of successful, faulted, and instantiated instances processed per minute. Click Table View to display throughput details for the last five minutes, including the throughput for successful instances, the total faults throughput, and the instance throughput.

    • The notification channels used for task approval in the human task service component.

    Description of hwf_comp_dash_lower.gif follows
    Description of the illustration hwf_comp_dash_lower.gif

For more information, see Section 1.2.3, "Introduction to SOA Composite Application Instances" and Oracle Fusion Middleware Administrator's Guide for details about viewing and searching log files.

22.2 Viewing the Status of Human Workflow Tasks

You can monitor the current status of human workflow tasks being acted upon by participants.

To view the status of human workflow tasks:

  1. Access this page through one of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Select Home.

    2. Select the Deployed Composites tab.

    3. In the Composite section, select a specific SOA composite application.

    1. Under soa-infra, select a specific SOA composite application.


  2. Select the human task service component in the Component Metrics table.

    The Dashboard page appears.

    Description of hwf_comp_dash_upper.gif follows
    Description of the illustration hwf_comp_dash_upper.gif

  3. In the Instance ID column, click an instance ID of a service component to monitor the current status of a task on which approval actions are being taken.

    The Task Details page displays the following details:

    • Task details about the selected service component instance ID (task number), including the current state (for example, assigned), task outcome (if completed), task priority, creation date, updated date, expiration date, and task assignee.

    • A flow of the current status of a task (for example, assigned or approved).

    Description of hwf_mon_taskdetails.gif follows
    Description of the illustration hwf_mon_taskdetails.gif

    As the task is acted upon by participants, the flow is updated.

    Description of hwf_mon_taskdetails2.gif follows
    Description of the illustration hwf_mon_taskdetails2.gif

  4. In the upper right-hand corner of the page, click Worklist Application to access the login page for Oracle BPM Worklist.

For more information, see Section 1.2.3, "Introduction to SOA Composite Application Instances."

22.3 Monitoring Human Task Service Component Instances

You can monitor human task service component instances. Each service component has its own unique instance ID. This ID is in addition to the instance ID of the overall SOA composite application of which this service component is a part.

Note:

Human workflow invocations from the BPEL service engine use different transactions than BPEL processes. Therefore, if a BPEL transaction is rolled back for any reason, the workflow task instances are still created.

To monitor human task service component instances:

  1. Access this page through one of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Select Home.

    2. Select the Deployed Composites tab.

    3. In the Composite section, select a specific SOA composite application.

    1. Under soa-infra, select a specific SOA composite application.


  2. Select the human task service component in the Component Metrics table.

  3. Click Instances.

    The Instances page displays the following details:

    • A utility for searching for a specific human task service component instance by specifying criteria and clicking Search. By default, instances are not displayed the first time you access this page. You must click Search to display any instances.

    • Instances, including the instance ID of the service component, the state of the instance (for example, completed successfully or faulted), the instance start time, the last modification time, and links to log files describing the instance.

    Description of hwf_comp_instances.gif follows
    Description of the illustration hwf_comp_instances.gif

  4. In the Instance ID column, click a specific ID for a service component to monitor the current status of a task on which approval actions are being taken.

  5. In the Logs column, click a specific log to access the Log Messages page with filtered messages specific to that instance.

For more information, see Section 1.2.3, "Introduction to SOA Composite Application Instances" and Oracle Fusion Middleware Administrator's Guide for details about viewing and searching log files.

22.4 Monitoring Human Workflow Service Engine Recent Instances and Faults

You can monitor instances and faults of all human task service component instances running in the human workflow service engine. These human task service components can be part of separate SOA composite applications.

To monitor human workflow service engine instances and faults:

  1. Access this page through one of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Select Service Engines > Human Workflow.

    1. Right-click soa-infra.

    2. Select Service Engines > Human Workflow.


  2. Click Dashboard.

    The upper part of the Dashboard page displays the following details:

    • Recent instances of all human task service components running in the human workflow service engine, including the instance ID of the service component, the service component, the SOA composite application of which the service component is a part, the state of the instance (for example, completed, running, or faulted), the instance start time, and the last modification time.

    • Service components, including the service component name, SOA composite application, state of the service component, and total, running, and faulted instances.

    Description of hwf_se_dash_upper.gif follows
    Description of the illustration hwf_se_dash_upper.gif

  3. In the Recent Instances section, perform the following tasks:

    1. In the Instance ID column, click an instance ID for a service component to monitor the current status of a task on which approval actions are being taken.

    2. In the Component column, click a specific service component to access its home page.

    3. In the Composite column, click a specific SOA composite application to access its home page.

    4. In the Logs column, click a specific log to access the Log Messages page with filtered messages specific to that instance.

    5. Click Show More below the section to access the Instances page of the service engine.

  4. In the Components section, perform the following tasks:

    1. In the Name column, click a specific service component to access its home page.

    2. In the Composite columns, click a specific SOA composite application to access its home page.

    3. Click Show More below the section to access the Deployed Components page of the service engine.

    The lower part of the Dashboard page displays the following details:

    • Recent faults, including the error message, the time at which the fault occurred, the SOA composite application, the service component, and the service component instance ID.

    • Task assignees who take the longest time to act upon a task and who have the highest backlog of pending tasks to which to respond.

    Description of hwf_se_dash_lower.gif follows
    Description of the illustration hwf_se_dash_lower.gif

  5. In the Recent Faults section, perform the following additional tasks:

    1. In the Error Message column, click an error message to display complete information about the fault. If the fault is identified as recoverable, click the Recover Now link to perform fault recovery. Clicking this link invokes the human workflow audit trail page for the instance. The audit trail page has a link to Oracle BPM Worklist called Go to Worklist Application, where you can go to recover from the fault. This link does not take you directly to the fault; you must manually locate the fault.

    2. In the Recovery column, click a fault identified as Recoverable to perform fault recovery at the component instance level.

    3. In the Logs column, click a specific log to access the Log Messages page with filtered messages specific to that instance.

    4. Click Show More below the section to access the Faults page of the service engine.

22.5 Monitoring Human Workflow Service Engine Active Requests and Operation Performance Statistics

You can view details about active requests in the human workflow service engine and operational statistics. such as service used, operations performed, and active and completed requests.

To monitor human workflow service engine active requests and operation statistics:

  1. Access this page through one of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Select Service Engines > Human Workflow.

    1. Right-click soa-infra.

    2. Select Service Engines > Human Workflow.


  2. Click Statistics.

    The Statistics page displays the following details:

    • Active requests in the service engine. Use this graph to get an idea of the current service engine load. Only under extreme load conditions is there data shown in the graph. This is because most requests are processed instantaneously by the service engine. The data is collected by a Dynamic Monitoring Service (DMS) state sensor. Once the requests are processed by the service engine, the count goes to zero. This action enables you to know the current load on the service engine (for example, if it is too high).

    • Average request message processing time in the service engine since the last startup of the SOA Infrastructure. Use this graph to check service engine performance. While the processing time is calculated based on the last startup of the SOA Infrastructure, the data that is displayed in the graph is gathered only from the time at which you first accessed this page. The graph does not continue calculating and displaying data if you have not accessed this page. The DMS phase event sensor calculates the average request processing time and provides the processing time data.

    • Operation statistics about human workflow services used in the service engine, including the human workflow service used, the operation performed by the service, the number of active and completed requests, the count, and the average processing time.

    Description of hwf_se_stats.gif follows
    Description of the illustration hwf_se_stats.gif

    For more information, see the following documentation:

22.6 Monitoring Human Workflow Service Engine Instances

You can monitor all human task service component instances running in the service engine. These human task service components can be part of separate SOA composite applications.

To monitor human workflow service engine instances:

  1. Access this page through one of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Select Service Engines > Human Workflow.

    1. Right-click soa-infra.

    2. Select Service Engines > Human Workflow.


  2. Click Instances.

    The Instances page displays the following details:

    • A utility for searching for a specific instance by specifying criteria and clicking Search. By default, instances are not displayed the first time you access this page. You must click Search to display any instances.

    • Instances, including the instance ID of the service component, the service component, the SOA composite application of which the service component is a part, the state of the instance (for example, completed, running, or faulted), the instance start time, the last modification time, and links to log files that describe the instance.

    Description of hwf_se_instances.gif follows
    Description of the illustration hwf_se_instances.gif

  3. In the Instances section, perform the following additional tasks:

    1. In the Instance ID column, click an instance ID for a service component to monitor the current status of a task on which approval actions are being taken.

    2. In the Component column, click a specific service component to access its home page.

    3. In the Composite column, click a specific SOA composite application to access its home page.

    4. In the Logs column, click a specific log to access the Log Messages page with filtered messages specific to that instance.

For more information, see Section 1.2.3, "Introduction to SOA Composite Application Instances" and Oracle Fusion Middleware Administrator's Guide for details about viewing and searching log files.

22.7 Monitoring Deployed Human Workflows in the Service Engine

You can monitor all deployed SOA composite applications with human task service components running in the service engine.

To monitor deployed human workflows in service engines:

  1. Access this page through one of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Select Service Engines > Human Workflow.

    1. Right-click soa-infra.

    2. Select Service Engines > Human Workflow.


  2. Click Deployed Components.

    The Deployed Components page displays the following details:

    • A utility for searching for a specific deployed SOA composite application by specifying the full name and clicking Search.

    • Details about deployed human task service components running in this service engine, including the service component name, the SOA composite application, the current status, and the number of total, faulted, and running instances.

    Description of hwf_se_deployedcomps1.gif follows
    Description of the illustration hwf_se_deployedcomps1.gif

  3. In the Name column, click a specific service component to access its home page.

  4. In the Composite column, click a specific SOA composite application to access its home page.