The Services tab is the primary interface for creating, managing, and viewing the status of the services in the SOA environment and JaxView objects. The Services Object Tree on the left side of the page allows you to manipulate different objects configured in JaxView. Other than administrative operations that are available using the Admin tab, you can use the Services tab to perform all tasks by using the a combination of action menus in the Services object tree and forms in that are displayed in the right side of the page.
Along with managing monitoring and governance objects, the Services tab also provides tables which display the results of the most recent message exchanges between Web service producers and consumers in the SOA environment. This information is displayed in Message lists in the right side panel.
The Services tab is divided in to two main sections. On the left side is the Services object tree that you use to add, edit and navigate the various JaxView object definitions. On the right is a display panel you use to view information about the Web services being managed by JaxView and edit certain configuration settings. The content displayed in the right side panel is determined by the node object that is selected in the Services object tree.
The right side panel of the Services view has four view options that are accessed by view selection tabs along the top of the panel view area. You select a view by clicking on the view name. The following table describes these views.
| Panel | Description |
|---|---|
| Summary | A table displaying a summary of activity for the selected context. This includes the names of services or operations with in the context or node, the throughput for the last hour and the last 6 hours along with the number of faults reported for the last hour and last 6 hours. Other information is displayed depending on the context. This includes expandable sub panels to view summary information for operations exposed by a service. |
| Messages | Displays a table of the most recent message exchanges for the selected context or node. This includes the time that the messages were received, the status based on event notification thresholds for that context, the name of the service and service operation that was accessed, and any client information found in the messages. |
| Faults | Displays a table of the most recent faults for the selected context or node. This includes the time that the fault messages were received, the name of the service operation that was accessed, any fault code that was reported, and fault message information. |
| Policies | Displays a listing of policy settings configured for the
selected context. This includes settings for client athentication,
message modification, message routing, and other optional policies.
The tables in this view include:
See the section Applying Policies to Services in JaxView for more information on policies. |
| Errors | Displays a table of error messages logged by JaxView for the selected context. The errors might include authentication failures, attempts to access blocked services, or connection failures. This errors are only available when JaxView is deployed as a service gateway or proxy. |
The right display panel also displays forms you use to edit settings for the context that is selected in the left Services object tree. The following sections describe how you work with the Services object tree in JaxView.
Services object tree is a dynamic menu that allows you to perform most tasks in the JaxView application. These tasks include, adding, deleting, assigning, editing configuration objects. Each node has a icon which represents the type of object. Each node has an action menu associated with it that you use to manage the JaxView objects. The object tree also provides visual feedback about the status of Web service management object within the hierarchy of each node. The following figure shows an example of the Services object tree and the hierarchy of configuration objects.
The following table is a summary of the node types in the Services object tree with a description of the object and naming conventions.
| Icon | Node Type | Description |
|---|---|---|
|
|
Services Root Node |
The root node for all JaxView configuration objects for the Web services that are being managed by JaxView. |
|
|
Services Group Node |
A virtual container node for visually organizing objects in the Services tree. The name of the node is text entered by the user when creating the group object. |
|
|
Web Service Node |
A node representing a Web service endpoint that is monitored or managed by JaxView. The name will be the Web service as defined in the applicable Web Service Definition Language (WSDL) file. A lock icon |
|
|
Operation Node |
A node representing an service operation at the Web service endpoint that is being managed. The name will be the operation name as defined in the applicable Web Service Definition Language (WSDL) file. |
|
|
Monitor Node |
A node representing a JaxView monitor instance currently assigned to monitor a service operation. The name will be the name of the monitor template object as it appears in the Monitors object tree. |
|
|
Rule Node |
A node representing a JaxView rule assigned to a monitor that defines the logic for event notification action. The name will be the name of the rule definition object as it appears in the Rules object tree. |
|
|
Alert Node |
A node representing a JaxView alert assigned to a monitor that defines event notification action. The name will be the name of the alert definition object as it appears in the Alerts object tree. |
Each object node in the left object tree includes an action menu that you access by selecting the node and then use the right mouse click to display the node action menu. The action menu items vary according to the node type. The following is an example of the action menu for an Operation node in the Services object tree.
The following sections describe the actions available for each node type in the Services object tree.
The Services Root and Group nodes are virtual container objects specific to JaxView. They are used to organize objects used monitor and manage Web services in your environment. The following table describes the action menu items available for for these nodes:
| Object Node | Action Menu Item | Description |
|---|---|---|
|
Services Root node |
Add SOAP Service |
Use this item to add a new SOAP type Web service definition and assign them to group nodes in the Services object tree. See the section Working with Web Services in JaxView for the steps you use to add a SOAP Web service definition to JaxView. Note: Service definitions can only be added after you have created one or more group nodes. |
|
Add REST Service |
Use this item to add a new REST type Web service definition and assign them to group nodes in the Services object tree. See the section Working with Web Services in JaxView for the steps you use to add a REST Web service definition to JaxView. Note: Service definitions can only be added after you have created one or more group nodes. |
|
|
Add Group |
Use this item to create a new Group node as a subgroup to the current node. |
|
|
Delete Multiple Services |
Select this menu item to delete multiple JaxView Web services objects at once. |
|
|
View Faults |
Use this to show a list messages that had a fault which was generated by all operation in the selected Web service. You can see the fault code and fault string for this message |
|
|
Group node |
Edit Group |
Select this item to edit the Group node properties. |
|
Add Subgroup |
Use this item to create a new Group node as a subgroup to the current node. |
|
|
Move Group |
Use this item to move a group folder to be a subgroup within another Group node. |
|
|
Assign Monitors to Group |
Use this item to assign monitors to the operations provided by all Web services defined within this container. |
|
|
Delete |
This item will delete the group container node and all of it contents from the Services object tree. |
The following table describes the action menu items available for Service nodes:
Note: Actions taken using the menu for Service node only apply to configuration objects within JaxView. No changes are propagated to the service producer entities in the SOA environment.
| Object Node | Action Menu Item | Description |
|---|---|---|
|
Service node |
Edit |
Select this menu item to Edit the Service Policies defined for this node. |
|
Move Service to Group |
Use this item to move the current service definition to another Group node in the Services object tree. |
|
|
Assign Monitors To Service |
Use this item to assign monitors to all the operations in this Web Service container |
|
|
Apply Policies To Services |
Use this to apply policies of this Web Service object to a group of services or other services |
|
|
View Faults |
Use this to show a list messages that had a fault which was generated by all operation in the selected Web service. You can see the fault code and fault string for this message |
|
|
Generate Report |
Use this to configure and generate a performance summary report for the monitors within this service node for a specified period of time. The report will be saved and can also be emailed to one or more people. |
|
|
View Reports |
This menu item will show a table which includes a list of all previous dynamically generated reports for the selected service. Clicking on the date link in the report table will show the actual report. |
|
|
Generate Message Report |
Select this menu item to configure and display a listing of all messages recorded by the monitors assigned to this service over a specified period of time. The report may be sent by email. Alternately, specific messages in the report may be saved for use in development, testing, troubleshooting, or SLA management. |
|
|
Generate SLA Report |
Use this to configure and generate a SLA performance summary report for the monitors within this service over a specified period of time. The SLA report will be saved and can also be emailed to one or more people. |
|
|
Reload Web Service |
Click this item to have JaxView reload the Web service definition file for the current service endpoint. |
|
|
Setup Failover |
Use this item to configure a Failover service for the Web service endpoint represented by this service node. See the section on Failover Service With Proxy Configuration for more information. |
|
|
View WSDL |
Use this item to view the contents of the WSDL file for this service. In the case of a REST service this menu item will include information about how JaxView is to connect to the REST service. |
|
|
Publish Policies to Reg |
Select this item to publish service and policy information for a service to a UDDI-compliant registry. You use this option if you have deployed JaxView as a gateway or proxy server for the Web services in your environment. See the section Integrating JaxView with Service Registries for more information. |
|
|
Delete |
Use this to delete the selected service object from the JaxView system. |
The following table describes the action menu items available for Operation nodes:
| Object Node | Action Menu Item | Description |
|---|---|---|
|
Operation node |
Add New Monitor |
Select this menu item to Edit the Service Policies |
|
Assign Monitors |
Assigning monitors to all the operations in this Web Service |
|
|
Generate Report |
Use this to configure and generate a performance summary report for the monitors within this operation node over a specified period of time. The report will be saved and can also be emailed to one or more people. |
|
|
Generate Message Report |
Select this menu item to configure and display a listing of all messages recorded by the monitors assigned to this operation over a specified period of time. |
|
|
Generate SLA Report |
Use this to configure and generate a SLA performance summary report for the monitors within this operation node over a specified period of time. The SLA report will be saved and can also be emailed to one or more people. |
|
|
View Reports |
This item will show a table which includes a list of all previous dynamically generated reports for the selected operation. Clicking on the date link will show the actual report. |
|
|
View Faults |
Use this to show a list messages that had a fault which was generated by the selected operation. The table will display the fault code and fault string for any fault messages. |
|
|
Enable |
Use this to re-enable an operation container that was previously disabled. |
|
|
Disable |
This item will disable message collection for this operaton. |
The action menu items for Monitor nodes in the Services tree are that same actions available in the Monitors object tree. See the Monitors Tab section for a description of these actions.
The action menu items for Monitor nodes in the Services tree are that same actions available in the Monitors object tree. See the Rules Tab section for a description of these actions.
The action menu items for Monitor nodes in the Services tree are that same actions available in the Monitors object tree. See the Alerts Tab section for a description of these actions.
Most nodes on the Services Tree include a status icon, with the exception of the Rule and Alert modes. This allows operators to more easily see the status of systems being monitored and managed by JaxView. In reality only monitors have a status property. Monitor status is propagated to the operation node to which the monitor is assigned. This status is For example, when a message comes into the system for operation 'O' which is part of the Service 'S' a monitor acts on it. Depending on the threshold this monitor will have a status (good, warning, error). This status will propagate to the operation node and the service node. So if the monitor has a status of good the operation will have a status of good and the service will have a status of good. If an operation has a monitor with status of error then it will have a status of error regardless any status the other monitors assigned to the operation might have.
The following gives a description Here is a list of the monitor status icons.
| Icon | Status | Description |
|---|---|---|
|
|
Good |
Operation performance or governance is within the limits defined for this monitor |
|
|
Warning |
Operation performance meets a condition defined for warning |
|
|
Error |
Operation performance or governance is outside the defined limits |
|
|
No Data |
No messages have been received for this operation |
|
|
Disabled |
Monitoring has been disabled |
There is more on how the status of the monitor is set in the threshold section.
next to a Web Service node indicates that security policies are
in force for that service. See the section
