Implementation Guide
Version 8.1
Date: 04-2009
Date: 04-2009
Copyright 2009, CA. All rights reserved. Wily Technology, the Wily Technology Logo, Introscope, and All Systems Green are registered trademarks of CA. Blame, Blame Game, ChangeDetector, Get Wily, Introscope BRT Adapter, Introscope ChangeDetector, Introscope Environment Performance Agent, Introscope ErrorDetector, Introscope LeakHunter, Introscope PowerPack, Introscope SNMP Adapter, Introscope SQL Agent, Introscope Transaction Tracer, SmartStor, Web Services Manager, Whole Application, Wily Customer Experience Manager, Wily Manager for CA SiteMinder, and Wily Portal Manager are trademarks of CA. Java is a trademark of Sun Microsystems in the U.S. and other countries. All other names are the property of their respective holders. For help with Introscope or any other product from CA Wily Technology, contact Wily Technical Support at 1-888-GET-WILY ext. 1 or support@wilytech.com. If you are the registered support contact for your company, you can access the support Web site directly at www.ca.com/wily/support. We value your feedback Please take this short online survey to help us improve the information we provide you. Link to the survey at: http://tinyurl.com/6j6ugb If you have other comments or suggestions about Wily documentation, please send us an email at wily-techpubs@ca.com.
US Toll Free 888 GET WILY ext. 1 US +1 630 505 6966 Fax +1 650 534 9340 Europe +44 (0)870 351 6752 Asia-Pacific +81 3 6868 2300 Japan Toll Free 0120 974 580 Latin America +55 11 5503 6167 www.ca.com/apm
CONTENTS
Table of Contents
Chapter 1
Introducing CA Wily Introscope SOA Performance Management 11 About SOA and web services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 13 16 17 18 21 21 21 23 How Introscope SPM helps you manage SOA-based applications About what Introscope SPM monitors . Introscope SPM components . . . . How Introscope SPM monitors SOA-based applications . Introscope SPM components for monitoring OSB . Capabilities of Introscope SPM by component . Additional Introscope documentation . . . . . . . . . .
Chapter 2
Installing and configuring Introscope SPM Introscope SPM installation overview . . . . . . Hardware and software requirements .
. 25 . . . . . . . . . . . . . . . . 26 26 27 27 29 29 31 32 34 34 35 38 39 40 42 47
Installation machine and directory names with documentation conventions . . . . . . . . . . . . . . . . . . Introscope SPM install prerequisites Installation prerequisite checklists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Extracting Windows, Unix, and z/OS Java Agent extensions . Configuring Introscope SPM Java Agent extensions . Uninstalling Introscope SPM Java Agent extensions . Configuring Introscope SPM .NET Agent extensions Uninstalling Introscope SPM .NET Agent extensions .
Contents iii
. . . . . .
. . . . . . .
. . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
50 53 53 54 55 56 56 59
Configuring Introscope SPM EM extensions . Uninstalling Introscope SPM EM extensions . Verifying your deployment . . . . . . .
Configuring virtual agents for Introscope SPM . Agent and EM extension debugging options . Uninstalling Introscope SPM . . . . . .
Installing and configuring Introscope SPM OSB Agent and EM extensions 60 Downloading and extracting the Introscope SPM OSB installation archive . . . . . . . . . . . . . . . . . . . . . Extracting Introscope SPM OSB Agent extensions . Configuring Introscope SPM OSB Agent extensions Uninstalling Introscope SPM OSB Agent extensions Extracting Introscope SPM OSB EM extensions . Uninstalling Introscope SPM OSB EM extensions Verifying your Introscope SPM OSB deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 63 64 65 66 68 68 69 70 72 75 78 79 81 82 84 85 87
Installing and configuring Introscope SPM WPS/WESB Agent and EM extensions . . . . . . . . . . . . . . . . . . . . . Downloading and extracting the Introscope SPM WPS/WESB installation archive . . . . . . . . . . . . . . . . Extracting Introscope SPM WPS/WESB Agent extensions Configuring Introscope SPM WPS Agent extensions Uninstalling Introscope SPM WPS Agent extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuring Introscope SPM WESB Agent extensions . Uninstalling Introscope SPM WESB Agent extensions . Extracting Introscope SPM WPS EM extensions . Uninstalling Introscope SPM WPS EM extensions . . . . .
Extracting and configuring Introscope SPM WESB EM extensions. Uninstalling Introscope SPM WESB EM extensions .
Extracting and configuring WPS and WESB EM extensions on the same Enterprise Manager or MOM . . . . . . . . . . . . . . 88 Verifying your Introscope SPM WPS deployment . . . . . . . . . . . . . 89 90 Verifying your Introscope SPM WESB deployment .
iv Contents
Implementation Guide
Chapter 3
. .
. .
. . . . .
. . . . . .
. . . . . .
. . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . .
. 93 . . . . . 94 95 95 96 99
Viewing web services data in Introscope SPM . Starting the Introscope Workstation . SOA Performance Management dashboards . Introscope SPM Client Health dashboard . Introscope SPM Server Health dashboard .
. 100 . 101 . 102 . 104 . 105 . 105 . 110 . 114 . 118 . 124 . 125 . 126 . 128 . 128 . 129 . 132 . 134 . 135 . 138 . 138 . 140 145
Introscope SPM Most Critical Operations dashboard . Introscope SPM Busiest Operations dashboard . SOA Performance Management tabs Using the Overview tabs . . . . . . . . . . . . . . . Using the Dependencies tabs . About the Dependencies tab Using the Deviations tab . . Using the Most Critical tab . Using the Errors tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Viewing web service metrics in the Investigator About Introscope SPM metrics . About error and SOAP fault metrics . Viewing agent web service metrics . About the web service name node About the operation name node . Interpreting alert states . . . .
Viewing Introscope SPM metric groupings and alerts. Checking the health of your web services Chapter 4
Using SOA Dependency Map to triage web service problems Getting to know the SOA Dependency Map . SOA Dependency Map Concepts . SOA Dependency Map components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
How Investigator tree nodes relate to SOA Dependency Map nodes . 155 How Introscope SPM creates the SOA Dependency Map . About how the SOA Dependency Map is saved . . . . . About SOA Dependency Map node aging and removal
Contents v
. 159
Setting Introscope SPM metrics to display on the SOA Dependency Map . . . . . . . . . . . . . . . . . . . . . . . 159 Choosing a SOA Dependency Map content type Choosing a SOA Dependency Map view . . . . . . . . . . . . . . . . . . 161 . 166
Using SOA Dependency Map views and content types to solve your problems . . . . . . . . . . . . . . . . . . . . . 167 Navigating the SOA Dependency Map . Unrolling dependencies levels . . . . . Rolling up to hide dependencies . Showing all services for an agent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 . 169 . 169 . 170 . 170 . 171 . 171 . 172 . 174 . 176 . 177 . 179 . 179 . 180 . 180 . 184 185 . 186 . 190 . 196 . 198 . 201 . 203 . 204 209 . 210
Jumping from a SOA Dependency Map node to the associated Investigator tree node . . . . . . . . . . . . . . Panning, zooming, and fitting the SOA Dependency Map MOM SOA Dependency Map. . . . . . . . . . . . . . .
Reloading SOA Dependency Map upon discovery of new services and operations . . . . . . . . . . . . . . . . . . Using the SOA Dependency Map for triage . Disconnected agents are grayed out. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Outputting SOA Dependency Map images for sharing .
How renaming an agent updates the SOA Dependency Map SOA Dependency Map FAQs . . . . . . . . . . . . . . . . . . .
Starting a Transaction Trace session from SOA Dependency Map About Introscope SPM logical equivalence Chapter 5
Using Transaction Tracing to triage web service problems About Introscope SPM cross-process transaction tracing Following an Introscope SPM transaction . Introscope SPM filters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using cross-process transaction tracing to solve difficult problems . 188 Filtering Introscope SPM Transaction Traces .
Viewing correlated events using Transaction Tracer . Viewing web service data with Transaction Tracer. Viewing web service faults in ErrorDetector . Chapter 6 Monitoring Oracle Service Bus (OSB) . Using Introscope SPM to monitor OSB . . . . . . . .
vi Contents
Implementation Guide
. .
. .
. .
. .
. . . . . . . . . .
. . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. 211 . 213 . 213 . 215 . 216 . 217 . 220 . 227 . 229 . 230 . 231 . 232 . 233 . 234 . 235 . 236 . 237 . 238 . 239 . 240 . 241 . 242 . 244 . 245 . 248 . 249 251 . 252 . 253 . 254 . 255 . 256 . 257 . 259 . 262 . 263 . 264
Viewing Business Services metrics . Viewing Proxy Services metrics Viewing Transports metrics . Viewing UDDI metrics . Viewing OSB dashboards OSB Home Dashboard . . . . . . . Viewing XQueries metrics
OSB Proxy Services - Overview dashboard OSB Proxy Services - Details dashboard . OSB Pipelines - Overview dashboard . .
OSB Business Services - Overview dashboard . OSB Transports I - Overview dashboard . OSB Transports II - Overview dashboard . OSB XQuery - Overview dashboard . OSB UDDI - Overview dashboard . Viewing and creating OSB alerts . Following an OSB transaction . . . . . . . . . . . . . . . .
Viewing and creating OSB metric groupings . About OSB cross-process transaction tracing Viewing an OSB Transaction Trace .
Viewing correlated events using Transaction Tracer . Chapter 7 Monitoring WebSphere Process Server (WPS) Using Introscope SPM to monitor WPS and WESB . About WPS and WESB component metrics WPS and WESB shared components . WPS-specific components . . . . . . . . . . About WPS and WESB metrics Viewing WPS tabs and metrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Viewing Business Processes metrics . Viewing Business Rules metrics Viewing Human Tasks metrics . . . . .
Contents vii
. . . . .
. . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. 265 . 266 . 268 . 269 . 271 . 271 . 272 . 274 . 276 . 277 . 279 . 283 . 284 . 284
Viewing WPS and WESB shared component metrics . Viewing Java Components metrics Viewing Adapters metrics . . . .
Viewing Mediation Flow and Primitives metrics . Viewing WPS and WESB Dashboards . Viewing WPS dashboards . WPS Overview dashboard . . . . . . . .
WPS Business Processes & State Machines (Service Components I) dashboard . . . . . . . . . . . . . . . . . . . . . 285 WPS Business Rules & Human Tasks (Service Components II) dashboard . . . . . . . . . . . . . . . . . . . WPS Interface Maps, BO Maps, & Relationships dashboard . WPS Selectors & Java Components dashboard . WPS Data Bindings dashboard . WPS Adapters dashboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286 . 287 . 288 . 289 . 290 . 291 . 293 . 294 . 294 . 295 . 297 . 298 . 299 . 300 . 301 . 302 . 304 . 308 . 309 . 316
WESB BO Maps & Relationships dashboard WESB Data Bindings dashboard . WESB Java Components dashboard .
Viewing and creating WPS and WESB metric groupings . Viewing and creating WPS and WESB alerts . Following a WPS transaction . . . . . About WPS cross-process transaction tracing .
viii Contents
Implementation Guide
Appendix A
Required configuration after Introscope .NET Agent install or upgrade 317 Reconfiguring after installing or upgrading the Introscope .NET Agent version . . . . . . . . . . . . . . . . . . . . . . . . 318
Appendix B
Introscope SPM Agent extension configuration properties Introscope SPM Agent extension configuration . . . . . . . . . . . . . . . . Introscope SPM Agent extension configuration properties .
. . . . . . . . . .
319 . 320 . 321 325 . 326 . 327 339 . 340 . 342 347
Appendix C
Introscope SPM EM extension configuration properties . Introscope SPM EM extension configuration . Introscope SPM EM extension properties . . . . . . . . . . . . .
Appendix D
Introscope SPM Workstation configuration properties . Introscope SPM Workstation configuration . . . . . . . . . . . . . . . . IntroscopeWorkstation.properties file properties
Index .
Contents ix
x Contents
CHAPTER
This chapter includes these topics: About SOA and web services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 13 16 17 18 21 21 21 23
How Introscope SPM helps you manage SOA-based applications . About what Introscope SPM monitors Introscope SPM components . . . How Introscope SPM monitors SOA-based applications .
See Monitoring WebSphere Process Server (WPS) on page 251. . Introscope SPM components for monitoring OSB . Additional Introscope documentation . . . . Introscope SPM components for monitoring WPS and WESB
Implementation Guide
CA Wilys approach to monitoring provides a uniform, coherent view of a SOA application. The real-time transaction tracking across heterogeneous environments such as J2EE and .NET gives your IT personnel a set of tools they can use to monitor application performance, triage incidents, and diagnose problemswithout the need to access or modify application source code.
CA Wily Introscope SOA Performance Management (Introscope SPM) provides comprehensive real-time and historical views into web services, web applications, the SOA infrastructures such as an Enterprise Service Bus (ESB) and Business Process Management System (BPMS), and the back-end systems to which they connect. This allows your IT personnel to monitor critical services around the clock, detect problems proactively, and perform root-cause analysis when issues arise. This figure shows the highest-level Introscope SPM product monitoring capabilities. As with Introscope, Introscope SPM provides a single solution across J2EE and .NET.
When a problem surfaces in these complex environments, often it is hard to know where to start looking for the source. CA Wily uses the term triage to mean how you identify the nature of a problem, then where you need to go for resolution. With continuous monitoring of web service transactions, Introscope SPM can detect potential failures as they are developing. In many cases, this proactive approach helps you identify and correct a failing component before it actually affects your customers or end users. If the first indication of a problem is a phone call from a user, its already too late and the problem situation is likely to go from bad to worse.
Implementation Guide
If your organization has already implemented SOA, your environment probably consists of cross-platform SOA, because business and IT have consolidated in many firms. Introscope SPM has the visibility to monitor and manage your entire infrastructure, including transactions that span multiple operating platforms such as J2EE and .NET. Introscope SPM allows you to use one tool to provide the same level of information about the transactions that cross these platforms, as well as use the same vocabulary to discuss with your IT colleagues what you are seeing. Introscope SPM delivers the detailed information that your organizations architects and developers need to quickly isolate and resolve problems: views of individual transactions in which web services are involved, the number and nature of web service faults, and component interactions. In this simple buy transaction example, a number of web services (ws) are used to transmit requests and responses between external and internal applications, application servers, and back-end systems.
When an incident occursfor example, the response time for a particular web service slows due to thread pool starvationan alert can notify the appropriate stakeholders of the problem before a service level agreement (SLA) is violated or an end-user is affected. To gather information about the nature of the problem, your Application Support manager can view detailed error data in the context of individual transactions, view the slowest web services to isolate the worst offenders, and view socket bandwidth metrics to get crucial information about message throughput. An incident is not always due to failure of the physical hardware components. A transaction, which consists of one or more web service invocations along with other pieces of logic, can fail. An individual web service invocation can fail for a number of reasons including:
the request message does not reach the intended destination (undelivered
request message)
the application logic fails, causing the web service not to send a response
Note All three of these failures can occur in a synchronous, request-response web service. In an asynchronous one-way web service, the undelivered response message cause does not directly occur. In a transaction failure, operations personnel can use Introscope SPM to monitor and audit end-to-end business transactions, create alerts, and report on incomplete processes. Once a problem has been flagged and identified, web services architects or developers can use Introscope SPM to diagnose the root cause and drill into web service errors. See Viewing web service metrics in the Investigator on page 114 for more information about viewing web services data.
Implementation Guide
Introscope SPM provides broad and deep SOA performance management capabilities, including monitoring and reporting metrics about whats been deployed in your SOA environment including the:
web services non-standard services that do not use the SOAP protocol including
XML over HTTP (also known as REST-based services) JMS over HTTP
example, any Java class that makes a service request to get a stock quote can be considered a web service client.
The server is the component that implements a web services function. For
example, a Stock Quote web service is a serverit provides the price for the stock-quote client. A client and server of a web service usually reside in separate processesthat is, in Java Virtual Machines (JVMs) or Microsofts Common Language Runtime components (CLRs). An Introscope agent reports data per JVM or CLR, so client and server data for a web service are reported by two or more agents. To see metrics for both client and server agents aggregated together, configure a Virtual Agent. See Configuring virtual agents for Introscope SPM on page 54. An enterprise application can contain both client and server components.
completion
Understand the dependencies between web services so that you can assess the
impact of a problem
Track web service invocations across different SOAP stacks Create application groups of web services, and know whether a group is
In this case, the dependencies occur within a single application-server and are determined from data supplied by a single agent.
between client-side and server-side web services.
In this case, the dependencies occur between two application servers and are determined from data supplied by two different agents. In Introscope SPM, as SOA dependencies are discovered, they are added to the SOA Dependency Map. See Getting to know the SOA Dependency Map on page 146.
The Introscope SPM Agent extension, installed on top of the Introscope agent, is a software component that sits in-stream of the web service invocations. In operation, each agent listens for web service transactions.
Implementation Guide
The Introscope SPM EM extension is a component used to provide the Introscope SPM-specific Introscope management module, web services-related metrics, dashboards, and tabs.
Introscope SPM management modules, which provide Introscope SPM-specific
Introscope dashboards and tabs. A management module contains Introscope monitoring configuration information. Management modules are listed for each domain, and contain elements, which are objects that contain and organize data with monitoring logic such as actions and dashboards. For more information about management modules, see the Introscope Configuration and Administration Guide.
SOA Dependency Map, which provides a graphical way for you to view and
understand the interdependent agents, services, and operations in your SOA environment. The SOA Dependency Map displays real-time dependencies and metrics for your web services agents, services, and operations that are automatically generated from performance metrics and analysis of metrics, errors, and events.
This figure illustrates how Introscope SPM monitors web services in web applications deployed on J2EE or .NET servers.
Introscope Workstation
Implementation Guide
This table describes these capabilities and the associated Introscope SPM component. Product Component
Application Overview tab
Capability
You can use the Application Overview tab to view metrics at the front-end or the back-end of your application, as well as monitor the health of an overall web application. See Using the Overview tabs on page 105 and the Introscope Workstation User Guide for more information about Application Overview.
These web services metrics are provided in separate client and server nodes in the Introscope Investigator tree: Average Response Time Concurrent Invocations Errors Per Interval Responses Per Interval SOAP Faults Per Interval Stall Count Introscope SPM comes with custom Introscope dashboards and alerts to monitor web services-specific data. You can also customize the dashboards to fit the needs of your environment. Dashboards show information divided by clients and servers, with data viewers for these statistics: Top 10 slowest web services Top 10 slowest web service operations Summary alerts for all web services (per client and server) Average operation response times for clients Average operation response times for servers Web service faults (SOAP Faults/Errors) Web service response statistics (responses per interval) Average web service response times for clients Average web service response times for servers
Implementation Guide
Product Component
Agent extension
Capability
Based on your operating system and platform, when implementing Introscope SPM you install and configure this software component that sits in-stream of the web service transactions. In operation, each agent listens for web service transactions. You extract this software component that provides Introscope SPM-specific Introscope dashboards and tabs. Introscope SPM is integrated with the Introscope Transaction Tracer. Using Transaction Tracer, you can monitor web service transactions both within a web application and across SOAP stacks, see a web service within an entitys trace, and run Transaction Traces against a web service URL. Introscope SPM provides the SOA Dependency Map as a graphical way for you to view and understand the interdependent agents, services, and operations in your SOA environment. SOA Dependency Map displays real-time dependencies and metrics for your web services agents, services, and operations that are automatically generated from performance metrics and analysis of metrics, errors and events.
Agent and EM extensions for OSB Agent and EM extensions for WPS and standalone WESB
You extract these software components that provide Introscope SPM OSBspecific Introscope dashboards and tabs. You extract these software components that provide Introscope SPM WPS or WESB-specific Introscope dashboards and tabs.
Guide
CHAPTER
This chapter includes these topics: Introscope SPM installation overview Introscope SPM install prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 29 31 32 32 35 40 50 53 53 54 55 59 60
Downloading and extracting the installation archives Downloading and extracting the installation archives
Extracting Windows, Unix, and z/OS Java Agent extensions Extracting Introscope SPM EM extensions . Configuring Introscope SPM EM extensions . Uninstalling Introscope SPM EM extensions. Verifying your deployment . Uninstalling Introscope SPM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
See Downloading and extracting the installation archives on page 32. A link to the CA Wily Software Download Site is provided to you in a software delivery email.
The Enterprise Manager version must be later than or equal to the Agent version.
ErrorDetector 8.1
Implementation Guide
<Agent_Home>
refers to...
The path separator or environment variable notation used on your platform. The UNIX versions are used in this guide as examples, but you should use the style appropriate to the platform. Introscope or Introscope SPM file name that includes a version-specific identifier. Here are some examples. You might read in this guide:
IntroscopeSOAPerformanceManagement <version>windows.zip
and see this file on the CA Wily Software Download site:
IntroscopeSOAPerformanceManagement V8.1.0.0windows.zip
You might read in this guide: com.wily.introscope.soa.tracefilters.common _<version>.jar and see this file on your machine:
com.wily.introscope.soa.tracefilte rs.common_8.1.0.0.jar
You might read in this guide:
com.wily.powerpacks.osb.emext.calc ulator_<version>.jar
and see this file on your machine:
com.wily.powerpacks.osb.emext.calc ulator_8.1.0.jar
Implementation Guide
If youre installing the .NET Agent extension (ASP.NET), check that you have
installed the Introscope .NET Agent version 8.1.0.0 or later.
If youre installing the .NET Agent extension (WCF), check that you have
installed the Introscope .NET Agent version 8.1.0.0 or later.
If youre installing the Introscope SPM OSB Agent extension, check that you
have installed the Introscope SPM Java or .NET Agent extension version 8.1.0.0 or later.
If youre installing the Introscope SPM WPS or WESB Agent extension, check
that you have installed the Introscope SPM Java or .NET Agent extension version 8.1.0.0 or later.
<Agent_Home> Agent home directoryInstallation directory of the Introscope Agent for the application server to be monitored. <EM_Home>Installation directory for Introscope on your Enterprise
Manager machine. The directory where the IntroscopeAgent.profile file is located, on each agent where you plan to install Introscope SPM.
Note The IntroscopeAgent.profile file is typically in the top-level directory of the Agent installation.
Know the components you plan to install on each computer: Introscope SPM
Agent extension and Introscope SPM EM extension. Machine Name Component
Introscope SPM Agent extension Introscope SPM EM extension Introscope SPM OSB Agent extension Introscope SPM OSB EM extension Introscope SPM WPS/WESB Agent extension Introscope SPM WPS/WESB EM extension
Want to install?
Note If youre not sure about how to determine the components you need or where they are to be located, contact CA Wily Technical Support.
Know the proxy host name and proxy server port (only if you have to provide
this information to access the CA download site). If your proxy server requires authentication, you must have a valid user name and password for the proxy server.
Implementation Guide
Operating System
IntroscopeSOAPerformanceManagementV<version>unix.tar
z/OS
Implementation Guide
The Introscope SPM installation archive contains Introscope SPM Agent extension and Introscope SPM EM extension files. The files you see depend on your operating system, as shown in this table: Operating System
Windows Java
Description
V<version>Agent.windows.zip <version>EM.windows.zip
extension
V<version>Agent.unix.tar V<version>EM.unix.tar
extension
z/OS
extension (ASP.NET) for V<version>Agent.windows.zip .NET Agent IntroscopeSOAPerformanceManagement Introscope SPM Agent V<version>Agent.windows.wcf.zip extension (WCF) for .NET IntroscopeSOAPerformanceManagement Agent V<version>EM.windows.zip
EM extension
4 Download from the Software Download Site the Introscope SPM documentation. Choose the documentation archive appropriate for your environment from this table. Operating System
Windows Java Unix (AIX, Linux, Solaris) z/OS Windows .NET
5 Extract the documentation files. Note If youre extracting documentation in a Unix or z/OS environment, use the appropriate command in this table. Install Archive Package
Unix (AIX, Linux, Solaris) z/OS
Implementation Guide
Based on your operating system, proceed to the appropriate installation topic. Operating System
Windows Java Unix (AIX, Linux, Solaris) z/OS Windows .NET
Prerequisites
You must have installed and configured the appropriate version of CA Wily
configure on a computer that satisfies all system requirements (see Introscope SPM Agent extension requirements on page 27). Tip Before extracting Java Agent extensions, its a best practice to copy IntroscopeAgent.profile to a backup directory.
To extract Introscope SPM Java Agent extensions: Before extracting Introscope SPM Agent extensions, you must first install and extract the installation archive. See Downloading and extracting the installation archives on page 32. 1 If youre upgrading from Web Services Manager 7.2, back up the Web Services Manager 7.2 Java agent webservices.pbd file. Web Services Manager 7.2 Java agent includes a webservices.pbd file. The Introscope SPM Agent extension also contains webservices.pbd file that overrides the Web Services Manager 7.2 Java agent webservices.pbd file during the extraction process. If you want to uninstall the Introscope SPM Agent extension, you will need to replace the Introscope SPM Agent extension webservices.pbd file with the Web Services Manager 7.2 Java agent webservices.pbd file. For more information, see Uninstalling Introscope SPM .NET Agent extensions on page 47 and Upgrading Web Services Manager to Introscope SPM on page 56. Note CA Wily also recommends backing up the Web Services Manager 7.2 <Agent_Home>) directory in case you want to revert back to your Web Services Manager 7.2 application environment. a Find the Web Services Manager 7.2 Java webservices.pbd file in the <Agent_Home> directory. b Save in a secure location a copy of the Web Services Manager 7.2 Java webservices.pbd file. 2 Choose from this table the Introscope SPM Agent extension archive appropriate for your environment. Operating System
Windows Java Unix (AIX, Linux, Solaris) z/OS
Implementation Guide
If youre extracting Introscope SPM Agent extensions in a Unix or z/OS environment, use the appropriate command in this table. Operating System Agent Extension Archive Extract Command
IntroscopeSOAPerformanceManagementV<version>Agent.unix.tar
z/OS
File
Description
The ProbeBuilder Directives file containing the tracers required to enable your application to collect web services metrics. Extension to the Introscope Agent required by Introscope SPM.
webservices.pbd WebServicesAgent.jar
The Introscope SPM Agent Java extension is extracted. You now need to configure the Introscope SPM Java Agent extension.
Prerequisites
Note see Installation machine and directory names with documentation conventions on page 27 to understand the variables used in this guide for different installation directories. Be sure youve carried out these prerequisites before you configure the Introscope SPM Java Agent extensions:
While configuring a Introscope SPM Agent extension, the monitored application
should not be running. Stop the server before starting the configuration.
For Axis Agent extensions, the machine must have the Axis SOAP engine,
Web AS 6.40 or SAP NetWeaver Web AS 7.0 installed. To configure Introscope SPM Java Agent extensions: 1 Modify the agent configuration properties. a Open the IntroscopeAgent.profile file in <Agent_Home>. b Add the webservices.pbd value to the
introscope.autoprobe.directivesFile=defaulttypical.pbl,webserv ices.pbd
2 If required, update the default Introscope SPM Agent extensions properties settings in the IntroscopeAgent.profile file. For more in-depth descriptions of the IntroscopeAgent.profile, see Introscope SPM Agent extension configuration properties on page 321.
Implementation Guide
3 Restart the application server into which the Introscope SPM Agent Java extension is installed. This restarts the Agent and loads the Introscope SPM Agent extension. 4 Verify your deployment by invoking any Java web service and verifying that web service node exists in the Investigator tree. See Verifying your deployment on page 55. If you do not see .NET web service data, see Troubleshooting the Introscope SPM .NET Agent extension installation on page 45. Note You will not see any metrics associated with WebLogic test client transactions. WebLogic uses a type of synthetic transaction to automatically generate web pages to test web services. In this case, test clients that run against services hosted by WebLogic cannot be detected by the Introscope SPM Agent extension. 5 If you want to configure multiple physical agents into a single Virtual Agent, see Configuring virtual agents for Introscope SPM on page 54. The Introscope SPM Java Agent extension is installed and configured. Now extract the EM extension. See Extracting Introscope SPM EM extensions on page 50.
introscope.autoprobe.directivesFile property.
3 Delete the WebServicesAgent.jar file from the <Agent_Home>/ext directory 4 Delete the BoundaryOnlyTrace.jar file from the <Agent_Home>/ext directory. 5 Delete webservices.pbd from the <Agent_Home> directory. 6 Start the application server. The Introscope SPM Java Agent extension is uninstalled.
IntroscopeSOAPerformanceManagementV<version> Introscope SPM Agent extension (ASP.NET) for .NET Agent Agent.windowsDotNet.zip IntroscopeSOAPerformanceManagementV<version> Introscope SPM Agent extension (WCF) for .NET Agent Agent.windows.wcf.zip
If you want to make use of Windows
Communication Foundation (WCF), after you install and configure the Introscope SPM .NET Agent extension, see Wily Knowledge Base (KB) article 2123
Installing and configuring Introscope SOA Performance Management 8.1 .NET Agent extensions for WCF.
Prerequisites
You must have an installed and configured the Introscope .NET Agent version
Implementation Guide
Important Anytime you install a new or upgraded (later than 8.1.0.0) version of the Introscope .NET Agent, you must make some configuration changes. See Reconfiguring after installing or upgrading the Introscope .NET Agent version on page 318.
If you want to monitor .NET cross-process transactions, you must have
configured the .NET Agent for cross-process tracing. The configuration is available in the Sample.exe.config file in the <Agent_Home> directory. For more information, see the Introscope .NET Agent Guide. To extract the Introscope SPM .NET Agent extension (ASP.NET): 1 If needed, log in with the Operating System Administrator account. 2 If youre upgrading from Web Services Manager 7.2, back up the Web Services Manager 7.2 .NET agent webservices.pbd file. The Web Services Manager 7.2 .NET agent includes a webservices.pbd file. The Introscope SPM Agent extension also contains webservices.pbd file that overrides the Web Services Manager 7.2 NET agent webservices.pbd file during the extraction process. If you want to uninstall the Introscope SPM NET Agent extension, you will need to replace the Introscope SPM NET Agent extension webservices.pbd file with the Web Services Manager 7.2 NET agent webservices.pbd file. For more information, see Uninstalling Introscope SPM .NET Agent extensions on page 47 and Upgrading Web Services Manager to Introscope SPM on page 56. Note CA Wily also recommends backing up the Web Services Manager 7.2 <Agent_Home> directory in case you want to revert back to your Web Services Manager 7.2 application environment. a Find the Introscope .NET agent webservices.pbd file in the <Agent_Home> directory. b Save in a secure location a copy of the Introscope .NET agent webservices.pbd file. 3 Download the Introscope SPM installation archive file
IntroscopeSOAPerformanceManagementV<version>Agent.windowsDotNet. zip installation archive file to <Agent_Home>, which contains the agent configuration and is typically called wily.
webservices.pbd
wily.WebServicesAgent.ext.dll
Contains the Introscope SPM agent extension classes. During the extraction process, the
WebServices.Observer.dll
Contains the classes related to identifying web services. During the extraction process, the WebServices.Observer.dll file is copied to the <Agent_Home>\bin directory.
wilyHttpCorrelationTracers.ext.dll
Contains classes required by Introscope SPM. During the extraction process, the
wilyHttpCorrelationTracers.ext.dll file is
copied to the <Agent_Home>\ext directory.
wilyBoundaryOnlyTrace.ext.dll
Contains classes required by Introscope SPM. During the extraction process, the
Implementation Guide
To modify the Introscope SPM .NET Agent configuration properties: 1 Modify the Introscope SPM agent configuration properties. a Open the IntroscopeAgent.profile file in <Agent_Home>. b Open the IntroscopeAgent.profile file in <Agent_Home>. c Add the webservices.pbd value to the
introscope.autoprobe.directivesFile=defaulttypical.pbl,webserv ices.pbd
2 If required, update the default Introscope SPM Agent extensions properties settings in the IntroscopeAgent.profile file. For more in-depth descriptions of the in IntroscopeAgent.profile, see Introscope SPM Agent extension configuration properties on page 321. To register the WebServices.Observer.dll file: Use the wilyregtool to register the WebServices.Observer.dll file. Note The wilyregtool can be used to register the Wily Web Services Agent assembly, WebServices.Observer.dll, to the Global Assembly Cache (GAC). It can also be used to unregister the assembly from the GAC. 1 Open a command prompt. 2 Go to the (Parent Directory of <Agent_Home>)\UninstallerData\dotnet. This is typically where the wilyregtool is located, and the full path typically looks like this:
To modify the .NET Framework configuration: To configure the .NET Framework for Introscope SPM, you must modify the .NET Framework configuration. For more information about .NET Framework configuration, see http://msdn.microsoft.com/en-us/library/ 1xtk877y(VS.71).aspx. 1 Locate the machine.config file, which is typically located in the C:\WINDOWS\Microsoft.NET\Framework\vx.x\CONFIG directory, where vx.x is the .NET version. For example, the directory for .NET 1.1 might be v1.1.4322 and the directory for .NET 2.0 might be v2.0.50727. 2 Make a backup of the machine.config file and store the backup file in a secure location. 3 Add code to the machine.config file. Note If you want to monitor .NET cross-process transactions, you need to have configured the .NET Agent. See Prerequisites on page 38. a Open the machine.config file and search for <webServices>. You should find <webServices> under <system.web>. If you do not, type <webServices> under <system.web>. It should look like this:
<system.web> <webServices>
b Search for <soapExtensionTypes>. You should find <soapExtensionTypes> under <webServices>. If you do not, type <soapExtensionTypes> under <webServices>. It should look like this:
<webServices> <soapExtensionTypes>
c Add this code below <soapExtensionTypes>.
<add type="com.wily.powerpack.webservices.extension.ObserverSoapExtensio n, WebServices.Observer, Version=<version>, Culture=neutral, PublicKeyToken=99330fac7173009e" group="0" priority="3" /> </soapExtensionTypes> </webServices>
For example,
<add type="com.wily.powerpack.webservices.extension.ObserverSoapExtensio n, WebServices.Observer, Version=8.1.0.0, Culture=neutral, PublicKeyToken=99330fac7173009e" group="0" priority="3" /> </soapExtensionTypes> </webServices>
Implementation Guide
When you are done, the machine.config file looks like this:
<webServices> <soapExtensionTypes> <add type="com.wily.powerpack.webservices.extension.ObserverSoapExtensio n, WebServices.Observer, Version=8.1.0.0, Culture=neutral, PublicKeyToken=99330fac7173009e" group="0" priority="3" /> </soapExtensionTypes> </webServices>
d Save the machine.config file. To restart the application server and verify your deployment: 1 Restart the IIS application server, which restarts the agent and loads the Introscope SPM .NET Agent extension. 2 Verify your deployment by invoking any .NET web service and verifying that web service node exists in the Investigator tree. See Verifying your deployment on page 55. If you do not see .NET web service data, see Troubleshooting the Introscope SPM .NET Agent extension installation, below. The Introscope SPM .NET Agent extension is installed and configured. Now extract the EM extension. See Extracting Introscope SPM EM extensions on page 50.
If one or more files is not in the correct directory, re-extract the Introscope SPM .NET Agent extension IntroscopeSOAPerformanceManagementV<version>DotNet.zip archive file into a temp directory and copy any missing files to the required directory.
2 Verify that the WebServices.Observer.dll file is in the Global Assembly Cache (GAC). If the WebServices.Observer.dll file is not in the GAC, use the wilyregtool to register the WebServices.Observer.dll file. See Use the wilyregtool to register the WebServices.Observer.dll file. on page 43. 3 Verify that there is an entry for webservices.pbd in the <Agent_Home>\default-full.pbl file.
If there is no entry for webservices.pbd in the <Agent_Home>\default-
C:\WINDOWS\Microsoft.NET\Framework\vx.x\CONFIG directory, where vx.x is the .NET version. For example, the directory for .NET 1.1
might be v1.1.4322 and the directory for .NET 2.0 might be v2.0.50727. Note If your system is running ASP.NET 1.1 web services or the ASP.NET 1.1 client, check the ASP.NET 1.1 machine.config file. Similarly, if your system is running .NET 2.0, check the .NET 2.0 machine.config file.
<webServices> <soapExtensionTypes> <add type="com.wily.powerpack.webservices.extension.ObserverSoapExtension, WebServices.Observer, Version=<version>, Culture=neutral, PublicKeyToken=99330fac7173009e" group="0" priority="3" /> </soapExtensionTypes> </webServices>
For example,
<webServices> <soapExtensionTypes> <add type="com.wily.powerpack.webservices.extension.ObserverSoapExtension, WebServices.Observer, Version=8.1.0.0, Culture=neutral, PublicKeyToken=99330fac7173009e" group="0" priority="3" /> </soapExtensionTypes> </webServices>
If the code above is not in the machine.config file, add the code. See Add code
to the machine.config file. on page 44. Note If you want to monitor .NET cross-process transactions, you must have configured the .NET Agent for cross-process tracing. The configuration is available in the Sample.exe.config file in the <Agent_Home> directory. For more information, see the Introscope .NET Agent Guide.
Implementation Guide
5 If you upgraded to a version later than 8.1.0.0 of the Introscope .NET Agent, you must make some configuration changes. See Reconfiguring after installing or upgrading the Introscope .NET Agent version on page 318. 6 Invoke any .NET web service and verify that web service node in the Investigator tree.
C:\WINDOWS\Microsoft.NET\Framework\vx.x\CONFIG directory, where vx.x is the .NET version. For example, the directory for .NET 1.1
might be v1.1.4322 and the directory for .NET 2.0 might be v2.0.50727. b Search for <soapExtensionTypes>. c Delete this code below <soapExtensionTypes>.
<add type="com.wily.powerpack.webservices.extension.ObserverSoapExtensio n, WebServices.Observer, Version=<version>, Culture=neutral, PublicKeyToken=99330fac7173009e" group="0" priority="3" />
For example,
<add type="com.wily.powerpack.webservices.extension.ObserverSoapExtensio n, WebServices.Observer, Version=8.1.0.0, Culture=neutral, PublicKeyToken=99330fac7173009e" group="0" priority="3" />
For example,
wilyregtool -u C:\Program Files\CA Wily\Introscope8.1\wily\bin\WebServices.Observer.dll
4 Delete the files listed in the table below. File Name Delete from this Directory
5 Replace the Introscope .NET agent webservices.pbd file. a Find the Introscope .NET agent webservices.pbd file copied and backed up during the .NET Agent extension installation. See If youre upgrading from Web Services Manager 7.2, back up the Web Services Manager 7.2 .NET agent webservices.pbd file. on page 41. b Copy the Introscope .NET agent webservices.pbd file to the <Agent_Home> directory. 6 If you upgraded the Introscope Agent version and configured the .NET Agent extension, remove changes to the aspnet.config file. a Find the aspnet.config application server configuration file used by the IIS application server.
In Windows, choose Start > Run to open the Run dialog box. In the Run dialog box Open field, type Microsoft.NET, then press OK. Go to the Framework\vx.x.xxxx directory, where vx.x.xxxx is the .NET
version. For example, the directory for .NET 1.1 might be v1.1.4322 and the directory for .NET 2.0 might be v2.0.50727. b Search for the aspnet.config file.
Implementation Guide
c Modify the .NET Agent configuration in the aspnet.config file by removing the lines shown in bold below, where <upgradedAgentVersion> is the current Introscope .NET Agent version that you are using:
<dependentAssembly> <assemblyIdentity name="wily.Agent" publicKeyToken="2B41FDFB6CD662A5" /> <bindingRedirect oldVersion="8.1.0.0" newVersion="<upgradedAgentVersion>" /> <codeBase version="<upgradedAgentVersion>" href="file:/// C:\\Program Files\\CA Wily\\Introscope8.1.0.0\\wily\\bin\\wily.Agent.dll"/> </dependentAssembly>
7 Start the IIS application server. The Introscope SPM .NET Agent extension is uninstalled.
EM Extension Archive
Operating System
IntroscopeSOAPerformanceManagementV<version>EM.unix.tar
z/OS
Implementation Guide
The Introscope SPM EM extension archive contains these files: File Description
Introscope SPM management module for viewing web services data in the Introscope Investigator. Contains preconfigured dashboards and alerts for viewing web services metrics.
SPM_ManagementModule.jar
SPM_ManagementModule.jar automatically extracts to the <EM_Home>/deploy directory. When the Enterprise Manager is started, SPM_ManagementModule.jar is automatically moved to the <EM_Home>/config/modules
directory.
ws.overview.tv.xml
Extension to the Introscope Workstation. Enables the Workstation to request web services data from the Enterprise Manager. Provides the Introscope SPM Overview tab in Introscope Investigator.
ws.wsdeviation.tv.xml automatically extracts to the <EM_Home>/ext/xmltv directory. com.wily.introscope.soa.tracefil Supports Introscope SPM Transaction Tracing capabilities. ters.common_<version>.jar com.wily.introscope.soa.tracefilters.common_< version>.jar automatically extracts to two locations:
<EM_Home>/product/enterprisemanager/plugins
directory
<EM_Home>/ws-plugins directory
com.wily.introscope.soa.tracefil Supports Introscope SPM Transaction Tracing capabilities. ters.em_<version>.jar com.wily.introscope.soa.tracefilters.em_<vers ion>.jar automatically extracts to the <EM_Home>/ product/enterprisemanager/plugins directory.
File
Description
com.wily.introscope.soa.dependen Supports Introscope SPM SOA Dependency Map capabilities. cymap.common_<version>.jar com.wily.introscope.soa.dependencymap.common_ <version>.jar automatically extracts to two locations:
<EM_Home>/product/enterprisemanager/plugins
directory.
<EM_Home>/ws-plugins directory
com.wily.introscope.soa.dependen Supports Introscope SPM SOA Dependency Map capabilities. cymap_<version>.jar com.wily.introscope.soa.dependencymap_<versio n>.jar automatically extracts to the <EM_Home>/ product/enterprisemanager/plugins directory. com.wily.introscope.soa.deviatio Supports Introscope SPM deviation metrics capabilities. nmetrics_<version>.jar com.wily.introscope.soa.deviationmetrics_<ver sion>.jar automatically extracts to the <EM_Home>/ product/enterprisemanager/plugins directory. com.wily.introscope.soa.dependen Supports Introscope SPM SOA Dependency Map capabilities. cymap.ui_<version>.jar com.wily.introscope.soa.dependencymap.ui_<ver sion>.jar automatically extracts to the <EM_Home>/wsplugins directory. com.wily.introscope.soa.dependen Supports Introscope SPM dependency metrics capabilities cymetrics.typeviewer_<version>.j for displaying in the SOA Performance - Most Critical Operations and SOA Performance - Most Dependent ar
Operations dashboards as well as in the Most Critical and Most Dependent tabs.
com.wily.introscope.soa.dependencymetrics.typ eviewer_<version>.jar automatically extracts to the <EM_Home>/ws-plugins directory. com.wily.introscope.soa.tracefil Supports Introscope SPM Transaction Tracing capabilities. ters.workstation_<version>.jar com.wily.introscope.soa.tracefilters.workstat ion_<version>.jar automatically extracts to the <EM_Home>/ws-plugins directory. com.wily.introscope.ui.tomsawyer Supports Introscope SPM UI capabilities. _<version>.jar com.wily.introscope.ui.tomsawyer_<version>.ja r automatically extracts to the <EM_Home>/ws-plugins
directory.
5 You now need to configure the Introscope SPM EM extension. See Configuring Introscope SPM EM extensions on page 53 for details. The Introscope SPM EM extension is extracted.
Implementation Guide
com.wily.introscope.soa.tracefilters.common_<version>.jar.
7 Delete <EM_Home>/product/enterprisemanager/plugins/
com.wily.introscope.soa.tracefilters.em_<version>.jar.
8 Delete <EM_Home>/product/enterprisemanager/plugins/
com.wily.introscope.soa.dependencymap.common_<version>.jar.
9 Delete <EM_Home>/product/enterprisemanager/plugins/
com.wily.introscope.soa.dependencymap_<version>.jar.
10 Delete <EM_Home>/product/enterprisemanager/plugins/
com.wily.introscope.soa.deviationmetrics_<version>.jar.
11 Delete <EM_Home>/ws-plugins/
com.wily.introscope.soa.tracefilters.common_<version>.jar.
12 Delete <EM_Home>/ws-plugins/
com.wily.introscope.soa.dependencymap.common_<version>.jar.
13 Delete <EM_Home>/ws-plugins/
com.wily.introscope.soa.dependencymap.ui_<version>.jar.
14 Delete <EM_Home>/ws-plugins/
com.wily.introscope.soa.dependencymetrics.typeviewer_<version>.j ar
15 Delete <EM_Home>/ws-plugins/
com.wily.introscope.soa.tracefilters.workstation_<version>.jar.
16 Delete <EM_Home>/ws-plugins/
com.wily.introscope.ui.tomsawyer_<version>.jar.
17 Start the Enterprise Manager. The Introscope SPM EM extension is uninstalled.
Implementation Guide
<metric-specifier>WebServices\|Server\|(.*):Stall Count</metricspecifier> <metric-specifier>WebServices\|Server\|(.*):SOAP Faults Per Interval</ metric-specifier> <metric-specifier>WebServices\|Server\|(.*)\|(.*):Average Response Time \(ms\)</metric-specifier> <metric-specifier>WebServices\|Server\|(.*)\|(.*):Concurrent Invocations</metric-specifier> <metric-specifier>WebServices\|Server\|(.*)\|(.*):Errors Per Interval</ metric-specifier> <metric-specifier>WebServices\|Server\|(.*)\|(.*):Responses Per Interval</metric-specifier> <metric-specifier>WebServices\|Server\|(.*)\|(.*):Stall Count</metricspecifier> <metric-specifier>WebServices\|Server\|(.*)\|(.*):SOAP Faults Per Interval</metric-specifier> </agent-cluster>
See To view web service metrics aggregated across all agents: on page 135 for a figure showing the resulting WebServicesVirtualAgent node and metrics displayed in Introscope Investigator.
3 In the Workstation Management Module Editor, verify the SOA Performance Management <version> node. a Choose Workstation > New Management Module Editor. b Under the SuperDomain, see the SOA Performance Management <version> node. This verifies that the SPM_ManagementModule.jar file loaded properly. 4 If the agent is installed and configured properly, then you can see a message in the Introscope Agent log file stating the Introscope SPMversion that started. For example, Started SPM Release <version> (Build xxxxxx) where xxxxxx is the build number. Or you can check for nodes under Custom Metric Agent (Virtual). The node names are derived from the Web Service namespace. For help seeing the Client or Server nodes, see SOA Performance Management tabs on page 105.
Prerequisites
You must have backed up the Web Services Manager 7.2 webservices.pbd
file. CA Wily also recommends backing up the Web Services Manager 7.2 <Agent_Home> directory.
You must have upgraded your system and Introscope components including
Introscope Agents and Enterprise Manager to meet the minimum version requirements for Introscope SPM 8.1. See Hardware and software requirements on page 26 and the Introscope Installation and Upgrade Guide.
You must have upgraded ErrorDetector to version 8.1 or later. See Hardware
Implementation Guide
To upgrade from Web Services Manager 7.2 to Introscope SPM 8.1: 1 Upgrade the EM extension. Upgrading the EM extension upgrades the Web Services Manager management module to the Introscope SPM 8.1 module, which provides the Introscope SPM 8.1 dashboards, nodes, and tabs. Note When the Enterprise Manager is started, the SPM_ManagementModule.jar is automatically moved from the <EM_Home>/deploy directory to the <EM_Home>/config/modules directory. a Log in to the Introscope Workstation and open the Introscope SPM 8.1 management module. b Examine the Introscope SPM 8.1 management module, and manually transfer anything appropriate from your Web Services Manager 7.2 management module to the Introscope SPM 8.1 management module. * If you have any customizations in the Web Services Manager 7.2 management module, manually copy them to or make the appropriate changes in the Introscope SPM 8.1 management module. * If you have any custom management modules with references to Web Services Manager 7.2 management module elements, delete the references or change the references to refer to Introscope SPM 8.1 management module elements. c Once you have transferred everything you want from the Web Services Manager 7.2 management modules to the Introscope SPM 8.1 management module, undeploy the Web Services Manager 7.2 management module. * Stop the Enterprise Manager. * Delete the Web Services Manager 7.2 WebServicesManagementModule.jar file from the <EM_Home>/config/modules directory. * Restart the Enterprise Manager. 2 (Optional) Configure webservices.pbd to retain the Web Services Manager 7.0 or 7.0.1 Investigator tree web service node naming convention. In the Web Services Manager 7.2 Investigator tree, web service nodes are named using the web service namespace. For example:
http_//ClearingHouse.demobank.ca.com
In the Web Services Manager 7.0 and 7.0.1 Investigator tree, web service nodes are named using the web service endpoint. For example:
http_localhost_8383_demobank_services_ClearingHouseService
Follow these steps if you want to retain the Web Services Manager 7.0 or 7.0.1 node name style in your Investigator tree. a Open the webservices.pbd file in the <Agent_Home> directory. b Search for and replace all instances of {namespace} with {servicename}. c Save the webservices.pbd file. d Open the IntroscopeAgent.profile file in the <Agent_Home> directory. e Add the com.wily.introscope.agent.soa.metricNameFormatting property. f Set the com.wily.introscope.agent.soa.metricNameFormatting property to /:. For example
com.wily.introscope.agent.soa.metricNameFormatting=/:
g Save the IntroscopeAgent.profile file. h Restart the application server of the monitored application. Introscope SPM metric names display in the Investigator tree and SOA Dependency Map using service name rather than namespace. 3 (Optional) Configure the ws.overview.tv.xml file to change the Namespaces label in the Introscope SPM 8.1 Client and Server node Overview tab Viewer pane. For information about the Client and Server Overview tabs, see Using the Overview tabs on page 105. To see a figure showing the Namespaces label, see step 3 on page 107. a Complete step 2 on page 57. b Open the ws.overview.tv.xml file in the <EM_Home>/ext/xmltv/ directory. c Search for and replace all instances of Namespaces with Services. d Save the ws.overview.tv.xml file. e Restart the Enterprise Manager. The Services label displays in the Introscope SPM 8.1 Client and Server node Overview tab Viewer pane. 4 Verify your deployment. See Verifying your deployment on page 55. The Introscope SPM upgrade is completed.
Implementation Guide
2 Uninstall the Introscope SPM EM extension. See Uninstalling Introscope SPM EM extensions on page 53. Note If you installed and configured the Introscope SPM EM extension in a clustered environment, uninstall the EM extensions on both the MOM and the Collectors, and undeploy the Management Module on the MOM. Introscope SPM is uninstalled.
Check that your environment meets the requirements stated in Hardware and
software requirements on page 26. WARNING Do not install the OSB.pbd and OSBAgent.jar files into a WebLogic 8.1 agent. OSB does not support WebLogic 8.1. If youre using the same Introscope agent to monitor multiple WebLogic agents any of which are version 8.1, your WebLogic 8.1 instance may experience severe problems.
Implementation Guide
a Choose the installation archive appropriate for your environment from this table. OS
Windows
IntroscopeSOAExtensionforOracleServiceBusV<version>windows.zip
b Download the installation archive to a temp directory. 3 Extract the installation archive into the temp directory. Note If youre extracting in a Unix environment, use the appropriate command in this table. OS
Unix (AIX, Linux, Solaris)
The Introscope SPM OSB installation archive contains Agent extension and EM extension files. The files you see depend on your operating system, as shown in this table: OS Files that extract from the installation archive Description
Windows IntroscopeSOAExtensionforOracleServiceBusV<version> Introscope SPM OSB Java Agent extension Agent.windows.zip EM extension IntroscopeSOAExtensionforOracleServiceBusV<version>
EM.windows.zip
Unix (AIX, Linux, Solaris)
IntroscopeSOAExtensionforOracleServiceBusV<version> Introscope SPM OSB IntroscopeSOAExtensionforOracleServiceBusV<version> EM extension
Agent.unix.tar EM.unix.tar
The installation archives are downloaded and extracted. 4 Download from the Software Download Site the Introscope SPM OSB documentation.
Choose the documentation archive appropriate for your environment from this table. Operating System
Windows Unix (AIX, Linux, Solaris)
5 Extract the documentation file. Note If youre extracting documentation in a Unix environment, use the appropriate command in this table. Install Archive Package
Unix (AIX, Linux, Solaris)
OS
Description
_ReadMe.txt
Unix (AIX, Linux, Solaris)
IntroscopeSOAExtensionforOracleServiceBusV<version> Documentation
_ReadMe.txt
The installation and documentation archives are downloaded and extracted. Now you will extract and configure the Introscope SPM OSB Agent extensions.
Implementation Guide
Prerequisites
You must have installed and configured the appropriate version of CA Wily
on a computer that satisfies all system requirements (see Introscope SPM Agent extension requirements on page 27). Tip Before extracting Java Agent extensions, its a best practice to copy IntroscopeAgent.profile to a backup directory.
WARNING Do not install the OSB.pbd and OSBAgent.jar files into a WebLogic 8.1 agent. OSB does not support WebLogic 8.1. If youre using the same Introscope agent to monitor multiple WebLogic agents any of which are version 8.1, your WebLogic 8.1 instance may experience severe problems. To extract Agent extensions: Before extracting Introscope SPM OSB Agent extensions, you must first download and extract the installation archive. See Downloading and extracting the Introscope SPM OSB installation archive on page 60. 1 Choose from this table the Introscope SPM OSB Agent extension archive appropriate for your environment. Operating System
Windows Unix (AIX, Linux, Solaris)
2 In the temp directory into which the installation archive was downloaded and extracted (see Extracting Introscope SPM OSB Agent extensions on page 63), locate the appropriate Agent extension archive chosen in step 2.
3 Extract the Introscope SPM OSB Agent extension archive to <Agent_Home>, which contains the agent configuration file and is typically called wily. An example <Agent_Home> is c:\bea\wlserver_10.0\wily. If youre extracting Introscope SPM OSB Agent extensions in a Unix environment, use the appropriate command in this table. Operating System Agent Extension Archive Extract Command
Unix (AIX, Linux, Solaris)
The Introscope SPM OSB Agent extension archive contains these files: File Description
The ProbeBuilder Directives file containing the tracers required to enable your application to collect OSB components metrics.
OSB.pbd
4 You now need to configure the Introscope SPM OSB Agent extension. The Introscope SPM OSB Agent extension is extracted.
Prerequisites
Be sure youve carried out these prerequisites before you configure the Introscope SPM OSB Agent extensions:
While configuring a Introscope SPM OSB Agent extension, the monitored
application should not be running. Stop the server before starting the configuration. To configure Introscope SPM OSB Agent extensions: 1 Modify the agent configuration properties. a Open the IntroscopeAgent.profile file in <Agent_Home>.
Implementation Guide
b Search for the introscope.autoprobe.directivesFile property. c Add OSB.pbd to the introscope.autoprobe.directivesFile property.
For example:
introscope.autoprobe.directivesFile=OSB.pbd,hotdeploy
d Save and close the IntroscopeAgent.profile file. 2 Restart the ALSB 2.6 or OSB 3.0 application server into which the Introscope SPM OSB Agent extension is installed. This restarts the Agent and loads the Introscope SPM OSB Agent extension. 3 Verify your deployment by invoking any OSB service and verifying that the OSB node exists in the Investigator tree. 4 If you want to configure multiple physical agents into a single Virtual Agent, see Configuring virtual agents for Introscope SPM on page 54. The Introscope SPM OSB Agent extension is installed and configured. Now extract the Introscope SPM OSB EM extension. See Extracting Introscope SPM OSB EM extensions on page 66.
introscope.autoprobe.directivesFile property.
c Save and close the IntroscopeAgent.profile file. 3 Delete the OSBAgent.jar file from the <Agent_Home>/ext directory. 4 Delete the OSB.pbd file from the <Agent_Home> directory. The Introscope SPM OSB Agent extension is uninstalled.
Prerequisite
You must have installed and configured the appropriate version of Introscope
SPM EM extension. To extract Introscope SPM OSB EM extensions: 1 Stop the Enterprise Manager on which you will install the Introscope SPM OSB EM extension. 2 Choose from this table the Introscope SPM OSB EM extension archive appropriate for your environment. Operating System
Windows Unix (AIX, Linux, Solaris)
EM Extension Archive
IntroscopeSOAExtensionforOracleServiceBusV<version>EM.windows.z ip IntroscopeSOAExtensionforOracleServiceBusV<version>EM.unix.tar
3 Extract all files in the Introscope SPM OSB EM extension archive file to the <EM_Home> directory. Note If youre extracting EM extensions in a Unix environment, use the appropriate command in this table. OS
Unix (AIX, Linux, Solaris)
Implementation Guide
The Introscope SPM OSB EM extension archive contains these files: File Description
Extension to the Introscope Workstation. Enables the Workstation to show the Overview tab for OSB components, when any metric node under the OSB node is selected in the Investigator tree.
OSB.overview.tv.xml
OSB.overview.tv.xml automatically extracts to the <EM_Home>/ext/xmltv directory. OSB_ManagementModuleV<version>.j Introscope SPM OSB Management Module component that ar Enables the Workstation to show OSB health information
in Workstation dashboards
Contains pre-configured OSB metric groupings, and alerts.
OSB_ManagementModuleV<version>.jar automatically extracts to the <EM_Home>/deploy directory. When the Enterprise Manager is started, OSB_ManagementModuleV<version>.jar is automatically moved to the <EM_Home>/config/modules directory. com.wily.powerpacks.osb.emext.ca Calculator that aggregates: lculator_<version>.jar OSB Proxy Service's request and response metrics, then
Note: The version number in this file
name includes only three digits. For example, 8.1.0. posts those metrics under the respective Proxy Service node. OSB Transport metrics under the respective Transport Type.
OSB_ManagementModuleV<version>.jar.
3 Delete <EM_Home>/ext/xmltv/OSB.overview.tv.xml. 4 Delete <EM_Home>/product/enterprisemanager/plugins/
com.wily.powerpacks.osb.emext.calculator_<version>.jar.
Note The version number in this file name includes only three digits. For example, 8.1.0. 5 Start the Enterprise Manager. The Introscope SPM OSB EM extension is uninstalled.
Implementation Guide
Installing and configuring Introscope SPM WPS/ WESB Agent and EM extensions
Websphere Process Server (WPS) includes Websphere Enterprise Service Bus (WESB) as well as some additional components. The service integrations bus manages the flow of messages in WPS. WESB handles any data transformation or routing required between services and clients with the help of mediation flows and primitives. When Introscope SPM monitors WPS, Introscope displays health data for both WPS and WESB. IBM also provides Websphere Enterprise Service Bus as a standalone product. So when Introscope SPM monitors WESB only, Introscope displays health data about WESB only, not for WPS and WESB. This topic describes how you can extract, install, and configure the Introscope SPM WPS/WESB Agent and EM extensions needed for Introscope SPM to monitor your WPS/WESB environment. Before you begin the installation process, ensure that you have met the required prerequisites.
Check that your environment meets the requirements stated in Hardware and
software requirements on page 26.
OS
Unix (AIX, Linux, Solaris) z/OS
Implementation Guide
The Introscope SPM WPS/WESB installation archive contains Agent extension and EM extension files. The files you see depend on your operating system, as shown in this table: OS Files that extract from the installation archive Description
Windows IntroscopeSOAExtensionforIBMWebSphereProcessServer Introscope SPM WPS/ WESB Windows Agent andWESBV<version>Agent.windows.zip extension IntroscopeSOAExtensionforIBMWebSphereProcessServer EM extension andWESBV<version>EM.windows.zip Unix (AIX, Linux, Solaris) z/OS
IntroscopeSOAExtensionforIBMWebSphereProcessServer Introscope SPM WPS/
andWESBV<version>Agent.unix.tar
IntroscopeSOAExtensionforIBMWebSphereProcessServer
andWESBV<version>EM.unix.tar andWESBV<version>Agent.zOS.tar
IntroscopeSOAExtensionforIBMWebSphereProcessServer
andWESBV<version>EM.zOS.tar
4 Download from the Software Download Site the Introscope SPM WPS/WESB documentation. Choose the documentation archive appropriate for your environment from this table. Operating System
Windows Unix (AIX, Linux, Solaris) z/OS
5 Extract the documentation file. Note If youre extracting documentation in a Unix or z/OS environment, use the appropriate command in this table. Install Archive Package
Unix (AIX, Linux, Solaris)
z/OS
The Introscope SPM WPS/WESB documentation archive contains a ReadMe file, as shown in this table: OS
Windows
Description
Documentation Documentation
Documentation
The installation and documentation archives are downloaded and extracted. Now you will extract and configure the Introscope SPM WPS/WESB Agent extensions.
Prerequisites
You must have installed and configured the appropriate version of CA Wily
SPM EM extension.
Implementation Guide
Extract the Introscope SPM WPS/WESB Agent extensions that you want to
install and configure on a computer that satisfies all system requirements (see Introscope SPM Agent extension requirements on page 27). Tip Before extracting Java Agent extensions, its a best practice to copy
To extract Introscope SPM WPS/WESB Agent extensions: Before extracting Introscope SPM WPS/WESB Agent extensions, you must first install and extract the installation archive. See Downloading and extracting the Introscope SPM WPS/WESB installation archive on page 70. 1 Choose from this table the Introscope SPM WPS/WESB Agent extension archive appropriate for your environment. Operating System
Windows Unix (AIX, Linux, Solaris) z/OS
Operating System
Unix (AIX, Linux, Solaris)
z/OS
The Introscope SPM WPS/WESB Agent extension archive contains these files: File Description
The ProbeBuilder Directives file containing the tracers required to enable your application to collect WPS components-related metrics.
WPS.pbd
WPS.pbd automatically extracts to the <Agent_Home> directory. WPS.pbd contains all the tracers needed for providing metrics in a WPS environment, which includes WPS components including WESB. WESB.pbd
The ProbeBuilder Directives file containing the tracers required to enable your application to collect WESB components-related metrics.
WESB.pbd automatically extracts to the <Agent_Home> directory. WESB.pbd contains all the tracers needed for providing metrics in standalone WESB environment. WPSAgentExt.jar
Extension to the Introscope Agent required by Introscope SPM WPS/WESB. directory.
4 You now need to configure the Introscope SPM WPS/WESB Java Agent extensions. The Introscope SPM WPS/WESB Agent extension is extracted. Based on your environment, proceed to the appropriate configuration topic. Platform
WPS WESB
Configuring Introscope SPM WPS Agent extensions on page 75 Configuring Introscope SPM WESB Agent extensions on page 79
Implementation Guide
Prerequisites
Be sure youve carried out these prerequisites before you configure the Introscope SPM WPS Agent extension:
While configuring a Introscope SPM WPS Agent extension, the server should
not be running. Stop the server before starting the configuration. To configure Introscope SPM WPS Agent extensions: 1 Modify the agent configuration properties. a Open the IntroscopeAgent.profile file in <Agent_Home>. b Search for the introscope.autoprobe.directivesFile property. c Add WPS.pbd to the introscope.autoprobe.directivesFile property. For example:
introscope.autoprobe.directivesFile=webspheretypical.pbl,WPS. pbd,hotdeploy
Note The WPS.PBD retrieves the metrics related to both the WPS and WESB tiers. d Save and close the IntroscopeAgent.profile file.
2 Optional: Configure IntroscopeAgent.profile so Introscope SPM monitors WebSphere PMI metrics. If you want to view Performance Monitoring Infrastructure (PMI) metrics in Introscope SPM Investigator for the WPS-related components, you need to perform some configuration. Prerequisites The Introscope PowerPack for WebSphere Application Server Distributed v8.0 must be installed and configured. For more information, see the Introscope PowerPack for IBM WebSphere Application Server Distributed User Guide. a Open the IntroscopeAgent.profile file in <Agent_Home>. b Search for these properties:
introscope.agent.pmi.enable.WBIStats.RootGroup introscope.agent.pmi.enable.SCAStats.RootGroup,
then choose the next step to go to depending on your environment. If the PMI properties are then go to this step below
In IntroscopeAgent.profile and set to true step c In IntroscopeAgent.profile and set to false step d Not in IntroscopeAgent.profile step e
c If the properties below are already present and set to true, no configuration is needed, and you can go to step 3 below.
introscope.agent.pmi.enable.WBIStats.RootGroup=true introscope.agent.pmi.enable.SCAStats.RootGroup=true
d If the properties below are set to false, you must configure them by changing them to true as shown.
introscope.agent.pmi.enable.WBIStats.RootGroup=true introscope.agent.pmi.enable.SCAStats.RootGroup=true
e If these properties are not in IntroscopeAgent.profile, add them to IntroscopeAgent.profile and set them to true to enable PMI metrics reporting in Introscope SPM:
introscope.agent.pmi.enable.WBIStats.RootGroup=true introscope.agent.pmi.enable.SCAStats.RootGroup=true
f Save and close the IntroscopeAgent.profile file. 3 Optional: Configure WPS.pbd to provide separate metrics for different versions of a Business Process. Note Use the default configuration unless your environment has a business process that has more than one version.
Implementation Guide
a Go to the <Agent_Home> directory and open the WPS.pbd file. b Comment the ProcessCustomTracer and ProcessFaultTracer parameters as shown before you use the ProcessAndTimeNameFormatter.
#SetTracerParameter:
ProcessCustomTracer nameformatter
com.wily.powerpack.websphereprocserver.nameformatter.Process ContextFormatter
#SetTracerParameter:
ProcessFaultTracer nameformatter
com.wily.powerpack.websphereprocserver.nameformatter.Process ContextFormatter
c Uncomment the ProcessCustomTracer and ProcessFaultTracer parameters as shown to get the time attribute.
com.wily.powerpack.websphereprocserver.nameformatter.Process AndTimeNameFormatter
SetTracerParameter:
ProcessFaultTracer nameformatter
com.wily.powerpack.websphereprocserver.nameformatter.Process AndTimeNameFormatter
d Save and close WPS.pbd. 4 Optional: Configure the WPS.pbd to see the activities executed in the Business Process Execution. Important There is significant agent CPU overhead involved in sending the activities names data to the Enterprise Manager, therefore activity tracing is off by default. Turn on activity tracing only when required. a Go to the <Agent_Home> directory and open the WPS.pbd file. b Uncomment ActivityTracing and ActivityResponseTracing as shown to see the activities executed in the Business Process Execution.
c Save and close WPS.pbd. 5 Start the WPS application server into which the Introscope SPM WPS Agent extension is installed. This restarts the Agent and loads the Introscope SPM WPS Agent extension. 6 If you performed Optional: Configure IntroscopeAgent.profile so Introscope SPM monitors WebSphere PMI metrics. on page 76, enable the WPS/WESB specific modules from the Admin console. See the IBM WPS/WESB documentation about enabling modules in the Admin Console.
7 Verify that the Introscope SPM WPS Agent extension is successfully installed and configured. a Open the IntroscopeAgent.log in the <Agent_Home>\logs folder. b Look for this log message (where xxxxxx is the build number)
[INFO] [IntroscopeAgent.WebSphereProcessServer_WESB] Started Introscope SOAExtension for IBM WebSphere ProcessServer and WESB Release <version> (Build xxxxxx).
If you see the log message, the Introscope SPM WPS Agent extension is successfully loaded and running. If you do not see the log message, review and verify the installation and configuration instructions. 8 Verify your deployment by invoking any application having WPS-specific components and verifying that the WProcServer node exists in the Investigator tree. The Introscope SPM WPS Agent extension is installed and configured. Now extract the Introscope SPM WPS EM extension. See Extracting Introscope SPM WPS EM extensions on page 82.
introscope.autoprobe.directivesFile property.
c Remove any properties added to monitor WebSphere PMI metrics. See Optional: Configure IntroscopeAgent.profile so Introscope SPM monitors WebSphere PMI metrics. on page 76. d Save and close the IntroscopeAgent.profile file. 3 Delete the WPSAgentExt.jar file from the <Agent_Home>/ext directory. The Introscope SPM WPS Agent extension is uninstalled.
Implementation Guide
then choose the next step to go to depending on your environment. If the PMI properties are then go to this step below
In IntroscopeAgent.profile and set to true step c In IntroscopeAgent.profile and set to false step d Not in IntroscopeAgent.profile step e
c If the properties below are already present and set to true, no configuration is needed, and you can go to step 3 below.
introscope.agent.pmi.enable.WBIStats.RootGroup=true introscope.agent.pmi.enable.SCAStats.RootGroup=true
d If the properties below are set to false, you must configure them by changing them to true as shown.
introscope.agent.pmi.enable.WBIStats.RootGroup=true introscope.agent.pmi.enable.SCAStats.RootGroup=true
e If these properties are not in IntroscopeAgent.profile, add them to IntroscopeAgent.profile and set them to true to enable PMI metrics reporting in Introscope SPM:
introscope.agent.pmi.enable.WBIStats.RootGroup=true introscope.agent.pmi.enable.SCAStats.RootGroup=true
f Save and close the IntroscopeAgent.profile file. 3 Restart the WESB application server into which the Introscope SPM WESB Agent extension is installed. This restarts the Agent and loads the Introscope SPM WESB Agent extension. 4 If you performed Optional: Configure IntroscopeAgent.profile so Introscope SPM monitors WebSphere PMI metrics. on page 79, enable the WPS/WESB specific modules from the Admin console. See the IBM WPS/WESB documentation about enabling modules in the Admin Console. 5 Verify that the Introscope SPM WESB Agent extension is successfully installed and configured. a Open the IntroscopeAgent.log in the <Agent_Home>\logs folder.
Implementation Guide
b Look for this log message (where xxxxx is the build number).
[INFO] [IntroscopeAgent.WebSphereProcessServer_WESB] Started Introscope SOAExtension for IBM WebSphere ProcessServer and WESB Release <version> Build xxxxxx).
c If you see the log message, the Introscope SPM WESB Agent extension is successfully loaded and running. d If you do not see the log message, review and verify the installation and configuration instructions. 6 Verify your deployment by invoking any application having WESB-specific components and verifying that the WESB node exists in Introscope Investigator tree. The Introscope SPM WESB Agent extension is configured. Now extract the Introscope SPM WESB EM extension. See Extracting and configuring Introscope SPM WESB EM extensions on page 85.
introscope.autoprobe.directivesFile property.
c Remove any properties added to monitor WebSphere PMI metrics. See Optional: Configure IntroscopeAgent.profile so Introscope SPM monitors WebSphere PMI metrics. on page 76. d Save and close the IntroscopeAgent.profile file. 3 Delete the WPSAgentExt.jar file from the <Agent_Home>/ext directory. The Introscope SPM WESB Agent extension is uninstalled.
Prerequisites
You must have installed and configured the appropriate version of the
on which you want to install the WPS EM extension as well, see Extracting and configuring WPS and WESB EM extensions on the same Enterprise Manager or MOM on page 88. To extract Introscope SPM WPS EM extensions: 1 Stop the Enterprise Manager on which you will install the Introscope SPM WPS EM extension. 2 Choose from this table the Introscope SPM WPS EM extension archive appropriate for your environment. Operating System
Windows
EM Extension Archive
V<version>EM.zOS.tar
3 In the temp directory into which the installation archive was installed and extracted (see Downloading and extracting the Introscope SPM WPS/WESB installation archive on page 70), locate the appropriate EM extension archive chosen in step 2.
Implementation Guide
4 Extract all files in the Introscope SPM WPS EM extension archive file to the <EM_Home> directory. Note If youre extracting Introscope SPM WPS EM extensions in a Unix or z/OS environment, use the appropriate command in this table. OS
Unix (AIX, Linux, Solaris) z/OS
The Introscope SPM WPS EM extension archive contains these files: File Description
Extension to the Introscope Workstation. Enables the Workstation to show the Overview tab for WPS components when any metric node under the WProcServer node is selected in the Investigator tree.
wps.overview.tv.xml
WPS_Management_ModuleV<version>.jar
automatically extracts to the <EM_Home>/deploy directory. When the Enterprise Manager is started, WPS_Management_ModuleV<version>.jar is automatically moved to the <EM_Home>/config/ modules directory.
WESB_Management_ModuleV<version>. jar
Introscope SPM WESB management module that Enables the Workstation to show WESB health in dashboards. Contains pre-configured WESB dashboards, metrics groupings and alerts.
directory. When the Enterprise Manager is started, WESB_Management_ModuleV<version>.jar is automatically moved to the <EM_Home>/config/ modules directory.
File
Description
Calculator that aggregates the metrics for each Mediation Flow component and its operations. See About aggregated metrics for mediation flows on page 281.
com.wily.powerpack.websphereprocs erver.em.ext_<version>.jar
Note: The version number in this file name
includes only three digits. For example, 8.1.0.
directory.
5 Delete the WESB_Management_ModuleV<version>.jar file from the <EM_Home>/deploy directory. 6 Start the Enterprise Manager. 7 Verify your installation. See Verifying your Introscope SPM WPS deployment on page 89. The Introscope SPM WPS EM extension is installed.
WPS_Management_ModuleV<version>.jar.
3 Delete <EM_Home>/ext/xmltv/wps.overview.tv.xml. 4 Delete <EM_Home>/product/enterprisemanager/plugins/
com.wily.powerpack.websphereprocserver.em.ext_<version>.jar.
Note The version number in this file name includes only three digits. For example, 8.1.0. 5 Start the Enterprise Manager. The Introscope SPM WPS EM extension is uninstalled.
Implementation Guide
Prerequisite
You must have installed and configured the appropriate version of the
on which you want to install the WESB EM extension as well, see Extracting and configuring WPS and WESB EM extensions on the same Enterprise Manager or MOM on page 88. To extract Introscope SPM WESB EM extensions: 1 Stop the Enterprise Manager on which you will install the Introscope SPM WESB EM extension. 2 Choose from this table the Introscope SPM WESB EM extension archive appropriate for your environment. Operating System
Windows Unix (AIX, Linux, Solaris) z/OS
EM Extension Archive
4 Extract all files in the Introscope SPM WESB EM extension archive file to the <EM_Home> directory. Note If youre extracting Introscope SPM WESB EM extensions in a Unix or z/OS environment, use the appropriate command in this table. OS
Unix (AIX, Linux, Solaris) z/OS
File
Description
Extension to the Introscope Workstation. Enables the Workstation to show the Overview tab for WESB components when any metric node under the WESB node is selected in the Investigator tree.
wps.overview.tv.xml
dashboards.
Contains pre-configured WPS dashboards, metrics
directory. When the Enterprise Manager is started, WPS_Management_ModuleV<version>.jar is automatically moved to the <EM_Home>/config/ modules directory.
Implementation Guide
File
Description
Introscope SPM WESB management module that Enables the Workstation to show WESB health in dashboards. Contains pre-configured WESB dashboards, metrics groupings and alerts.
WESB_Management_ModuleV<version>. jar
directory. When the Enterprise Manager is started, WESB_Management_ModuleV<version>.jar is automatically moved to the <EM_Home>/config/ modules directory.
com.wily.powerpack.websphereprocs erver.em.ext_<version>.jar
Note: The version number in this file name
includes only three digits. For example, 8.1.0.
Calculator that aggregates the metrics for each Mediation Flow component and its operations. See About aggregated metrics for mediation flows on page 281.
5 Delete the WPS_Management_ModuleV<version>.jar file from the <EM_Home>/ deploy directory. 6 Start the Enterprise Manager. 7 Verify your installation. See Verifying your Introscope SPM WESB deployment on page 90. The Introscope SPM WESB EM extension is installed.
WESB_Management_ModuleV<version>.jar.
3 Delete <EM_Home>/ext/xmltv/wps.overview.tv.xml. Delete <EM_Home>/product/enterprisemanager/plugins/
com.wily.powerpack.websphereprocserver.em.ext_<version>.jar.
Note The version number in this file name includes only three digits. For example, 8.1.0. 4 Start the Enterprise Manager. The Introscope SPM WESB EM extension is uninstalled.
Extracting and configuring WPS and WESB EM extensions on the same Enterprise Manager or MOM
These topics describe how you extract and configure an Introscope SPM WPS or WESB EM extension when either the Introscope SPM WPS or the WESB EM extension is already installed on your Enterprise Manager or MOM and you want to install the other extension. This allows you to view all the dashboards, tabs, and metrics for the additional platform. To extract and configure WESB extensions in an existing Introscope SPM WPS environment: If you
are running both Websphere Process Server and Websphere Enterprise Service
implementations to a single Enterprise Manager or MOM then you must perform these additional configuration steps. 1 Carry out step 1 through step 3 of To extract Introscope SPM WESB EM extensions: on page 85. 2 Extract to <EM_Home> only the WESB_Management_ModuleV<version>.jar file which provides Introscope SPM WESB dashboards, tabs, and metrics. The WESB_Management_ModuleV<version>.jar file should automatically extract to the <EM_Home>\deploy directory.
If the WESB_Management_ModuleV<version>.jar file extracts to the
Implementation Guide
To extract and configure WPS extensions in an existing Introscope SPM WESB environment: If you
are running both the Websphere Process Server and the Websphere Enterprise
implementations to a single Enterprise Manager or MOM then you must perform these additional configuration steps. 1 Carry out step 1 through step 3 of To extract Introscope SPM WPS EM extensions: on page 82. 2 Extract to <EM_Home> only the WPS_Management_ModuleV<version>.jar file, which provides Introscope SPM WPS dashboards, tabs, and metrics. The WPS_Management_ModuleV<version>.jar file should automatically extract to the <EM_Home>\deploy directory.
If the WPS_Management_ModuleV<version>.jar file extracts to the
4 In the Workstation Management Module Editor, verify the WPS_Management_Module <version> node. a Choose Workstation > New Management Module Editor. b Under SuperDomain, see the WPS_Management_Module <version> node. This verifies that the WPS_Management_ModuleV<version>.jar file loaded properly. 5 If the agent is installed and configured properly, you can see a message in the Introscope Agent log file stating the Introscope SPM WPS Agent extension version that started. For example:
[INFO] [IntroscopeAgent.WebSphereProcessServer_WESB] Started Introscope SOAExtension for IBM WebSphere ProcessServer and WESB Release <version> (Build xxxxxx).
Implementation Guide
5 If the agent is installed and configured properly, you can see a message in the Introscope Agent log file stating the Introscope SPM WESB Agent extension version that started. For example:
[INFO] [IntroscopeAgent.WebSphereProcessServer_WESB] Started Introscope SOAExtension for IBM WebSphere ProcessServer and WESB Release <version> (Build xxxxxx).
CHAPTER
Introscope SPM enables you to monitor web services by viewing web service related metrics in Introscope. This chapter discusses using the Introscope Console and Investigator to view and interpret web service metrics. Viewing web services data in Introscope SPM . SOA Performance Management dashboards SOA Performance Management tabs . Viewing agent web service metrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 95 105 128 132 138 140
Viewing Introscope SPM metric groupings and alerts Checking the health of your web services .
WebServices
Client or Server
web service
Graphs showing the current level of activity for these metrics for the selected operation: Average Response Time Concurrent Invocations Errors Per Interval Responses Per Interval SOAP Faults Per Interval Stall Count
Implementation Guide
Workstation. Note The Introscope Enterprise Manager must be started before starting the Workstation. When you start the Introscope Workstation, you see the Console containing various Introscope dashboards. With Introscope SPM, you get six custom dashboards in addition to those provided with Introscope. Dashboards are a quick way to check on the health of your web services in Introscope SPM. Color-coded alerts (green, yellow, red) tell you in a glance how your web services are performing. For more information about Introscope SPM dashboards, see SOA Performance Management dashboards on page 95. To see Introscope metrics for web services in a tree view, you can look in the Investigator. Here, you see metrics about web services within each agent, aggregated across agents, as well as web service errors and Transaction Traces. For detailed information on using the Workstation, see the Introscope Workstation User Guide. For more information about Introscope SPM metrics, see SOA Performance Management tabs on page 105.
terms of client and server performance and alert summary. For more information, see Introscope SPM Performance Overview dashboard on page 96.
Introscope SPM Client Health: Shows the clients performance. For more
service operations. For more information, see Introscope SPM Most Critical Operations dashboard on page 101.
web service operations. For more information, see Introscope SPM Most Dependent Operations dashboard on page 102.
Introscope SPM Busiest Operations: Shows the busiest web service
operations. For more information, see Introscope SPM Busiest Operations dashboard on page 104.
Introscope SPM comes with default caution/danger alert thresholds for many
of the performance metrics displayed in the dashboards. See the Introscope Workstation User Guide for information on customizing these alerts and thresholds to your environment. To view dashboards: 1 Start the Introscope Workstation Console. 2 Select a dashboard from the drop-down list.
Implementation Guide
Note The default Average Response Time danger and caution threshold settings for the Client (2.5 and 5.5 seconds) are set slightly higher than for the Server (2 and 5 seconds) to allow for network latency. To get more information:
Double-click one of the top 10 slowest services to see the Investigator metrics
side issue
yellow/red client + yellow/red server = probably a server problem
client, the request is processed and fulfilled by the server, and a response message comes back to the client that the request has been fulfilled and is complete. With synchronous web service invocations, the response time on the server side will never be longer than the response time on the client side, because the client time includes the server time.
In asynchronous web service invocations, the request message leaves the
client, the server receives the request and sends a confirmation response message back to the client. The request may or may not have been fulfilled when the server sends the confirmation message. Asynchronous web service invocations occur when the web service implementation needs more information to fulfill the request, or the request needs to be sent to another web service or database. In an asynchronous environment, the client-side Average Response Time is never indicative of the entire time to process a request. Introscope displays only the time it takes to receive the confirmation of the request, not the fulfillment of the request.
Implementation Guide
represents the average of response times for all methods or operations in the web service
Client Services Responses Per Intervaltotal responses for all web services
Implementation Guide
represents the average of response times for all methods or operations in the web service
Server Services Responses Per Intervaltotal responses for all web services
For more information about these metrics, see Using the Most Critical tab on page 124. To get more information:
Double-click one of the top 10 Most Critical Operations to see the Investigator
Implementation Guide
Use the dashboard to monitor the most dependent operations for all agents and the Deviations tab in the Investigator for triage purposes for a single agent. For more information about the Deviations tab, see Using the Deviations tab on page 118.
Double-click an operation to see it in the Investigator.
For more information about these metrics, see Using the Most Dependent tab on page 125. To get more information:
Double-click one of the top 10 most dependent operations to see the Investigator
services
Busiest Server Operations Responses Per Intervaltotal responses for all web
for that operation. Hover your mouse cursor over any data point to display a tool-tip showing details for that web services data point.
Implementation Guide
2 Click the WebServices node, and then click the Overview tab in the Viewer pane. You can view two tables showing the agent client and server web service namespace metrics. When you select one of the metrics, a graph appears below the Client or Server list of metrics, showing details for the selected metric. Hover your cursor over any data point in the graph to view more information about the data point.
This is the WebServices node. Notice the namespace metrics for both the agents client and server.
Implementation Guide
3 Click the Client or Server node, and then click the Overview tab in the Viewer pane. You can view a table showing the client or server namespace metrics. When you select one of the metrics, a graph appears below the Client or Server list of metrics, showing details for the selected metric. Hover your cursor over any data point in the graph to view more information about the data point.
Client node. Server node. Namespaces label.
Note The data displayed in the graph at the bottom of Viewer pane is by default the Average Response Time. However, you can see other metric data by clicking the column header of that metric in the table. For example: to see Errors Per Interval metrics in the graph, click the column header of Errors Per Interval metric column.
4 Click a web service node, and then click the Overview tab in the Viewer pane. You can view a table showing the operations metrics for the selected web service. When you select one of the metrics, a graph appears below the list of web service metrics, showing details for the selected metric. Hover your cursor over any data point in the graph to view more information about the data point.
This is a web service node.
Implementation Guide
5 Click an operation name (method) node, and then click the Overview tab in the Viewer pane.
This is an operation node.
For the selected operation (method), you can view a graph of the current activity level for each of these metrics:
Average Response Time Concurrent Invocations Errors Per Interval Responses Per Interval SOAP Faults Per Interval Stall Count
Hover your cursor over any data point in the graph to view more information about the data point.
In a transaction consisting of multiple operations, direct operations are those that are immediately upstream or downstream from another operation. In the example above, Operations A and B are direct operations; so are B and C. On the SOA Dependency Map, direct operations are located immediately adjacent to each other. See Getting to know the SOA Dependency Map on page 146. In a transaction consisting of multiple operations, indirect operations are either upstream or downstream from another operation, but are not directly adjacent to it. For example if Operation A calls two other Operations (B and C), which are each calling operations themselves (B is calling D and C is calling E), then Operations D and E are indirect operations in relationship to Operation A. On the SOA Dependency Map, indirect operations not located adjacent to each other. See Getting to know the SOA Dependency Map on page 146.
Implementation Guide
critical operation.
Critical Indirect metric The number of operations directly and indirectly
upstream from this critical operation. For example, if the Critical Indirect metric value for Operation A is 5, that means that five direct or indirect operations execute prior to Operation A executing.
indirectly downstream from this dependent operation. For example, if the Dependency Indirect metric value for Operation C is 8, that means that eight direct or indirect operations that are downstream from Operation C must complete in order for Operation A to execute.
3. Introscope SPM displays these metrics for SayHello server 5: Critical Direct: 1 Critical Indirect: 2 Dependency Direct: 0 Dependency Indirect: 0
Implementation Guide
Heres what the Introscope SPM metric values would be for the two operations shown above. Operation name in figure Test Server Associated metrics Direct Critical to none Indirect Critical to none Metric value for Critical Direct = 0 Metric value for Critical Indirect = 0 Direct Dependency on Hello Clients 1, 2, 3, 4 Indirect Dependency on Hello Servers 5, 6, 7, 8 Metric value for Dependency Direct = 4 Metric value for Dependency Indirect = 8 Direct Critical to Say Hello Client 1 Indirect Critical to Test Server Metric value for Critical Direct = 1 Metric value for Critical Indirect = 2 Direct Dependency on none Indirect Dependency on none Metric value for Dependency Direct = 0 Metric value for Dependency Indirect = 0
SayHello Server 5
Client or Server
namespace
Note:
Dependencies table listing the operations and its associated dependency metrics that belong The node name displayed is to the selected web service. the name of web service in use by the Agent application client or server.
Note If there are no dependencies that exist between clients, servers, or operations, then Introscope SPM cannot gather and display dependencies metrics in the Introscope SPM dashboards, Dependencies tab, or the SOA Dependency Map. If your environment does have SOA dependencies, upon startup it can take Introscope SPM about 30 minutes to gather dependency data. During this period, no dependency data displays in the Introscope SPM dashboards, Dependencies tab, or the SOA Dependency Map. In addition, you may not see any deviation metrics for the first 70 minutes if you don't invoke any transactions that use web services within first 10 minutes after start up. This is because Introscope SPM refreshes the SOA Dependency Map once an hour. You can change the refresh rate by updating the
com.wily.introscope.soa.deviation.dependency.refreshrate
property value. See Introscope SPM EM extension properties on page 327.
Implementation Guide
To use the Dependencies tab: 1 Click the WebServices node, and then click the Dependencies tab in the Viewer pane. You can view two tables showing the Agent client and server web service namespace metrics.
Notice the dependencies metrics display for these operations. If there are multiple entries for an operation look at the first column to see the service to which it belongs.
2 Click the Client or Server node, and then click the Dependencies tab in the Viewer pane. You can view a table showing the client or server namespace metrics.
Heres the Client node.
Implementation Guide
3 Click a namspace node, and then click the Dependencies tab in the Viewer pane. You can view a table showing the operations with critical and dependent metrics for the selected web service.
This is the namespace node.
time, which includes the time spent processing the request on the application server and the time it takes for the browser to receive the HTML response and load associated images per interval.
Errors Per Interval DeviationThe deviation of the number of exceptions
reported by JVM and HTTP error codes, which might include a 404 Page Not Found status reported by the HTTP server, a SQL exception, or a Java exception.
Responses Per Interval DeviationThe deviation of invocations finished
within an interval; it is a measure of data throughput and thus of application performance. Introscope SPM provides a series of Deviations tabs in several locations in the Introscope Investigator. When viewing deviations metrics in the Deviations tabs, the deviation metric data is shown for each namespace and operation unless viewed at the namespace level. In this case, the deviation metric data displays only for the operation.
Implementation Guide
Use these tabs to view deviation metrics for web services. This table lists brief descriptions of the Deviations tabs based on their locations in the Introscope Investigator tree: Investigator tree node name
WebServices
Client or Server
namespaces
Note:
Deviations table listing the operations and its deviation metrics that belong to the selected The node name displayed is web service. the name of web service in use by the Agent application client or server.
Important Introscope SPM computes the deviation from the mean for web service operations metrics. The computation of the mean value is based on a rolling "n" day mean. Therefore, out of the box deviation data is only available for operations. For deviations to be available at the namespace level, you must configure the deviation properties in the Enterprise Manager. For more information, see Introscope SPM EM extension configuration properties on page 325. To use the Deviations tab: Note If there are no dependencies that exist between clients, servers, or operations, then Introscope SPM cannot gather and display dependencies metrics in the Introscope SPM dashboards, Deviations tab, or the SOA Dependency Map. If your environment does have SOA dependencies, upon startup, it can take Introscope SPM about 30 minutes to gather deviations data. During this period, no deviations data will display in the Introscope SPM dashboards, Deviations tab, or the SOA Dependency Map. If your environment does have SOA dependencies, upon startup it can take Introscope SPM about 30 minutes to gather dependency data.
During this period, no dependency data displays in the Introscope SPM dashboards, Deviations tab, or the SOA Dependency Map. In addition, you may not see any deviation metrics for the first 70 minutes if you don't invoke any transactions that use web services within first 10 minutes after start up. This is because Introscope SPM refreshes the SOA Dependency Map once an hour. You can change the refresh rate by updating the
com.wily.introscope.soa.deviation.dependency.refreshrate
property value. See Introscope SPM EM extension properties on page 327. 1 Click the WebServices node, and then click the Deviations tab in the Viewer pane. You can view two tables showing the Agent client and server web service namespace metrics.
Implementation Guide
The figure below displays metric data configured to show namespace instead of operation name. You can make such a configuration to the com.wily.introscope.soa.deviation.metric.expressionlist and com.wily.introscope.soa.deviation.metric.calledbackends properties in the IntroscopeEnterpriseManager.properties file. Introscope SPM out of the box displays deviation metrics for only for operations. For more information about the configuration required to display deviation metrics data, see Introscope SPM EM extension configuration properties on page 325.
This table displays the Agent client web service namespace metrics. Heres the Deviations tab.
This table displays the Agent server web service namespace metrics.
1 Click the Client or Server node, and then click the Deviations tab in the Viewer pane. You can view a table showing the client or server namespace metrics. Note The figure below displays metric data based on deviation properties configured in the IntroscopeEnterpriseManager.properties file. Introscope SPM out of the box displays deviation metrics for only for operations. For more information about the configuration required to display deviation metrics data, see Introscope SPM EM extension configuration properties on page 325.
Heres the Client node.
Implementation Guide
2 Click a namspace node, and then click the Deviations tab in the Viewer pane. You can view a table showing the operations with deviations metrics for the selected web service.
Heres a namespace node. Heres the table displaying operations with Average Response Time Deviation, Errors Per Interval Deviation, and Responses Per Interval
Implementation Guide
The top ten most critical operations display, as do these deviation metrics in graph format:
Average Response Time Deviation Errors Per Interval Deviation Responses Per Interval Deviation
Viewer pane.
The top ten most dependent operations for the agent display as do these deviation metrics in graph format:
Average Response Time Deviation Errors Per Interval Deviation Responses Per Interval Deviation
Implementation Guide
The bottom pane of the Errors tab, which is called the Error Snapshot, shows detailed information in red about the error selected in the list above. SOAP fault error messages have the prefix SOAP Fault at the beginning of the error message name.
This is the Server node. This is the Errors tab.
3.
Notice that SOAP fault error messages include SOAP Fault at the beginning of the error message.
In addition to the five Introscope basic metrics, Introscope SPM provides these metrics for each operation in a web service:
SOAP Faults Per Interval: how many SOAP Faults are produced or consumed
by the SOAP platform that are recorded by the Introscope SPM Agent extension in a 15-second time slice Note For more information about Errors Per Interval, SOAP Faults Per Interval, and Errors displayed in ErrorDetector, see About error and SOAP fault metrics on page 129.
Critical Direct Top N Critical Indirect Top N Dependent Direct Top N Dependent Indirect Top N What deviation graphs you have to create (if appropriate)
There are various ways to view web service metrics in the Investigator:
Metrics per Introscope Agent (see page 132) Metrics aggregated across all Introscope agents (see page 135)
Implementation Guide
Is monitored by
Introscope Java or .NET Agent
Reported here
Introscope SPM Investigator tree nodes, dashboards, tabs, and SOA Dependency Map See the topics in this chapter and Using the SOA Dependency Map for triage on page 176.
SOAP faults that are produced or consumed by the SOAP platform. See SOAP Faults Per Interval metric on page 131.
Introscope SPM Investigator tree nodes, dashboards, tabs, and SOA Dependency Map See the topics in this chapter and Using the SOA Dependency Map for triage on page 176.
ErrorDetector
Errors for J2EE resources and ErrorDetector Live or Historical Error Viewer .NET Framework resources. See ErrorDetector Errors Per See Viewing web Interval metric on page 132. service faults in ErrorDetector on page 204.
Implementation Guide
WebServices|Client|<endpoint>|UnknownOperationName
For example, what you see may look like this:
WebServices|Client|http://ca.travel.com travel|UnknownOperationName
To view web service metrics per agent: 1 Open an Introscope Investigator window.
Implementation Guide
2 Expand the Introscope Agent node youre interested in. Web service metric data appears in the Investigator tree under the agents WebServices node. Under the WebServices node is a Client node and a Server node.
Agent node WebServices node
Client node
Server node
3 Expand the Client and Server nodes to see the web services listed under each. 4 Expand each web service to see its individual operations.
Implementation Guide
See About Introscope SPM metrics on page 128. To view web service metrics aggregated across all agents: In order to view metric totals aggregated across all agents, you must have defined a virtual agent by configuring the agentclusters.xml file. See Configuring virtual agents for Introscope SPM on page 54. 1 In the Investigator, expand the Virtual Agent node defined in the agentclusters.xml configuration. You can see all the web service metric totals across all agents. 2 Expand each web service name to see the metrics defined for each operation.
In the figure below, the WebServicesVirtualAgent node under the Introscope SuperDomain shows the aggregated web service server metrics.
WebServicesVirtualAgent node Here are the server metrics configured to be aggregated in the WebServicesVirtualAgent node.
Implementation Guide
To view web service alert states aggregated across all agents: 1 In the Investigator, expand the Custom Metric Host node, then the Alerts node below it. 2 Expand the SOA Performance Management <version> node.
1. Heres the Custom Metrics Host node. 2. Here are the Alerts and SOA Performance Management <version> nodes.
3. When you choose an alert in the Investigator tree (see highlighted alert), you can then see its alert state. In this case, the Individual Server Average Response Time alert state is 3 or red.
Implementation Guide
3 The Introscope SPM-specific metrics groupings and alerts appear, as shown in this figure.
SOA Performance Management <version> node SOA Performance Management alerts
This dashboard gives you an overview of the health of your web services. The alerts in the client and server health areas of the dashboard helps you determine how web services are functioning together. The Top 10 Slowest Client and Server services help to pinpoint services you may want to adjust for better performance. You can double-click a service in the Top 10 lists to open the Introscope Investigator and view more specific data.
Implementation Guide
Step 2 Double-click a tab at the top of the SOA Performance Management Overview dashboard to open other dashboards. Below you see the SOA Performance Management Client Health dashboard, which gives a more specific look at the health of your client.
You can hover your cursor over data points in the graphs to view specific information about that data point.
Step 3 From the SOA Performance Management Client Health dashboard, doubleclick one of the top 10 slowest operations to go to see it in the Investigator.
Double-clicking an operation on the dashboard takes you to its response time metric in the Investigator.
Implementation Guide
Step 4 You look at business transactions of interest in the Investigator by running a Transaction Trace Session. This shows you a set of transactions meeting your criteria, and for each transaction found, shows you the individual performance of each part of the transaction.
CHAPTER
This chapter includes these topics: Getting to know the SOA Dependency Map . SOA Dependency Map components . Setting up the SOA Dependency Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 151 159 161 166 169 176 180
Choosing a SOA Dependency Map content type Choosing a SOA Dependency Map view . Navigating the SOA Dependency Map SOA Dependency Map FAQs . . . . .
With different groups in your organization developing and deploying services, no single architectural diagram can summarize the overall deployment of services. Even when there is a process in place to record deployed services, you may not be involved or informed. And even if youre informed, the service repository list of services may or may not be up-to-date. Even when services are in the registry, the dependencies and names of the services are static, and thus quickly become stale. One reason for this is when new applications are deployed, they may embed services that are then discovered by other developers. These hidden services then become missioncritical for other applications, yet remain unknown to your organization until they manifest in a critical problem. Your problem is that even with these challenges, your organization expects you to be responsible for the health and availability of all services. You are successful when you can become aware of all services within the SOA environment in an automatic and timely mannerpreferably in real-time or close to real-time. Introscope SPM allows you to fulfill your mission.
Implementation Guide
The SOA Dependency Map displays three kinds of client-server dependency relationships in your SOA environment: between agents, web services, and web service operations. If you are new to the SOA world, terms such as services, operations, faults, and dependencies may seem strange and unfamiliar because you are used to dealing with concepts like applications, transactions, front-ends, and back-ends. However, when using Introscope, you often work with agents and operation names. From examining these in the SOA Dependency Map, youll quickly learn how web services clients and servers relate to agents and operations. Briefly, front-ends and back-ends are similar to clients and servers, respectively. Web services consist of one or more operations. A dependency exists when the implementation of one operation invokes a subsequent operation, often belonging to a different web service and running in a different application server. For example, a travel-agent web service that books a flight may invoke a web service belonging to an airline to place the reservation, and another web service belonging to a credit-card processor to charge the customer. There are dependencies between the travel-agent web service and the airline web service, and between the travel-agent web service and the credit-card processor web service. Dependencies between web services often result from combining web services to form higher order-web services. To continue the example, a failure or performance problem with either of the constituent web services affects the behavior of the travel-agent web service. The SOA Dependency Map shows all of the web services in your SOA environment, as well as the graphical structure of web service operations with their dependencies and the performance of those dependent operations. This helps you understand the root-cause analysis for slow responses, faults, and so on. Knowledge and exploitation of the dependencies between web services is a useful aspect of root cause determination when you receive alerts.
How the SOA Dependency Map content type affects what you see
The first factor that the SOA Dependency Map uses to determine what to display is the SOA Dependency Map content type: agent, service, or operation. If you have selected a content type, for example Services, and then click an Investigator tree node, you will see a SOA Dependency Map showing only the services on the agents that relate to that node. But if you then switch to Agents content type and back to Services again, youll see all the services on every agent that is associated with that node. What this means is that a switch of content type applies to everything on the SOA Dependency Map. When you chose the Agents content type, and then the Services content type, SOA Dependency Map interprets this request as you wanting to see all the services on all the currently displayed agents. For more information, see Choosing a SOA Dependency Map content type on page 161.
Implementation Guide
To continue the real-life map analogy from the section above, this would be like viewing a map of cities connected by trains based on Japans largest city, Tokyo, and its trains to other major cities. If you decided to zoom out to a view of earths major cities connected by train, then back in to a map of Japan, youd see a map of all of Japans cities connected by train, rather than the map's focus being on Tokyo.
To help me
Get current accurate services information about my environment
Visually assess the global impact of Research and resolve my SOA problem services and drill down into environment problems the details of the problem within three to four mouse clicks
Work with IT architects by viewing Plan and carry out enterprise-wide Choosing a SOA Dependency Map view on page 166 both the physical and logical view of SOA initiatives my enterprise SOA environment Create SOA Dependency Map images to share with others Share the same view of service dependencies and problems with other collaborators in my organization who dont use Introscope SPM Understand what is going on in my SOA environment without needing an expert to interpret the service performance data Understand which agents, services, and operations are dependent on each other Reorient myself on the Investigator tree and the SOA Dependency Map based on my current map node location Outputting SOA Dependency Map images for sharing on page 177
View my SOA environment agents, services, and operations in the SOA Dependency Map View the dependency relationships of my monitored agents, services, and operations in the SOA Dependency Map Click on a map node and go to that component in the Investigator tree
Jumping from a SOA Dependency Map node to the associated Investigator tree node on page 171
Start a Transaction Trace session on a problem service directly from the SOA Dependency Map
Starting a Transaction Trace See all the Transaction Traces session from SOA Dependency associated with that problem service without needing to set up a Map on page 180 manual Transaction Trace
Implementation Guide
22
16 17
19
20
21
28
18
23
24
25
26
27
This legend table describes the SOA Dependency Map components and shows their associated icons. Icon or Image Map Component or Button Name
1. SOA Dependency Map tab
Description
Click to display the SOA Dependency Map associated with the node selected on the Investigator tree. Choose either a Physical or Logical representation of your web services environment.
3. Content type dropdown list If the Physical view is selected in the View dropdown, you can choose to display a map based on Operations, Services, or Agents content type. If the Logical view is selected, you can choose to base your map on either Operations or Services. The Custom Virtual Agent itself doesn't have a map, because it has no dependencies. However, you can choose to display a map of Custom Virtual Agent Services or Operations. The default view is the Physical view, unless the selected node is a child of a Custom Virtual Agent. The content type default depends on the selected nodefor an agent, it is Agents; for a service, it is Services; and for an operation, it is Operations. 4. Primary Metric dropdown list Choose one of the Introscope basic metrics to display for all operations and services shown on the map: Average Response Time Concurrent Invocations Errors Per Interval Faults Per Interval Stall Count Client-side operation icon that displays on the SOA Dependency Map when youve chosen the Physical view. Operation name of the displayed client. Most current value of the metric selected in the Primary Metric dropdown list for the displayed item. Each each map item has its own icon, name, and primary metric value. Select Introscope SPM metrics to display in tooltips in addition to displaying the Primary Metric data.
8. Tooltips button
Implementation Guide
Icon or Image
Description
Add a dependency (if one exists) for every lowestlevel agent, service, or operation item. If there are no additional dependencies, a message displays stating Additional dependencies not found.
Remove all the lowest-level dependencies from the SOA Dependency Map.
Drag the SOA Dependency Map around within the visible scrolling area.
Drag the mouse up and down to zoom in and out of the SOA Dependency Map. This can substitute for not having a wheel on your mouse.
Fits the entire current view of SOA Dependency Map within the tab.
Presents a dialog that lets you choose the image type and specify a file name for a graphical version of your current SOA Dependency Map. Server-side operation icon that displays on the SOA Dependency Map when youve chosen the Physical view.
17. Server operation name 18. Agent name 19. Arrow showing one web service item calling another Shows a web service item dependency.
20 Client service name 21 Server service icon Server-side service icon that displays on the SOA Dependency Map when youve chosen the Physical view.
Icon or Image
Description
Client-side service icon that displays on the SOA Dependency Map when youve chosen the Physical view. Server-side service icon that displays on the SOA Dependency Map when youve chosen the Logical view. Client-side service icon that displays on the SOA Dependency Map when youve chosen the Logical view.
Client-side operation icon that displays on the SOA Dependency Map when youve chosen the Logical view. Server-side operation icon that displays on the SOA Dependency Map when youve chosen the Logical view. Agent icon that displays on the SOA Dependency Map when youve chosen the Physical view Agent content type.
Implementation Guide
displays the Physical view and content type associated with that web service item.
If you select an agent in the Investigator tree, the SOA Dependency Map displays the Physical view showing the agent map node. If you select a service in the Investigator tree, the SOA Dependency Map displays the Physical view showing services map nodes. If you select an operation in the Investigator tree, the SOA Dependency Map displays the Physical view showing operations map nodes.
If you select the WebServices node in the Investigator tree, then the SOA
Dependency Map displays all the services or operations based on your view and content type choices. When viewing the SOA Dependency Map using the Operations content type, you can see:
client map nodes are in green boxes server map nodes are in blue boxes Agents map nodes are in gray boxes.
These colored boxes represent the services and agents to which these operations belong.
If you select a client or server operation in the Investigator tree, then the SOA
Dependency Map displays a partial dependency map for that specific client or server operation. Youll see the dependencies for the selected node plus one additional level of dependency by default when you select any node in the Investigator tree. You can unroll the dependencies in two ways to see more operations:
Use the Add Dependencies button to unroll or add another full level of dependencies. Right-click an individual item and choose Show Next Dependency from the menu.
For more information about standalone SOA Dependency Map nodes, see Choosing a SOA Dependency Map view on page 166. As Introscope SPM discovers SOA dependencies, the dependencies are added to the SOA Dependency Map. Attempting to add a previously discovered dependency has no effect on the SOA Dependency Map.
Implementation Guide
Note Introscope SPM requires time to discover all the web services in your environment and to collect data in order to display a complete SOA Dependency Map when you first install and deploy Introscope SPM and when you add a new web application to your environment. In these cases and others when data is not available, youll see a status message. For more informations, see Im experiencing a problem viewing the SOA Dependency Map. Whats wrong? on page 183. In addition, when Introscope SPM discovers a new dependency, the Enterprise Manager checks the SOA Dependency Map for possible logical equivalences. For information on Introscope SPM logical equivalence heuristics, see SOA Dependency Map FAQs on page 180.
The Enterprise Manager saves the most currently discovered dependencies in the SOA Dependency Map to the dependencymap.sav file once an hour, as well as during the standard manual Enterprise Manager shutdown process. The Enterprise Manager holds currently discovered dependencies in the SOA Dependency Map memory cache between dependencymap.sav file saves. If the Enterprise Manager stops suddenly, the restart loads the most recent copy of the SOA Dependency Map, which could be up to one hour old. The dependencymap.sav file contains all the discovered SOA Dependency Map dependencies. Upon Enterprise Manager start-up, the Enterprise Manager loads the SOA Dependency Map from the dependencymap.sav file so that Introscope SPM doesnt have to rediscover the previously discovered dependencies. If the the dependencymap.sav file doesnt exist, the SOA Dependency Map is created as described in SOA Dependency Map components on page 151. If you want the Enterprise Manager to ignore the saved SOA Dependency Map at start up, then you must delete, move, or rename both the dependencymap.sav and dependencymap.bak files. There are two cases when you may want the Enterprise Manager to ignore the saved SOA Dependency Map at startup:
When you want to change the enabling and disabling of logical equivalence
heuristics, and therefore want to force the Enterprise Manager to rediscover all dependencies and apply the rules according to the new settings. For more
information, see SOA Dependency Map FAQs on page 180 and the logical equivalence heuristics properties in Introscope SPM EM extension configuration on page 326.
When an agent is disconnected, all map nodes and dependencies sourced from
that agent are removed from the SOA Dependency Map. This might happen when your enterprise organization reconfigures its systems and changes the deployed applications. However, the disconnected agent can only be handled if the Enterprise Manager is running. If the Enterprise Manager happens to be stopped, then the agent unmount is not detected and the map nodes and dependencies remain displayed within the SOA Dependency Map until they age expire which, by default, takes 60 days. You may prefer to not display out-of-date data in the SOA Dependency Map. While the Enterprise Manager is stopped, the Workstation cannot be running. However, once the Enterprise Manager is restarted, then the Dependency Map displayed by the Workstation will still show the web services and their dependencies that belong to the disconnected agent. These are only removed from the map if the Enterprise Manager receives an unmount event for the agent. To delete, move, or rename the saved SOA Dependency Map file: 1 Stop the Enterprise Manager. Note If you delete the saved SOA Dependency Map files while the Enterprise Manager is running, then Enterprise Manager recreates the files from the SOA Dependency Map at the next hourly interval. 2 Navigate to the <EM_Home>/data/dependencymap directory. 3 Find and delete, move, or rename the dependencymap.sav file. 4 Find and delete, move, or rename the dependencymap.bak file. All former dependencies data is no longer available for display in the SOA Dependency Map. 5 Start the Enterprise Manager. Introscope SPM discovers all the current dependencies in the monitored SOAPbased applications and creates a new SOA Dependency Map.
Implementation Guide
Note The metrics that the SOA Dependency Map displays for agents and services are the aggregated values of all the web service operations under that agent or service, not just the map nodes currently selected or displayed on the SOA Dependency Map. For example, let's say you are examining a server-side service map node in the SOA Dependency Map. When you hover over the map node, tooltips display the metrics you've chosen to see. However, the server map node metrics can be due to client invocations that have a dependent client node as well as non-monitored clients, or clients that don't appear in the SOA Dependency Map. For example, a C++ client. All client invocations contribute to server-side metrics calculations.
Note The Average Response Time metric is the SOA Dependency Map default. The SOA Dependency Map client and server agent, service, and operation nodes display the current metric value for the Introscope basic metric you selected. In addition, the tooltips display additional information about the selected metric including min and max and count values, as appropriate for the metric and Investigator node youve selected.
Implementation Guide
To set SOA Dependency Map tooltips metrics: 1 Click the Tooltips button in the SOA Dependency Map tool bar. 2 Select the Introscope SPM metrics to be displayed as SOA Dependency Map tooltips. 3 Click OK. Based on the Investigator node youve selected, when you hover over a SOA Dependency Map client or server service or operation node, the SOA Dependency Map displays all or some of the selected metrics, depending on the metrics that the Enterprise Manager reports to that Investigator tree node. For example, if you are monitoring your critical operations and set the SOA Dependency Map to display the associated Dependency Direct tooltips metric, you will see data for this metric display when you hover over an Investigator tree operation node. However, if you hover over an Investigator tree services node, you will not see Dependency Direct tooltips metric displayed. This is because services dont generate data to calculate the Dependency Direct metric. Note Because the SOA Dependency Map always displays the Primary Metric data in tooltip, you cannot deselect the Primary Metric tooltip in the Choose Tootips Metrics dialog box. Tip If you set the SOA Dependency Map tooltips to display the Introscope SPM dependency and critical metrics, if you hover over a selected SOA Dependency Map node and these metrics display, this means that the selected component has upstream or downstream dependencies.
Its important to understand that the SOA Dependency Map displays first based on the content type youve chosen and then second based on the Investigator tree node youve chosen. If you choose a content typefor example Servicesthen click an Investigator tree node, you will see a SOA Dependency Map showing the content type associated with the selected Investigator tree node. You will see only the services (on whatever agents) that relate to that Investigator node.
If you remain on the same Investigator tree node and choose another content typefor example Agentsthe SOA Dependency Map displays all the agents with dependencies associated with the selected service. If, after selecting Agents, you choose Services again, the SOA Dependency Map expands all the services on that services agent and shows them all. And if services on that agent are dependent on services on another agent, those services are shown as well. In short, a switch of content type applies to everything on the SOA Dependency Map, which in this case interprets moving from Agents to Services as asking to see all services on all the currently displayed agents.
Implementation Guide
This means you end up seeing a lot more services than you first saw, and the SOA Dependency Map looks different although you are on the same Investigator tree node.
If you change the content type, you no longer see standalone map nodes on the SOA Dependency Map. This is because after a content type change without an Investigator node change, the SOA Dependency Map displays only items having dependent relationships.
Implementation Guide
To continue the example above, if you change from the Services content type to Operations, only dependent operations associated with the selected Server Investigator tree node appear.
Operations. The SOA Dependency Map refreshes and displays your SOA environment based on the content type that you selected.
services and operations, regardless of their physical location. This example explains the difference between these views, and how each can be helpful when you are triaging a web service problem. Imagine you are trying to analyze the root cause of a service problem and have triaged the problem to the specific service, when you discover that the service actually sits behind a load balancer. The load balancer distributes requests to five separate application servers. Finding the problem instance requires you to understand how performance varies between the physical instances. But to understand performance, you must understand the relationships between logical instances, what service is calling another service) and then on what physical instances these calls are being made. In other words, which instance of service A is calling which instance of service B. In addition, you are interested in understanding how traffic to the service is distributed among its instances. For example, if a logical service is experiencing 100 invocations per minute, but is made up of five instances, then its critical for you to understand how those 100 invocations break down over each individual instance, and that 90 of the 100 invocations are actually going to a single instance. The SOA Dependency Map allows you to toggle the View dropdown list to differentiate between the logical and physical instances of a service and determine how a problem in a specific instance may be affecting the overall performance of the logical service. The default SOA Dependency Map view is the Physical view, unless youve selected a Virtual Agent child node. In that case, the default view is the Logical view. To choose a SOA Dependency Map view:
Click the View dropdown list, and then select either Physical or Logical.
Implementation Guide
The SOA Dependency Map refreshes and displays your SOA environment based on the view that you selected. For example, if you had been looking at Operations in the Physical view, and then selected to the Logical view, the SOA Dependency Map refreshes and displays Operations based on a logical representation of the SOA Dependency Map.
Using SOA Dependency Map views and content types to solve your problems
Now that you understand how to change the SOA Dependency Map views and content type, you can use them together to solve your web services problems. This table shows what each combination helps you accomplish: Choose this view
Physical
Physical or Logical
Services
Implementation Guide
The SOA Dependency Map unrolls the next level of dependency only for the selected map node. For example, when a server-side operation is being unrolled, the next level of dependency that unrolls is the associated client-side operation.
Click the Show next dependencies button on the SOA Dependency Map tool bar.
The SOA Dependency Map unrolls dependencies for every lowest-level item in the map. So if an initial map node displays three dependencies, clicking this button adds a new level of dependencies for each of the three items.
The SOA Dependency Map rolls up all the dependency levels for the selected map node.
Click the Hide Dependencies button on the SOA Dependency Map tool bar.
The SOA Dependency Map rolls up the lowest-level of dependencies in the map.
Implementation Guide
Jumping from a SOA Dependency Map node to the associated Investigator tree node
If you are on a SOA Dependency Map node, when in the Physical view you can redraw the SOA Dependency Map based on the associated Investigator tree node. If you have been slowly expanding the SOA Dependency Map one dependency level at a time, you may now be viewing a broad expanse of operations, services, or agents. If your organization has complex SOA networks, the map looks quite full, and you may not know exactly where you are. By using the Jump here in tree functionality, you can click on a map node and go to that component in the Investigator tree. This is like starting over to reorient yourself based on your current map node location. In an analogy to working with a paper map, you can be working closely with one area of a map, and then look at a completely different area as you continue your planning or traveling. For example, imagine you are the navigator as your friend drives from London to Paris via the Euroshuttle that takes cars from England to France via the Chunnel train. Once youve crossed from England into France, you move the map on your lap to put Paris, not London as the center of your navigating attention. Similarly, you can jump to a new Investigator tree node to redraw the SOA Dependency Map. To jump from a SOA Dependency Map node to the associated Investigator tree node:
When on a SOA Dependency Map node in Physical view, right-click and select
Jump here in tree. The selection in the Investigator tree moves to the new Investigator tree node, and this becomes the new focal point for the SOA Dependency Map.
To zoom in and out of the SOA Dependency Map: 1 Click the Zoom in and out tool (magnifying glass with up/down arrows) button. 2 Roll your mouse forward and backward to zoom in and out on the SOA Dependency Map. Note Alternatively, you can use the mouse wheel to move up and down the SOA Dependency Map to see other areas interest. To resize the SOA Dependency Map to fit in the tab:
Click the Fit to Tab tool (magnifying glass with +) button.
Heres the MOM connected to 3 Collectors. Heres Collector 1. Heres an agent on Collector 1 calling an agent on Collector 2. Heres Collector 2. Heres the agent on Collector 2 being called.
Heres Collector 3.
Implementation Guide
In this figure, the SOA Dependency Map in the Physical Services view shows services on a Collector 2 agent that have dependencies on a Collector 1 agent.
Heres Collector 1.
Heres Collector 2.
Note The SOA Dependency Map data is saved only on Collectors. The MOM receives its data from the Collectors, and does not save any SOA Dependency Map data. See About how the SOA Dependency Map is saved on page 157.
Reloading SOA Dependency Map upon discovery of new services and operations
You can update the SOA Dependency Map when the Introscope SPM Agent extension discovers new web services or operations and sends the data to the Enterprise Manager. The Enterprise Manager sends the data to the Workstation for display on the SOA Dependency Map. To reload the SOA Dependency Map: 1 Notice the Available data has changed message when it appears below the SOA Dependency Map tool bar. This message appears when the Introscope SPM Agent extension has discovered one or more new web services or operations and has sent the data to the Enterprise Manager. The Enterprise Manager then notifies the Workstation that this data is ready for display on the SOA Dependency Map.
The SOA Dependency Map is displaying three sets of discovered client and server services when the Available data has changed message appears. When you click the Click here link, the SOA Dependency Map reloads and displays the newly discovered services and operations.
Implementation Guide
2 Click Click here to reload the dependencies in the SOA Dependency Map and view the new web services or operations and metrics. The Workstation loads the newly discovered web service or operation and its metrics on the SOA Dependency Map.
After the SOA Dependency Map reloads, it displays four sets of discovered client and server services. Notice that the Available data has changed message no longer displays because the SOA Dependency Map now displays all of the discovered services and operations.
After the SOA Dependency Map reloads, the view changes to the default SOA Dependency Map view associated with the Investigator tree node you clicked last. For example, lets say you open a new Investigator window and click the WebServices tree node, and then click the SOA Dependency Map tab to view the discovered dependencies. You see the Physical Services view, which is the default view for the WebServices tree node. You then decide to change to the Physical Operations view. If the Available data has changed message appears and you click Click here, the SOA Dependency Map reloads and displays the Physical Services view, which is the default view for the WebServices tree node you began on.
However, if you had clicked the WebServices tree node, and then clicked an Agent1 tree node, youd see the default view for the Agent1 node, which is the Physical Agents view. You again decide to change to the Physical Operations view. If the New Available Data message then appears and you click Click here, the SOA Dependency Map reloads and displays the Physical Agents view, which is the default view for the Agent1 tree node you last clicked.
Scenario 1
The Investigator tree organizes metrics by their physical location, while the SOA Dependency Map allows you to view a key metric as business transactions flow through the system from location to location. If a client and a server are on different Introscope agents, then their performance metrics are in completely different locations in the Investigator tree. However, on the SOA Dependency Map, the client and server, along with their key performance metrics, are shown on linked SOA Dependency Map nodes. This is useful for triage purposes. For example, if a client has a much longer average response time than the linked server, then that suggests there is some kind of network performance problem. Similarly, if a server has a much longer average response time than a linked web client, then that suggests a performance problem in the components between the server front-end and the client back-end.
Implementation Guide
Scenario 2
When triaging a high-priority problem, you must rapidly understand what is going on in your SOA environment without having an expert to interpret the service performance data. Suppose you have received an alert notification fromIntroscope SPM, and five critical services are experiencing unacceptably long response times. You must investigate and determine how to fix the problem as quickly as possible. First you must understand the scope of the problem and whats affected. To do that, you must understand service dependencies and locate transaction bottlenecks quickly. The problem is that in a complex environment with dozens of critical services, most of them reporting metrics, it's very difficult to determine dependencies and bottlenecks quickly, even if your organization has set up key custom dashboards. Generally, finding affected services requires you to drill down through many branches of the Introscope tree metrics. Compounding your challenge is that your key collaborators, such as the enterprise architect, arent Introscope experts. They cant rapidly understand metrics and dashboards, so that you must spend several minutes explaining to the enterprise application architect what the metrics mean. Using Introscope SPM and the SOA Dependency Map, you can visually assess the global impact of problem services, drill down into the details of the problem within three to four mouse clicks, and have other IT collaborators rapidly understand the performance information you are presenting.
By sending an image of the SOA Dependency Map at the agent, service, or operation view at any magnification allows you to share the same view of service dependencies and problems with other collaborators in your organization who dont run Introscope SPM. To output SOA Dependency Map images: 1 Click the Save as Image button. The Export Image dialog box appears. 2 Choose the settings for the output file from the descriptions in this table. Choose this
Type Filename Image Content
To set this
The output file type. Save as JPEG, GIF, PDF, PNG, or SVG. The destination path and file name for the output image file. The part of the SOA Dependency Map you choose to save in the image file. Visible WindowSaves only the SOA Dependency Map that is visible in the current window even if the SOA Dependency Map contains more content. For example, if the SOA Dependency Map currently displays 100 nodes, but you have zoomed in to view only 10 nodes, Introscope SPM creates a zoomed image of only those 10 nodes.
Note: You must choose the size Current Zoom Level in order to choose Visible Window Only.
Draw GridThis choice is not enabled. Selected Objects OnlySaves only the object that you
selected in the SOA Dependency Map. For example, if you select a client web service in the SOA Dependency Map then choose Selected Objects Only, Introscope SPM creates an image of that client web service only.
Note: You can use the Actual size setting of the Size property
to save the entire SOA Dependency Map in its default size, regardless of the zoom level.
Implementation Guide
Choose this
Image Characteristics
To set this
Used to set the image quality and file size. Slide the slider bar or pick a number from 1 to 100, where 100 is the best quality to choose the image quality for the image. The higher the quality image, the larger the saved image file size.
Size
Choose the size of the Output content: Current Zoom LevelIf you have zoomed in on an area of the SOA Dependency Map, the image shows the zoomed in area. Use this in conjunction with the Visible Window Only Image Content choice. Actual SizeThe image shows the entire SOA Dependency Map. In the case of a larger map, it does not shrink the SOA Dependency Map image to fit in the window. Fit in CanvasThe image shows the entire SOA Dependency Map. In the case of a large map, shrinks the SOA Dependency Map image to fit in the window. CustomYou choose the image width and height settings in pixels.
3 Click OK. Introscope SPM creates the SOA Dependency Map image and saves it to your specified location.
agent, web service, or operations dependencies that are discovered based on the new agent are added to the SOA Dependency Map under the new agent.
SOA Dependency Map nodes from the unmounted agent are removed from the
SOA Dependency Map. This is because the Introscope SPM Agent extension is
no longer reporting data from the unmounted agent to the Enterprise Manager.
Introscope SPM launches a Transaction Trace session showing all the related transactions associated with the selected map node. See About Introscope SPM cross-process transaction tracing on page 186.
Answer
No. The SOA Dependency Map always reflects the current dependencies between the monitored web services. However, because its likely your organization will deploy, modify, or remove applications in a production environment only occasionally, the SOA Dependency Map structure should remain fairly static. Introscope agents monitor the execution of the web services and transmit information about the sequence of calls to the Enterprise Manager. Cross-process correlation information is used to track the sequence of calls across multiple processes. The Enterprise Manager discovers the web service dependencies from the received sequences of web service invocations.
Implementation Guide
FAQ
What problems can I find and fix using the SOA Dependency Map?
Answer
The SOA Dependency Map helps you to visualize the dependency relationships between the web services and shows where a specific web service may be used by many other web services. The SOA Dependency Map helps you identify which component is performing poorly within a chain of web service calls. The inclusion of both client-side web services and server-side web services can highlight the contribution of network performance to a problem.
Not directly. However, you can use the Investigator tree to limit the scope of the displayed SOA Dependency Map. Choosing a specific agent, service, or operation in the Investigator tree, allows you to unroll the SOA Dependency Map based on that tree node. Within the SOA Dependency Map, you can select a map node and jump to the associated Investigator tree node. This allows you to quickly view the SOA Dependency Map based on a brand new tree node. Newly added services are detected by the agent monitoring the application server hosting the newly deployed service. Details of the web service calls are transmitted to the Enterprise Manager, which adds any previously unknown services to the SOA Dependency Map, including any newly discovered dependencies on already known services. The Workstation checks to see if the SOA Dependency Map has changed once every 15 seconds. If the SOA Dependency Map has changed, the Enterprise Manager sends new map data to the Workstation and updates the SOA Dependency Map metric values. You wont see revised SOA Dependency Map instantly, because it takes time for data about a newly added web services to work its way through the system. However, it should not take longer than a few minutes if you are running Introscope on a standalone Enterprise Manager. It may take longer if you are running Introscope on a cluster.
What happens when I add a service? How is it added to the map, and how fast will I see it on the SOA Dependency Map?
FAQ
Can I bookmark a SOA Dependency Map?
Answer
It is not currently possible to bookmark a SOA Dependency Map, however, the web services and their operations displayed in the Investigator tree can be considered as a whole series of bookmarks. Choosing a web service or its operation in the Investigator tree limits the scope of the SOA Dependency Map to the selected component and the components that it immediately depends upon. The SOA Dependency Map can be tailored by changing the view or expanding/collapsing. No. However, you can save a current map as an image. See Outputting SOA Dependency Map images for sharing on page 177. Locate the desired agent, service, or operation in the Investigator tree, select that tree node, and then click the SOA Dependency Map tab. To discover more agents, services, or operations that the selected item depends upon, use the Add and Hide Dependencies buttons. Also, by switching back and forth between the content types (Agents, Services, Operations), you can often notice sibling items. For example, other operations belonging to the same service. For example, select an operation, switch to Services content type, and then back to the Operations content type. This results in the SOA Dependency Map displaying all the operations belonging to that service. A similar technique works for all the services belonging to an agent. The usefulness of particular views varies according to the nature and complexity of a SOA.
I couldnt find an agent, service, or operation that I was looking for. How do I find it?
Implementation Guide
FAQ
Im experiencing a problem viewing the SOA Dependency Map. Whats wrong?
Answer
If the SOA Dependency Map is empty in the SOA Dependency Map tab, but web service metrics are showing up in the Investigator tree, it could be for the following reasons: when the SOA Dependency Map is first installed and in some other cases, it hasn't had a chance to collect data on everything yet. The Introscope SPM needs the web services applications to be in use and running for a while to collect data on all the nodes. Services and operations that havent been called (thus are not in use), do not display on the map until they are called. For more information, see Reloading SOA Dependency Map upon discovery of new services and operations on page 174. an Introscope agent cache flush has just taken place, removing all web services and dependency data. The Introscope SPM needs the web services applications to be running for a while to collect data on all the nodes. the mapping tracers have become disabled in the agent's profile. Ensure that the IntroscopeAgent.profile file contains the property
one server-side web service, then all of the server-side web services must be logically equivalent.
For a server-side web service, if a server-side web service is depended upon
by more than one client-side web service, then all of the client-side web services must be logically equivalent.
For name matching, when two physical web service operations have the same
metric path after deletion of the agent specifier, those operations are considered as logically equivalent.
CHAPTER
Introscope SPM enables you to monitor web services by viewing web servicerelated metrics in Introscope. This chapter discusses using the Introscope dashboards and Investigator to view and interpret web service metrics. This chapter includes these topics: About Introscope SPM cross-process transaction tracing Viewing correlated events using Transaction Tracer . Viewing web service data with Transaction Tracer Viewing web service faults in ErrorDetector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 201 203 204
Implementation Guide
In the example figure below, the operation name is makeReservation, which by itself provides little meaning because an airline, a theater, or a doctor's practice all could use applications having a makeReservation operation. However, the namespace of http://www.ca.com/wsu/travel/TravelAgent shows that this web service transaction is for a travel agency. This demonstrates how knowing the operation name and its context from the namespace helps you to decide on what action to take next in solving your application performance issue.
The namespace and operation name properties for the selected transaction component are here in the Properties section at the bottom of the Component Details pane.
Implementation Guide
After looking at this diagram, Application Support can go directly to the owner or developer of Web Service B with a request to perform an in-depth investigation.
1. Heres Web Service A making calls to Web Service B. Notice that all the calls in the entire transaction that includes Web Service A take 6000 ms or six seconds.
Web Service A
Web Service B
2. Heres the duration of Web Service Bs invocations to the CICS back-end (end point of transaction not shown in the trace because its not instrumented). This transaction takes 5000 ms or five seconds, and is the source of the problem.
3. Here are all of Web Service Bs many invocations to the CICS backend.
3. See the three web services called by the HotelEnquiry web service.
Implementation Guide
Step 4 In the Transaction Tracer Viewer Summary view, you can see the separate calls, including all the JVMs and CLRs. In this example, all calls are to and from a Java JVM, so this is a homogeneous Java to Java transaction trace.
3. Here are all the calls made in this transaction. This is a good example of a homogeneous cross-process web service transaction because the calls are WebLogic to WebLogic (Java to Java).
By clicking the Trace View tab, Workstation displays the traces and trace times making up the ClearingHouseService business process.
1. Heres the ClearingHouseService web service transaction shown in the Trace View.
2. There are four web services (in red list box above) called by the ClearingHouseService web service. Note the transaction duration as the calls move across multiple WebLogic application nodes.
Implementation Guide
By clicking the Duration column heading, Workstation sorts the transactions by time length. Now all the web service transactions called by the ClearingHouse web service are listed together.
1. Heres the Duration column, and the time-sorted transactions related to the ClearingHouse web service.
2. Here are the four web services called by the ClearingHouseService web service.
3 Heres the sum of the transactions comprising the ClearingHouseService web service.
2. Here are all the calls made in this transaction. This is a good example of a heterogeneous cross-process web service transaction because the calls are WebSphere to .NET (Java to .NET).
Implementation Guide
By clicking the Trace View tab, Workstation displays the traces and trace times making up WASBookingService business process.
1. Heres the WasBookingService transaction shown in the Trace View.
2. Here are the two transactions called by the WasBookingService web service (all shown in the red trace list box above).
3. Heres the sum of the transactions comprising the WasBookingService web service.
Implementation Guide
To filter an Introscope SPM Transaction Trace session: 1 Click Workstation > New Transaction Trace Session. The New Transaction Trace Session dialog box appears, There may be variations as to the number of filters available if you have more CA Wily Introscope products installed. At the very least, the two filters shown in the figure below appear Introscope SPM. Each filter is controlled by a check box. The check box is used to activate that particular filter. The first two always appear, regardless of the number of CA Wily Introscope products installed.
Here is the Introscope SPM Transaction Trace filter filtering on an operation name.
2 Click the Introscope SPM filter check box (the third one in the dialog box) to activate or deactivate the Introscope SPM filter. When the check box is selected, the filter components are activated. The third component (the value field) may or may not be activated, depending on the value of the operation in the filter. 3 Create a filter expression by selecting a field, an operation, entering a value, and selecting the case sensitivity option. 4 Click Add to add the filter to the list of defined filters. From the list of defined filters you can choose a filter to set it as the filter to use, or you can use defined filters to build complex filters. 5 To activate a filter, select the filter and click the Set Filter button. The previous set filter is replaced. Only one set filter is in effect at a time. 6 In the Run Session for field, enter the length of the Transaction Trace session. 7 In the Trace Agents section, select one or more agents for which to trace transactions: 8 Click OK to start the Transaction Trace session.
Transaction Trace results appear in the Transaction Trace Viewer window. For
more information see Introscope Workstation User Guide and Following an Introscope SPM transaction on page 190.
Implementation Guide
Adding a filter
You can add a filter by defining it and clicking the Add button. When you add a filter, you are adding the filter to the list of available filters. You must take the further step of selecting the Introscope SPM filter and clicking the Set Filter button in order to designate that filter as the one to use. Duplicates are not allowed. If a new filter is being added and it is identical to one that already exists, an error is displayed saying that it will not be allowed. Note Filter definitions are stored only after you click the OK button. Storing the filter definitions makes them available the next time the Transaction Trace Session dialog is opened. Clicking the OK button automatically stores the filters on a per-user basis. Each user has their own set of filters stored.
Removing a filter
You can remove a filter by selecting it and clicking the Remove button. Use Ctrl+click to make multiple selections. You can only remove a filter if it is not used as a component of another filter. For example, if filters f1 and f2 are used to create the combined AND filter defined as f1 AND f2, then filter f1 cannot be deleted until the AND filter has itself been deleted.
Note You must click the OK button in order for the removed filter(s) to be permanently removed. While the filters are removed from the screen immediately after the Remove button is clicked, cancelling and restoring the dialog without having clicked the OK button brings them right back.
Setting a filter
You can set a filter by selecting it and clicking the Set Filter button. You can select only one filter at a time. If you want to use more than one filter, create a complex filter. When selected, the filters description appears in the Filter Text box below the list of filters. You must set a filter before clicking the OK button. When you click Set Filter, any previously set filters are replaced by the current filter.
Complex filters
You can create complex filters by combining one or more filters from the filter list using either the AND or the OR operator. The filters that you are combining must already exist in the list of defined filters. When you use the AND or the OR operator to join together two simple filter statements, a new filter is created and that filter can then be used as a filter by itself or as a building block for creating additional filters. So, to create the complex filter f1 contains s1 AND f2 contains s2 you first create the individual simple filters and then join them. To create a complex filter: 1 Create the filter f1 contains s1. 2 Create the filter f2 contains s2. 3 Use Ctrl+click to select both filters in the filter list and then click AND. The new complex filter f1 contains s1 AND f2 contains s2 now appears in the list. You can set this filter or use it to create other complex filters. Using the AND operator means that the trace has to pass all components of the filter. For example, the filter f1 contains s1 AND f2 exists requires that an incoming trace passes both the f1 contains s1 constraint as well as f2 exists. Using the OR operator means that the trace has to pass at least one of the components of the filter. For example, the filter f1 contains s1 OR f2 exists requires that an incoming trace passes either the f1 contains s1 constraint or f2 exists or both.
Implementation Guide
For example, you can filter on both operation name and namespace at the same time, as shown in this figure.
Here is the Introscope SPM Transaction Trace filter filtering on both a namespace and an operation.
Heres the Historical Query Viewer displaying the correlated events related to the transaction shown in the Trace View.
Implementation Guide
3 Click Go. The results show any business transactions or errors that contain web services information. Click any row in the table to see the components in the Transaction Trace, and then click any component to see its details in the Component Details pane. From this information, you can determine which component in the web service is causing problems. Note When viewing a Transaction Trace session using Trace View, you can use the Ctrl key to select all transactions that are correlated to a specific transaction. Then click Trace > Save As to save the correlated transactions in an XML file. However, when you open the Time Range drop-down historical query viewer and load the saved XML file and use the Trace View to view the historical data, you may find that the Trace View has changed or does not display the traces. This is because the Time Range historical viewer is not able to display correlated transactions. In addition, in a live Transaction Trace session, the Trace View may vary with time as correlated data continues to be reported to Enterprise Manager. To learn more about using Transaction Tracer and analyzing the information contained in the Transaction Trace Viewer, see the Introscope Workstation User Guide.
When ErrorDetector is run with Introscope SPM in addition to Introscope, Introscope SPM supplies to ErrorDetector SOAP fault information, including a SOAP Fault prefix to the Error Message.
Implementation Guide
You see live errors coming in. Click any row to see details in the Error Snapshot in the bottom pane.
Notice that SOAP fault error messages include SOAP Fault in the error message content.
To view historical errors: 1 Choose Workstation > Query Historical Events. 2 In the Query field, enter:
Notice that SOAP fault error messages include SOAP Fault in the error message content.
3 Click a row in the table in the top pane to see error details in the lower error snapshot pane. The error message appears in red.
For an error on the server side, you can see the root cause of the error in the
Implementation Guide
On the client and server sides, you can see the root cause along with the SOAP
fault exception.
SOAP fault error messages have the prefix SOAP Fault at the beginning of the
red Error Message. To learn more about using ErrorDetector and analyzing error information, see the Introscope ErrorDetector Guide.
CHAPTER
Introscope SPM enables you to monitor OSB components and view the servicerelated metrics in Introscope. This chapter discusses using the Introscope SPM OSB-specific dashboards and metrics to monitor your OSB environment. Using Introscope SPM to monitor OSB Viewing OSB metrics . . . . . . . . . . . Viewing OSB dashboards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210 211 230 241 242 244
Viewing and creating OSB metric groupings Viewing and creating OSB alerts .
6 Navigate to the Introscope Workstation Console. Introscope SPM provides a number of pre-configured dashboards for displaying OSB performance metrics. See Viewing OSB dashboards on page 230.
Implementation Guide
services for which the bus is a client. The external web services are implemented in and hosted by external systems. So the bus must know what interface to call, how to call, and what to expect as a result of a call. Business services model these interfaces so that the bus can invoke the required external services and interact with the external systems. A business service configuration includes its interface, transport settings, and security settings. Introscope SPM monitors how business services interacts with the external systems and provides data about their overall health. The Investigator displays metrics for each business service under the OSB > BusinessServices node.
Pipelines: A pipeline is a named sequence of stages representing a
non-branching, one-way processing path. Pipelines belong to one of the following categories:
Request pipelines that process the request path of the message flow. Response pipelines that process the response path of the message flow. Error pipelines that handle errors for stages and nodes in a message flow as well as errors at the level of the message flow or business service.
To implement the processing logic of a proxy service, request and response pipelines are paired together in pipeline pair nodes. These pipeline pair nodes can be combined with other nodes into a single-rooted tree structure to control overall flow. Introscope SPM monitors how the request and response pipelines perform and provides data about their overall health. Investigator displays metrics for pipelines along with the proxy service to which they belong under the OSB > Pipelines node.
Proxy Services: Proxy services in OSB are definitions of intermediary web
that the service bus implements and hosts locally. The bus uses proxy to route messages between business services such as enterprise web and databases, and service clients such as presentation applications business services.
A proxy service configuration includes its interface, transport settings, security settings, and a message flow definition. The message flow definition defines the logic that determines how messages are handled as they flow through the proxy service. Introscope SPM monitors how the performance of the proxy services and provides data about their overall health. Metrics for each proxy service are displayed in the Investigator under the OSB > ProxyServices node.
protocols. A transport provider manages the life cycle and runtime behavior of transport endpoints. Target endpoints are resources where messages originate or are targeted. The native providers in OSB let you configure proxy and business services that require these transport protocols. You can also create or install custom transport providers Introscope SPM monitors the transport protocols and provides metrics for each. Investigator displays transport metrics as well as metrics for inbound and outbound endpoints under the OSB > Transports node.
UDDI: Universal Description, Discovery, and Integration (UDDI) is a platform-
independent, XML-based registry for businesses worldwide to list themselves on the Internet. UDDI is an open industry initiative that enables businesses to publish service listings and discover each other and define how the services or software applications interact over the Internet. OSB works with any UDDI registry that is compliant with UDDI version 3.0. You can
publish information about any proxy service to a registry. The registry may be based on Web Services Description Language (WSDL), SOAP, or XML. inquire for specific services in a registry or list all services available. You can search on business entity, service name pattern, or both. import business services from a registry.
Introscope SPM monitors the UDDI registries. The Investigator displays UDDI metrics for publish, import, and inquiry operations under the OSB > UDDI node.
XQueries: OSB uses the Oracle Data Services Platform implementation of the
XQuery engine, which fully supports all of the language features that are described in the World Wide Web Consortium (W3C). Transformation maps describe the mapping between two data types. OSB supports data mapping using XQuery. You can create, parse, and execute the transformations. Introscope SPM monitors the XQuery transformations for creating, parsing, and executing XQueries. Investigator displays metrics for creating, parsing, and executing XQueries under the OSB > XQueries node.
Implementation Guide
(throughput).
Errors Per Interval: how many errors are recorded by the Introscope Agent by
Implementation Guide
Note Introscope SPM provides only three metrics for business services: Average Response Time, Errors Per Interval, and Responses Per Interval. Stall Count and Concurrent Invocations metrics are relevant only if the transactions are of request-response type. Because business transactions are not of the request-response type, Stall Count and Concurrent Invocations metrics are not provided. Important Average Response Time for business services is based on the Business Service Execution Time. Business Service Execution Time = OSB Transport Time + Actual Service Execution Time + Network Lapse.
Implementation Guide
e Double-click the Response operation or expand a proxy service and click the Response operation. Data for all the metrics for the Response operation are displayed in a graphical format. 3 You can also expand the ProxyServices node in the Investigator tree. Note Metrics under OSB|ProxyServices|{proxyname} are aggregated metrics from the Request and Response sub-nodes. See About Proxy Service aggregated metrics on page 219. a Expand all the proxy services to see the metrics listed for each. b Expand the Request and Response sub-nodes to see the metrics listed for each. For each proxy service, metrics under the Request sub-node are associated with processing the request from the corresponding proxy service. Metrics under the Response sub-node are associated with processing the response to the corresponding proxy service. This figure shows the Investigator metrics for proxy services.
Implementation Guide
Here are the aggregated metrics from the Request and Response sub-nodes for the LoanGateway1 proxy service.
Here are the terms used in the equations that Introscope SPM uses for generating the aggregated standard Introscope metric calculations below. This term in the equation ART CI EPI RPI SC Count Req Res Means this Average Response Time Concurrent Invocations Errors Per Interval Responses Per Interval Stall Count Data count shown for each metric in the investigator Request node Response node
If Proxy1 has Request (Req) and Response (Res) metrics, then the aggregated metrics are calculated based on these equations:
ART(Proxy1) = [ART(Req) * Count(Req) + ART(Res) * Count(Res)] / [Max of
Count(Req, Res)]
CI(Proxy1) = CI(Req) + CI(Res) EPI(Proxy1) = EPI(Req) + EPI(Res) RPI(Proxy1) = Max of [RPI(Req), RPI(Res)] SC(Proxy1) = SC(Req) + SC(Res)
Implementation Guide
4 Expand a transport type node and click a sub-node for these transport types: InboundMessageContext, OutboundMessageContext, or TransportProvider. TransportProvider, InboundMessageContext, OutboundMessageContext, and ColocatedMessageContext are interfaces used by OSB. The sendMessageAsync,
6 Double-click a method or expand a sub-node for the transport type InboundMessageContext, OutboundMessageContext, or TransportProvider, and then click a method.
Data for all the metrics for the method are displayed in a graphical format. This figure shows the Investigator metrics for OSB transports.
Implementation Guide
1 Expand the Transports node and click Inbound or Outbound sub-nodes. In the Viewer pane, the Overview tab is active by default and all the endpoints that the inbound and outbound endpoints currently use are listed in a table as shown in this figure.
2 Click an endpoint and a corresponding metric to view data for that metric in a graphical format.
3 Double-click an endpoint or expand an Inbound or Outbound endpoint node and click an endpoint. Data for all the metrics for the endpoint are displayed in a graphical format. Fourteen OSB transport types are supported by Introscope SPM out of the box:
HTTP/HTTPS JMS EJB FTP Email SFTP Tuxedo MQ WS JPD SB DSP File Local
See OSB Transports I - Overview dashboard on page 236 and OSB Transports II - Overview dashboard on page 237 for details. When ever a specific transport type is used, the transport type and metrics for it are displayed. If a custom transport type is used in OSB, the Java package name defined for that transport type is displayed in Investigator. For example, if the OSB Console uses the custom transport type com.bea.wli.sb.test.service, Investigator displays this as a transport type.
Implementation Guide
For example, in this figure you can see that OSB|Transports|HTTP has five standard Introscope metrics that are aggregated from the methods of these sub-nodes:
HttpInboundMessageContext HttpOutboundMessageContext HttpTransportProvider
Here are the aggregated metrics for the HTTP transport type.
Here are the metrics used in the aggregation for the HTTP transport type.
Here are the metrics used in the aggregation for the HTTP transport type.
Here are the metrics used in the aggregation for the HTTP transport type.
Here are the metrics used in the aggregation for the HTTP transport type.
Here are the metrics used in the aggregation for the HTTP transport type.
Here are the equations used for generating the aggregated metric calculations. This term in the equation ART CI EPI RPI SC Count Class1, Class2 Means this Average Response Time Concurrent Invocations Errors Per Interval Responses Per Interval Stall Count Data count shown for each metric in the investigator. Correspond to HttpInboundMessageContext, HttpOutboundMessageContext, HttpTransportProvider and so on. Correspond to getRequestPayload, sendMessageAsync, getResponsePayload and so on. The transport type, for example HTTP, JMS, FTP, or SFTP
Method1, Method2
Type1
If Transport type (Type1) has Class1(Method1) and Class2(Method2) metrics, then the aggregated blame point metrics are calculated based on these equations:
ART(Type1) = [ART(Method1) * Count(Method1) + ART(Method2) *
Implementation Guide
Implementation Guide
information. The installer for OSB places the Management Module jar OSB_ManagementModuleV<version>.jar file in the <EM_Home>/deploy directory. This Management Module provides ten pre-defined dashboards for OSB. Dashboards are associated with alerts that show the overall health of the application. Each alert has a metric value:
Gray indicates that no data is available Green indicates OK Yellow indicates Caution Red indicates Danger
To view dashboards: 1 Start the Introscope Workstation Console. 2 Select one of the following dashboards from the drop-down list:
OSB Home OSB Proxy Services - Overview OSB Proxy Services - Details OSB Business Services - Overview OSB Pipelines - Overview OSB Transports I - Overview OSB Transports II - Overview OSB Transport Endpoints - Overview OSB XQuery - Overview OSB UDDI - Overview
Implementation Guide
dashboard. For example, click the Pipelines response times alert to go to the Pipelines - Overview dashboard.
Double-click a tab to navigate to the associated dashboard.
counts.
Top 10 slowest proxy services.
Implementation Guide
Implementation Guide
Counts.
Top 10 slowest pipelines.
the Investigator.
Right-click a graph or an alert, click Links, and navigate to OSB Home or the
transport types.
Graphs for Average Response Times for HTTP/HTTPS, JMS, EJB, FTP, Email,
Implementation Guide
Management Module.
Counts for all Inbound Services and Outbound Endpoints for all transport types.
Top 10 slowest Inbound Services. Top 10 slowest Outbound Endpoints.
the Top 10 inbound services or outbound endpoints, respectively, to view its details in the Investigator.
Implementation Guide
Execute operations.
Graphs for Average Response Time, Errors Per Interval, and Stall Counts for
Execute operations.
Graphs for Average Response Time and Errors Per Interval for Parse
corresponding alert in the Management Module. Note Graphs for Parse do not have any associated alerts, so when you rightclick Links, you will navigate to the corresponding metric grouping.
Import and Publish operations for the UDDI registries To view more information:
Right-click a graph or an alert, click Links, and navigate to the corresponding
Implementation Guide
Implementation Guide
To view OSB alerts using Investigator: 1 In the Investigator, expand the following nodes: a *SuperDomain* b Custom Metric Host (Virtual) c Custom Metric Process (Virtual) d Custom Metric Agent (Virtual) e Alerts. 2 Expand the OSB_ManagementModule <version> (*Super Domain*) node to view all alerts for OSB. 3 Click an alert to view its current status in the Viewer pane. Each alert has a metric value:
0 indicates Not Reporting 1 indicates Normal 2 indicates Caution 3 indicates Danger
Implementation Guide
As shown in the figure below, the client JSP_largaccts_webservice sends a message to the OSB proxy service loangateway2. In the proxy service message flow, the message transformation is done by a service callout to Business Service A (CreditRatingService), and the transformed message is ultimately routed to Business Service B (loanSalesProcessor).
Heres the proxy service (loan gateway2) when looking at the Trace View tab.
Note A service callout is an action that you can configure in the OSB Console to call business services.
Implementation Guide
The proxy service (loangateway2) executes two EJBs, namely LargeSimpleBean and creditSimpleBean. As shown in this figure, you can also see the other components involved in the proxy service execution such as pipelines and XQueries.
1. Heres the proxy service (loan gateway2) in the Summary View.
2. Here are the largeSimplebean and creditSimplebean external services called by the proxy service.
Implementation Guide
The Historical Query Viewer opens listing the correlated events, which are the web services on other processes or nodes that are part of the selected Transaction Trace.
Heres a transaction highlighted in the Trace View.
Heres the Historical Query Viewer displaying the correlated events related to the transaction shown in the Trace View.
CHAPTER
Introscope SPM enables you to monitor WebSphere Process Server (WPS) web services and view the associated web service-related metrics and WPS components-related metrics in Introscope. This chapter discusses using the Introscope SPM WPS-specific dashboards and metrics to monitor your WPS environment. Using Introscope SPM to monitor WPS and WESB . About WPS and WESB component metrics . About WPS and WESB metrics . Viewing WPS tabs and metrics . Viewing WESB tabs and metrics Viewing WPS dashboards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252 253 256 257 269 271 284 294 302 304 308
Viewing WPS and WESB shared component metrics . Viewing WESB dashboards .
Viewing and creating WPS and WESB metric groupings . Viewing and creating WPS and WESB alerts About WPS cross-process transaction tracing .
The WProcServer node represents the WPS server. If you are monitoring a standalone WESB environment, youll see the WESB node here.
Implementation Guide
Introscope SPM provides a number of pre-configured dashboards for displaying WPS and WESB performance metrics. See For information about the tabs and metrics for WPS and WESB shared components, see Viewing WPS and WESB shared component metrics on page 271. on page 270.
This table shows the metrics and dashboards Introscope SPM provides for each of these environments: This Introscope SPM metric & dashboard Business Processes Business State Machines Business Rules Human Tasks Interface Maps Selectors Mediation Flows Mediation Primitives Java Components BO Maps Relationships J2CA (Adapters) Data Binding are displayed in this environment WPS Only WPS Only WPS Only WPS Only WPS Only WPS Only WPS and WESB WPS and WESB WPS and WESB WPS and WESB WPS and WESB WPS and WESB WPS and WESB
Implementation Guide
Relationship: Relationship establishes an association between data from two or more data types. The figure below shows a relationship that defines the correlation between a Customer and the Customer ID.
Adapter: An adapter is an application that enables a WebSphere Process Server to communicate with the external Enterprise Information System (EIS). Outbound communication occurs when a WebSphere Process Server calls an EISspecific operation. Inbound communication occurs when the application listens for a specific EIS event. Data Binding: A data binding is used to convert business objects to a stream of data during inbound and outbound processing.
WPS-specific components
Introscope SPM provides the metrics for the following WPS components, as well as WPS faults: Business Process: A procedure made up of individual tasks that are executed in a specific order to achieve a particular goal. A business process is made up of at least one task that may be involved in receiving a message in response to a request. Business State Machine: A business state machine is an event-driven application. It waits for an event to occur and, based on the event, chooses an appropriate action to execute. Once the action is executed, the machine may go to another state or simply wait for another event to occur. Business Rule: A rule that captures and implements business policies and practices. A business rule can enforce business policy, make a decision, or infer new data from existing data. Human Task: A task performed by a human. This may involve interaction with processes or services in WPS.
Interface Map: A supporting service that reconciles the differences between components that have different interfaces. They resolve and reconcile differences across multiple interfaces using transformation and other rudimentary operations between interfaces. These operations enable the components to communicate. Selector: A component that provide flexibility in the processing of service components during run time. A selector accepts one invocation from the client application and allows different targets to be called at runtime based on the selection criteria. Note If you want to view Performance Monitoring Infrastructure (PMI) metrics for WPS-related components in Introscope SPM Investigator, you need to perform some configuration. See Optional: Configure IntroscopeAgent.profile so Introscope SPM monitors WebSphere PMI metrics. on page 76. For information about configuring the PMI service for WebSphere Application Server Distributed, see the CA Wily Introscope PowerPack for IBM WebSphere Application Server Distributed User Guide.
(throughput).
Errors Per Interval: how many errors are recorded by the Introscope Agent by
Implementation Guide
For information about the tabs and metrics for WPS and WESB shared components, see Viewing WPS and WESB shared component metrics on page 271.
Implementation Guide
Implementation Guide
Note You must perform some configuration to display separate metrics if you have different versions of the same Business Process. For information about this configuration, see Optional: Configure WPS.pbd to provide separate metrics for different versions of a Business Process. on page 76. If you perform this configuration, then the business process name under the BusinessProcesses node is displayed as shown in the figure below. Notice that: * the business process name contains a time stamp to differentiate between various versions of the same process. * in the time stamp, an underscore [_] symbol replaces the colon [:] that is typically part of the business process name. This figure shows the Investigator metrics for business processes.
Heres the process name with the time stamp.
Implementation Guide
Implementation Guide
Implementation Guide
WPS Faults
When a fault occurs in the WPS tier, an exception is thrown if the fault is not handled. The WPS Faults Per Interval metric shows the number of exceptions that have occurred in a 15-second time slice. To view WPS Faults Per Interval metric: 1 In the Investigator tree, navigate to the WProcServer > WPSFaults node. 2 Expand the node to view the WPS Faults Per Interval metric. This figure shows the WPS Faults Per Interval metric In the Investigator tree.
For information about the tabs and metrics for WPS and WESB shared components, see Viewing WPS and WESB shared component metrics on page 271.
Implementation Guide
For information about the tabs and metrics for WPS and WESB shared components, see Viewing WPS and WESB shared component metrics on page 271.
Implementation Guide
In the Viewer pane, the Overview tab is active by default and all the relationships that currently being used are listed in a table. 2 Click a relationship to view the Average Response time metric data in a graphical format. 3 Double-click a relationship to view all the associated metrics in a graphical format. 4 Expand the Relationships node. You can see all the relationships listed under this node. 5 Expand all the relationships to see the metrics listed for each. This figure shows the Investigator metrics for relationships.
In the Viewer pane, the Overview tab is active by default and all the Java components along with their operations that currently being used are listed in a table. In the Investigator tree, all the Java components are listed under the JavaComponents node. All the operations that a particular Java component executes are listed under the Java component. 2 In the Viewer pane, click a Java component to view the Average Response time metric data in a graphical format. 3 Double-click a Java component to view all the associated metrics in a graphical format. 4 Expand the JavaComponents node and click a Java component. 5 In the Viewer pane, click an operation and a corresponding metric to view the data for that metric in a graphical format. 6 Double-click an operation to view all the associated metrics in a graphical format. 7 You can also expand the JavaComponents node, expand one of the Java components, and click an operation to view data for all associated metrics in a graphical format. This figure shows the Investigator metrics for Java components.
Implementation Guide
In the Viewer pane, the Overview tab is active by default and all the business object maps along with there target namespaces that currently being used are listed in a table. In the Investigator tree, all the business object maps are listed under corresponding target namespaces under the BOMaps node. 2 In the Viewer pane, click a target namespace to view the Average Response time metric data in a graphical format. 3 Double-click a target namespace to view all the associated metrics in a graphical format. 4 Expand the BOMaps node and click a business object map target namespace. 5 In the Viewer pane, the Overview tab is active by default and all the business object maps of the target namespace are listed in a table. 6 Click a business object map to view the Average Response Time metric data in a graphical format. 7 Double-click a business object map to view all the associated metrics in a graphical format. You can also expand the BOMaps node, expand one of the target namespaces, and click a business object map to view data for all associated metrics in a graphical format.
Implementation Guide
This figure shows the Investigator metrics for business object maps.
Heres the Business Object Maps target namespace. Here are the Business Object Map names.
In the Viewer pane, the Overview tab is active by default, and all the outbound interactions along with there record names and inbound event persistence that are currently being used are listed in their respective tables. In the Investigator tree, you can see all inbound and outbound communications for the adapters listed under the J2CA node. 2 Click an outbound interaction or inbound event persistence to view the Average Response time metric data in a graphical format. 3 Double-click an outbound interaction or inbound event persistence to view all the associated metrics in a graphical format. 4 Expand all inbound and outbound communications to see the interactions and event persistence listed for each. 5 Expand the interactions to see the record names listed for each. 6 Expand all record names to see the metrics listed for each. This figure shows the Investigator metrics for adapters.
Implementation Guide
In the Viewer pane, the Overview tab is active by default, and all the data bindings that are currently being used are listed in a table. In the Investigator tree, you can see all inbound and outbound data conversion for the data bindings listed under the DataBindings node. 2 In the Viewer pane, click a data binding to view the Average Response time metric data in a graphical format. 3 Double-click a data binding to view all the associated metrics in a graphical format. 4 Expand the DataBindings node to see all the data bindings listed under this node. 5 Expand all the data bindings to see the metrics listed for each.
Implementation Guide
In the Viewer pane, the Overview tab is active by default, and all mediation flow components and the associated modules that are currently being used are listed in a table. In Investigator, you can see all the modules that have mediation flow components. 2 Click a mediation flow component to view the Average Response time metric data in a graphical format. 3 Double-click a mediation flow component to view all the associated metrics in a graphical format. The operations invoked for each mediation flow component are listed in a table. 4 Click an operation to view the Average Response Time metric data in a graphical format. 5 Double-click an operation. You see all the associated request flows, response flows, event flows, and fault flows listed in a table. You also see mediation primitives listed in a separate table. 6 Click a request flow, response flow, event flow, fault flow, or mediation primitive to view the Average Response Time metric data in a graphical format. 7 Double-click a request flow, response flow, event flow, fault flow, or mediation primitive to view all the associated metric data in a graphical format. 8 To see more mediation flow and primitives data, expand more sub-nodes. a Expand all modules to see the mediation flow components listed for each. b Expand all the mediation flow components to see the operations invoked for each. c Expand all the operations to see the flows and mediation primitives listed for each. d Expand all the mediation primitives to see the metrics listed for each.
This figure shows the Investigator metrics for Mediation Flows and Primitives.
Heres the name of the module that contains this Mediation Flow component.
Heres the operation name of the Mediation Flow component that has been called.
Implementation Guide
Average Response Time (ART) Concurrent Invocations (CI) Errors Per Interval (EPI) Responses Per Interval (RPI) Stall Count (SC)
component operation:
The Average Response Time (ART) metric at operation level. Introscope SPM calculates this metric using this equation:
((request flow ART x count value) + (response flow ART x count value) + (fault flow ART x count value) + (event flow ART x count value)) / Single largest count value across RequestFlow, ResponseFlow, FaultFlow, and EventFlow
For example, if during this interval there is one request flow, one response flow, two fault flows, and three event flows, the single largest count value would be 3 for the three event flow counts.
The concurrent invocations (CI) metric value at the operation level. Introscope SPM calculates this metric by adding the corresponding RequestFlow, ResponseFlow, FaultFlow, and EventFlow CI metrics data.
The Errors Per interval (EPI) metric value at operation level. Introscope SPM calculates this metric by adding the corresponding RequestFlow, ResponseFlow, EventFlow EPI metrics data and the Responses Per interval (RPI) metrics data of the fault flow. Fault flows are expected to occur when a fault occurs. So the RPI metric value for a fault flow is added to the EPI metric value at the operation level to represent that an error has occurred during that operations invocation.
The Responses Per interval (RPI) metric at operation level. Introscope SPM provides this metric by displaying the maximum RPI of RequestFlow, ResponseFlow, FaultFlow, and EventFlow for that interval.
The stall count (SC) metric value at the operation level. Introscope SPM calculates this metric by adding the corresponding RequestFlow, ResponseFlow, FaultFlow, and EventFlow SC metrics data.
Here are the aggregated metrics at the Mediation Flow component level.
Here are the aggregated metrics at the Mediation Flow component operation level.
Implementation Guide
information. The Introscope SPM WPS and WESB Management Modules provide nine predefined dashboards for WPS and seven pre-defined dashboards for WESB. Dashboards are associated with alerts that show the overall health of the application. Each alert has a metric value:
Gray indicates that no data is available Green indicates OK Yellow indicates Caution Red indicates Danger
To view dashboards: 1 Start the Introscope Workstation Console. 2 Select a dashboard from the drop-down list.
Implementation Guide
displays the Top 10 slowest Business Processes or Business State Machines, respectively, to view its details in the Investigator.
Right-click a graph or an alert, click Links, and navigate to the WPS Overview
WPS Business Rules & Human Tasks (Service Components II) dashboard
The dashboard shows:
Overall health of business rules and human tasks. A graph showing the Average Response Times for all business rules, as well as
10 slowest Business Rules or Human Tasks, respectively, to view its details in the Investigator.
Right-click a graph or an alert, click Links, and navigate to the WPS Overview
Implementation Guide
chart that displays the Top 10 slowest Interface Maps, Business Object Maps, or Relationships, respectively, to view its details in the Investigator.
Right-click a graph or an alert, click Links, and navigate to the WPS Overview
10 slowest Selectors or Java Components, respectively, to view its details in the Investigator.
Right-click a graph or an alert, click Links, and navigate to the WPS Overview
Implementation Guide
Counts.
Top 10 slowest Data Bindings.
Implementation Guide
flows. Mediation flows are aggregates of request, response, and fault flows.
A graph showing the Average Response Times for all mediation flows, as well
Double-click a mediation flow in the 10 Slowest Mediations Flows chart to view its details in the Investigator. Double-click a graph or an alert to navigate to the WESB- Mediation Primitives dashboard.
Primitives dashboard, WPS Overview dashboard, or the corresponding alert in the Management Module.
Implementation Guide
flows.
Alerts for Average Response Times and Errors Per Interval for all mediation
primitives.
Alerts for Average Response Times, Errors Per Interval, and Stall Counts for all
request flows, fault flows, and response flows. To view more information:
Right-click an alert for request flows, fault flows, or response flows, click
Links, and navigate to the WESB Overview dashboard or the corresponding alert in the Management Module.
Right-click an alert for a mediation primitive, click Links, and navigate to the
dashboard. For example, click the Java Components response times alert to go to the Java Components dashboard.
Double-click a tab to navigate to the associated dashboard.
Implementation Guide
flows. Mediation flows are aggregates of request, response, and fault flows.
A graph showing the Average Response Times for all mediation flows, as well
Primitives dashboard, WPS Overview dashboard, or the corresponding alert in the Management Module.
Implementation Guide
flows.
Alerts for Average Response Times and Errors Per Interval for all mediation
primitives.
Alerts for Average Response Times, Errors Per Interval, and Stall Counts for all
request flows, fault flows, and response flows. To view more information:
Right-click an alert for request flows, fault flows, or response flows, click
Links, and navigate to the WESB Overview dashboard or the corresponding alert in the Management Module.
Right-click an alert for a mediation primitive, click Links, and navigate to the
Implementation Guide
the Top 10 slowest Business Object Maps or Relationships, respectively, to view its details in the Investigator.
Right-click a graph or an alert, click Links, and navigate to the WPS Overview
Counts.
Top 10 slowest Data Bindings.
Implementation Guide
Counts.
Top 10 slowest Java components.
Implementation Guide
To view WESB metrics groupings across all agents: 1 In the Investigator, click Workstation > New Management Module Editor. The Management Module Editor opens. 2 Expand the following nodes: a Super Domain. b Management Modules. c WESB_Management_Module <version>. 3 Expand the MetricGroupings node to view all metric groupings for WESB. 4 Click a metric grouping to view it in the Viewer pane. 5 Click Elements > New Metric Grouping to create a new metric grouping based on the WESB management module. For information about creating and defining metric groupings, see the Introscope Configuration and Administration Guide. This figure shows WESB metric groupings in the Management Module Editor.
Implementation Guide
To view WPS alerts using Investigator: 1 In the Investigator, expand the following nodes: a Super Domain. b Custom Metric Host. c Custom Metric Process. d Custom Metric Agent. e Alerts. 2 Expand the WPS_Management_Module <version> node to view all alerts for WPS. 3 Click an alert to view its current status in the Viewer pane. Each alert has a metric value:
0 indicates Not Reporting 1 indicates Normal 2 indicates Caution 3 indicates Danger
To view WESB alerts using Management Module Editor: 1 In the Investigator, click Workstation > New Management Module Editor. The Management Module Editor opens. 2 Expand the following nodes: a Super Domain. b Management Modules. c WESB_Management_Module <version>. 3 Expand the Alerts node to view all alerts for WESB. 4 Click an alert to view it in the Viewer pane. 5 Click Elements > New Alert to create a new alert. For information about creating and defining alerts, see the Introscope Configuration and Administration Guide. This figure shows WESB alerts in the Management Module Editor.
Implementation Guide
To view WESB alerts using Investigator: 1 In the Investigator, expand the following nodes: a Super Domain. b Custom Metric Host. c Custom Metric Process. d Custom Metric Agent. e Alerts. 2 Expand the WESB_Management_Module <version> node to view all alerts for WESB. 3 Click an alert to view its current status in the Viewer pane. Each alert has a metric value:
0 indicates Not Reporting 1 indicates Normal 2 indicates Caution 3 indicates Danger
Implementation Guide
In the first transaction in the figure below, the JMSInvokerProcess business process receives the web applications client call.
1. Start in the Transaction Trace Viewers Summary View. 2. Click the first trace.
3. You can view data for the Received business process activity associated with the called JmsInvokerProcess Business Process.
Implementation Guide
By clicking another transaction in the Transaction Trace list, you can see more business process activities, as shown in this figure.
Prepare JMS call Call Converter Process
Every trace gives information about the activities that are being executed as part of that trace, which helps you to understand the contribution of activities to the overall transaction.
1. Heres the JMS and convertor process call, which is an activity responsible for calling the MPGConverterProcess child Business
By clicking the subsequent transactions, you can see the calls executed by that particular transaction in the Summary View and the time taken by the transaction in the Trace View. By clicking one of the next traces in the Transaction Trace list, you can see more business process activities of the child process. As shown in this figure, the Reply activity of the MPGConverterProcess Business Process returns the response to the JMSInvokerProcess parent Business Process.
2. The reply child business process activity shows that the child process has been returned to the parent process.
Implementation Guide
By clicking the next trace in the Transaction Trace list, you can see more parent process activities. As shown in this figure, the reply activity of the JMSInvokerProcess returns the response to the client.
Here the reply has been sent from the parent Business Process to the client.
When you click the Trace View tab, Workstation displays the traces for the whole business transaction, so we can understand the transaction flow. The Trace View highlights the parent process transaction before it returns to the client as shown in this figure.
1. Click the Trace View tab.
Implementation Guide
By clicking the last transaction in the Trace View, you can see that all the transactions are correlated here in the execution order as shown in the following figure. By using Introscope SPM to monitor WPS/WESB, you can trace the complete business transaction flow. In addition, you can find the various WPS/WESB entities that have been executed in this flow for a particular request. If you click the Duration column heading, Workstation sorts the transactions by time.
1. All the transactions are correlated in the execution order.
2. The transactions in the biggest box above represent the entire client transaction. In this case, the client transaction is a synchronous call, therefore the client waits to finish the transaction until the business process returns the reply.
WPS/WESB environment.
Traces collected from your WPS/WESB environment. Traces related to other services that are invoked by WPS/WESB components.
To view correlated events using Transaction Tracer: 1 Open Workstation and run a Transaction Trace session. For more information, see the Introscope Workstation User Guide. 2 Select a Transaction Trace from the list. 3 In the Transaction Trace window, select Trace > Correlated Events. The Historical Query Viewer opens listing the correlated events, which involve WPS/WESB components and web services on other processes or nodes that are part of the selected Transaction Trace.
Heres a transaction highlighted in the Trace View.
Heres the Historical Query Viewer displaying the correlated events related to the transaction shown in the Trace View.
APPENDIX
Introscope SPM requires an installed Introscope .NET Agent version 8.1 at a minimum. You need to make the configuration changes described in this appendix each time you install or upgrade the .NET Agent to a version later than 8.1. This appendix includes this topic: Reconfiguring after installing or upgrading the Introscope .NET Agent version 318
<runtime> <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1"> <dependentAssembly> <assemblyIdentity name="wily.Agent" publicKeyToken="2B41FDFB6CD662A5" /> <bindingRedirect oldVersion="8.1.0.0" newVersion="<upgradedAgentVersion>" /> <codeBase version="<upgradedAgentVersion>" href="file:/// <Agent_Home>\\bin\\wily.Agent.dll"/> </dependentAssembly> </assemblyBinding> </runtime>
Note In order for the .NET Agent to work properly, the statement
<assemblyBinding xmlns="urn:schemas-microsoftcom:asm.v1"> must be inside <runtime>. In addition, <dependentAssembly> must be under <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">.
3 Restart the IIS application server.
APPENDIX
This appendix includes the following topics: Introscope SPM Agent extension configuration . . . . . . . . . . . . . . 320 321
com.wily.introscope.agent.
See Introscope SPM Agent extension configuration properties on page 321 for a list of all the Introscope SPM Agent extension configuration properties.
Implementation Guide
com.wily.introscope.agent.transac Enables or disables tiontrace.boundaryTracing.enable Transaction Trace boundary traces used to supply data needed to display the SOA Dependency Map. If set to True: The Introscope SPM Agent extension collects Transaction Trace bounder trace data required for the SOA Dependency Map and transmits it to the Enterprise Manager. If set to False: The Introscope SPM Agent extension does not collect Transaction Trace bounder trace data required for the SOA Dependency Map. Default: True com.wily.introscope.agent.transac Specifies the number of days tiontrace.boundaryTracing.cacheFl that will pass before the Introscope agent memory ushFrequency cache next flushes all the dependency data. Default: 30
Introscope SPM Agent extension cache at a specific size to avoid overhead issues. You must restart the managed application before changes to this property take effect.
flush idle threads to clear the Introscope agent cache. A cache flush results in the SOA Dependency Map dependency data being removed in the agent. The Introscope SPM agent then rediscovers the dependency data for display on the SOA Dependency Map. When the agent fails over to a new Enterprise Manager in a nonclustered (no MOM) environment, set this property to 1 to flush the agent cache in one day. Changes to this property take effect immediately and do not require the managed application to be restarted.
Property
com.wily.introscope.agent.soaphe aderinsertion.enabled
Definition/Default
Enables or disables insertion of Introscope SPM SOAP header entries. If set to True: Introscope SPM adds clientside correlation and dependency information to the SOAP header. If set to False: Introscope SPM does not add client-side correlation and dependency information to the SOAP header. The SOA Dependency Map does not display properly if this property is disabled and SOAP correlation information is added to the SOAP header (rather than added to the HTTP or JMS header). Default: True
Notes
Set this property if your SOAP-
based applications do not work properly due to unexpected header entries. You must restart the managed application before changes to this property take effect.
Implementation Guide
Property
com.wily.introscope.agent.soa. metricNameFormatting
Definition/Default
Replaces any denoted character or characters in Introscope SPM metric names with the underscore character [ _]. For example, setting
Notes
Set this property if you wish to
substitute specified characters with '_' in the metric name. You may want to make this substitution in order to display metric names in the format used in Web Services Manager 7.0. In this case, you must also replace namespace with servicename in the webservices.pbd file. These changes result in Introscope SPM metric names displaying in the Investigator tree and SOA Dependency Map using service name rather than namespace. For more information, see Upgrading Web Services Manager to Introscope SPM on page 56.
You must restart the managed
CheckingAccount/ demobank.ca.com
to be displayed as
http_CheckingAccount_ demobank.ca.com
If set to the character or characters to be replaced: Introscope SPM metric name string characters are replaced with the underscore character. If not set or has no value: No Introscope SPM metric name string character substitution takes place. Default: Not set
APPENDIX
This appendix includes the following topics: Introscope SPM EM extension configuration Introscope SPM EM extension properties . . . . . . . . . . . . . . . . . . . . . 326 327
com.wily.introscope.soa.dashboard.typeviewer.mostcritical.count
=10 3 Save and close the IntroscopeEnterpriseManager.properties file. The Introscope SPM EM extension property is added to
IntroscopeEnterpriseManager.properties.
Once an Introscope SPM EM extension property has been added to the IntroscopeEnterpriseManager.propertiesfile already, you can configure the property as necessary. To configure an Introscope SPM EM extension property: 1 Find the property in the table below that you want to configure. See Introscope SPM EM extension configuration on page 326. 2 Configure the property in the IntroscopeEnterpriseManager.properties file. a If necessary, open the IntroscopeEnterpriseManager.properties file in the <EM_Home>/config directory. b Configure the Introscope SPM EM extension property as appropriate.
Implementation Guide
For example, change the default setting for a property such as:
com.wily.introscope.soa.dashboard.typeviewer.mostcritical.count
=10 to a setting appropriate for your environment.
com.wily.introscope.soa.dashboard.typeviewer.mostcritical.count
=15 Note The example above is an explanation only and not a CA Wily SOA Performance Management setting recommendation. 3 Save and close the IntroscopeEnterpriseManager.properties file. The Introscope SPM EM extension property is configured
com.wily.introscope.soa.dependenc Specifies the number of hours that will ymap.aging.refresh.interval pass before the Enterprise Manager performs the next SOA Dependency Map dependency aging check. The Enterprise Manager tracks the age of each discovered dependency, and periodically rediscovers dependencies to make sure they still exist. The age of a dependency is based in its most recent discovery. During the SOA Dependency Map dependency aging check, the Enterprise Manager determines the age of each dependency across the SOA Dependency Map. A SOA Dependency Map refresh interval is defined as 1 hour. Therefore, six SOA Dependency Map refresh intervals would last 6 hours. Default: 6
conjunction with the com.wily.introscope.so a.dependencymap.agin g.expire.interval property (see below). Changes to this property take effect immediately and do not require the Enterprise Manager to be restarted.
Property
Definition/Default
Notes
com.wily.introscope.soa.dependenc The maximum age, in days, of a This property works in ymap.aging.expire.interval dependency in the SOA Dependency conjunction with the Map. During the dependency aging com.wily.introscope.so check, the Enterprise Manager removes a.dependencymap.agin from the SOA Dependency Map all g.refresh.interval dependencies older than the specified property (see above). value. This property determines the criteria For example, if for removing a com.wily.introscope.soa.dependencym dependency which is ap.aging.expire.interval has a value of then applied during the of 60 days, then an expired (and SOA Dependency Map removed) dependency is one that has dependency aging not been re-discovered during the check. previous 60 days. Changes to this property take effect Default: 60 immediately and do not require the Enterprise Manager to be restarted. com.wily.introscope.soa.dependenc Enables or disables the Introscope SPM ymap.heuristics.clientside.enable client-side logical equivalence heuristics rule. If set to True: Enables the Introscope SPM client-side logical equivalence heuristics rule. If set to False: Disables the Introscope SPM client-side logical equivalence heuristics rule. Default: True The Introscope SPM client-side logical equivalence heuristics rule states that two physical web service operations of type client are considered logically equivalent, if and only if, both operations depend on the same physical web service operation of type server. This can happen when two different applications make the same client-side web service operation call. This rule detects this logical equivalence when the two operations both do and do not have the same metric path (not including the agent specifier).
If this rule is changed,
the change is not retrospectively applied to previously discovered dependencies. Therefore, changing the rule value may have unpredictable results unless the Enterprise Manager is stopped and both the previously saved SOA Dependency Map file types are deleted. For more information, see To delete, move, or rename the saved SOA Dependency Map file: on page 158. Changes to this property take effect immediately and do not require the Enterprise Manager to be restarted.
Implementation Guide
Property
Definition/Default
Notes
If this rule is changed,
com.wily.introscope.soa.dependenc Enables or disables the Introscope SPM ymap.heuristics.namematch.enable logical equivalence heuristics name match rule. If set to True: Enables the Introscope SPM logical equivalence heuristics name match rule. If set to False: Disables the Introscope SPM logical equivalence heuristics name match rule. Default: False The Introscope SPM logical equivalence heuristics name match rule detects logical equivalence when the two operations have the same metric path (not including the agent specifier). The Introscope SPM logical equivalence heuristics name match rule states that two physical web service operations with the same metric path after deletion of the agent specifier are considered as logically equivalent.
the change is not retrospectively applied to previously discovered dependencies. Therefore, changing the rule value may have unpredictable results unless the Enterprise Manager is stopped and both the previously saved SOA Dependency Map file types are deleted. For more information, see To delete, move, or rename the saved SOA Dependency Map file: on page 158. If you create a Virtual Agent in Introscope SPM, you should enable this property. See Configuring virtual agents for Introscope SPM on page 54. Changes to this property take effect immediately and do not require the Enterprise Manager to be restarted.
Property
Definition/Default
Notes
If this rule is changed,
com.wily.introscope.soa.dependenc Enables or disables the Introscope SPM ymap.heuristics.serverside.enable server-side logical equivalence heuristics rule.
the change is not retrospectively applied to previously If set to True: discovered Enables the Introscope SPM server-side dependencies. logical equivalence heuristics rule. Therefore, changing the If set to False: rule value may have unpredictable results Disables the Introscope SPM serverunless the Enterprise side logical equivalence heuristics rule. Manager is stopped and Default: True both the previously The Introscope SPM server-side logical saved SOA Dependency equivalence heuristics rule states that Map file types are two physical web service operations of deleted. For more type server are considered logically information, see To equivalent, if and only if, there exists delete, move, or rename some physical web service operation of the saved SOA type client that depends on both Dependency Map file: on operations. page 158. Typically this will only happen when the Changes to this SOA incorporates some kind of loadproperty take effect balancing mechanism such that a immediately and do not client-side web service operation call is require the Enterprise dispatched to one of several available Manager to be server-side web service operation restarted. implementations
You must restart the
com.wily.introscope.soa.deviation. enable
Enables or disables the deviation metrics, which are: Average Response Time Deviation, Errors Per Interval Deviation, and Responses Per Interval Deviation. Determines if the Introscope SPM deviation metrics are reported. If set to True: Introscope SPM performs calculations to provide deviation metric data. If set to False: None of the deviation metrics are reported. Default: True
Implementation Guide
Property
com.wily.introscope.soa.deviation. art.enable
Definition/Default
Enables or disables the Average Response Time deviation metrics. If set to True: Introscope SPM performs calculations to provide Average Response Time Deviation metric data. If set to False: Introscope SPM does not perform the Average Response Time Deviation calculations. Default: True
Notes
Each deviation metric
(Average Response Time Deviation, Errors Per Interval Deviation, or Responses Per Interval Deviation) reported by the deviation metric service can be individually turned on (enabled) or off (disabled). You must restart the Enterprise Manager before changes to this property take effect.
You must restart the
com.wily.introscope.soa.deviation. dependencymetric.enable
Enables or disables the dependency metrics, which are: Critical Direct, Critical Indirect, Dependency Direct, Dependency Indirect, Average Response Time Deviation, Errors Per Interval Deviation, and Responses Per Interval Deviation. Determines if the Introscope SPM dependency metrics are reported. If set to True: Introscope SPM performs calculations to provide dependency metric data. If set to False: Introscope SPM does not perform dependency metric calculations. Default: True
com.wily.introscope.soa.deviation.c The number of operations per deviation ount.per.metric metric. Use this property to limit the number of metrics created per deviation metric type. Deviation metric types are Average Response Time Deviation, Errors Per Interval Deviation, and Responses Per Interval Deviation. Default: 25
Property
com.wily.introscope.soa.deviation. dependency.refreshrate
Definition/Default
Frequency in hours that cached SOA Dependency Map dependency relationship data is refreshed. The SOA Dependency Map data is cached by the deviation metric service. Critical, dependent, and deviation metrics are reported for these service and operations every 15 seconds. The cached SOA Dependency Map data is periodically refreshed based on this property. This map rarely changes and usually does so only if the deployment is changed. Default: 1 hour
Notes
You must restart the
com.wily.introscope.soa.deviation. errors.enable
Enables or disables the errors deviation metrics. Determines if the Introscope SPM errors deviation metrics are reported.
(Average Response Time Deviation, Errors Per Interval Deviation, or Responses Per If set to True: Interval Deviation) Introscope SPM performs calculations reported by the to provide error deviation metric data. deviation metric service If set to False: can be individually turned on (enabled) or None of the errors deviation metrics are off (disabled). reported. You must restart the Default: True Enterprise Manager before changes to this property take effect. Maximum number of total deviation metrics reported. Default: 1000
You must restart the
com.wily.introscope.soa.deviation. max.metric.count
Implementation Guide
Property
com.wily.introscope.soa.deviation. metric.expressionlist
Definition/Default
Defines a list of names for deviation metric expressions. These names are user defined in a comma separated list. Each name is used as a separate metric expression. This property is referenced by the deviation.metric.calledbackends property to create user-defined deviation metrics. Default: calledbackends
Notes
You must restart the
Example:
deviation.metric.expressionlist=al pha1, beta2, gama3 com.wily.introscope.soa.deviation. metric.calledbackends Uses the names defined in the deviation.metric.expression list property (above) to form a new property. The new property name has the following format: com.wily.introscope.soa.deviation. metric.<user defined name from deviation.metric. expressionlist> = <user defined regular expression> The value assigned to the deviation.metric.calledbackends property is the metric expression. For example:
You must restart the
Examples:
com.wily.introscope.soa.deviatio
Property
com.wily.introscope.soa.deviation. usage.enable
Definition/Default
Enables or disables the Responses Per Interval deviation metrics. Determines if the Introscope SPM Responses Per Interval deviation metrics are reported. If set to True: The Responses Per Interval deviation metrics are reported. If set to False: None of the Responses Per Interval deviation metrics are reported. Default: True
Notes
You must restart the
com.wily.introscope.soa.dashboard Enables the data for a selected .typeviewer.average.enable operation to display the Average Response Time Deviation graph in these Introscope SPM UI components: SOA Performance - Most Critical Operations dashboard SOA Performance - Most Dependent Operations dashboard Most Critical tab Most Dependent tab If set to True: The data for the selected operation displays in the Average Response Time Deviation graph. If set to False: The data for the selected operation in the Average Response Time Deviation graph does not display. Default: True
Deviation data is
available only if it is if reported by the agent to the Enterprise Manager, then displayed in the Investigator. See the definition of the Average Response Time Deviation metric on page 118. If this property is also in the
the IntroscopeWorkstation. properties property overrides this property. You must restart the Enterprise Manager before changes to this property take effect.
Implementation Guide
Property
Definition/Default
Notes
Deviation data is
com.wily.introscope.soa.dashboard Enables the data for a selected .typeviewer.response.enable operation to display in the Responses Per Interval Deviation graph in these Introscope SPM UI components: SOA Performance - Most Critical Operations dashboard SOA Performance - Most Dependent Operations dashboard Most Critical tab Most Dependent tab If set to True: The data for the selected operation displays in the Responses Per Interval Deviation graph. If set to False: The data for the selected operation in the Responses Per Interval Deviation graph does not display. Default: True
available only if it is if reported by the agent to the Enterprise Manager, then displayed in the Investigator. See the definition of the Average Response Time Deviation metric on page 118. If this property is also in the
the
property overrides this property. You must restart the Enterprise Manager before changes to this property take effect.
Deviation data is
com.wily.introscope.soa.dashboard Enables the data for a selected .typeviewer.errors.enable operation to display in the Errors Per Interval Deviation graph in these Introscope SPM UI components: SOA Performance - Most Critical Operations dashboard SOA Performance - Most Dependent Operations dashboard Most Critical tab Most Dependent tab If set to True: The data for the selected operation displays in the Errors Per Interval Deviation graph. If set to False: The data for the selected operation in the Errors Per Interval Deviation graph does not display. Default: True
available only if it is if reported by the agent to the Enterprise Manager, then displayed in the Investigator. See the definition of the Average Response Time Deviation metric on page 118. If this property is also in the
the
property overrides this property. You must restart the Enterprise Manager before changes to this property take effect.
Property
Definition/Default
Notes
If this property is also in
com.wily.introscope.soa.dashboard Displays the Most Critical Operations .typeviewer.mostcritical.enable dashboard in the Console and the Most Critical tab in the Investigator. If set to True: The SOA Performance - Most Critical Operations dashboard option appears in the drop-down menu and the Most Critical tab appears in the Investigator.
the
the
property overrides this property. If set to False: You must restart the The Most Critical Operations dashboard Enterprise Manager option displays in the drop-down menu, before changes to this but no dashboard appears. Instead, an property take effect. error message appears that states: This dashboard is not available.To view it, set the com.wily.introscope.soa.dashboard.type viewer.mostcritical.enable property to true. Additionally, the Most Critical tab does not appear in the Investigator. Default: True com.wily.introscope.soa.dashboard Displays the Most Dependent .typeviewer.mostdependent.enable Operations dashboard in the Console and the Most Dependent tab in the Investigator. If set to True: The SOA Performance - Most Dependent Operations dashboard option appears in the drop-down menu and the Most Dependent tab appears in the Investigator. If set to False: The Most Dependent Operations dashboard option displays in the dropdown menu, but no dashboard appears. Instead, an error message appears that states: This dashboard is not available.To view it, set the com.wily.introscope.soa.dashboard.type viewer.mostdependent.enable property to true. Additionally, the Most Dependent tab does not appear in the Investigator. Default: True
the
the
property overrides this property. You must restart the Enterprise Manager before changes to this property take effect.
Implementation Guide
Property
Definition/Default
Notes
If this property is also in
com.wily.introscope.soa.dashboard Determines the total number of critical .typeviewer.mostcritical.count operations reported by all agents in the SOA Performance - Most Critical Operations dashboard and the Most Critical tab. The minimum value is 0 and the maximum value should be less than or equal to the value of the
the
the IntroscopeWorkstation. properties property overrides this property. You must restart the Enterprise Manager before changes to this property take effect.
If this property is also in
the
the IntroscopeWorkstation. properties property overrides this property. You must restart the Enterprise Manager before changes to this property take effect.
APPENDIX
This appendix includes the following topics: Introscope SPM Workstation configuration . . . . . . . . . . . . . . . . . . . 340 342
com.wily.introscope.soa.dashboard.typeviewer.mostcritical.count= 10
3 Save and close the IntroscopeWorkstation.properties file. The Introscope SPM Workstation property is added to IntroscopeWorkstation.properties. Once an Introscope SPM Workstation property has been added to the IntroscopeWorkstation.propertiesfile already, you can configure the property as necessary. To configure an Introscope SPM Workstation property: 1 Find the property in the table below that you want to configure. See Introscope SPM Workstation configuration on page 340. 2 Configure the property in the IntroscopeWorkstation.properties file. a If necessary, open the IntroscopeWorkstation.properties file in the <EM_Home>/config directory. b Configure the Introscope SPM Workstation property as appropriate.
Implementation Guide
For example, change the default setting for a property such as:
com.wily.introscope.soa.dashboard.typeviewer.mostcritical.count= 10
to a setting appropriate for your environment.
com.wily.introscope.soa.dashboard.typeviewer.mostcritical.count= 15
Note The example above is an explanation only and not a CA Wily SOA Performance Management setting recommendation. 3 Save and close the IntroscopeWorkstation.properties file. The Introscope SPM Workstation property is configured.
com.wily.introscope.soa.depe The maximum number of map nodes that ndencymap.ui.view.nodecount display on the SOA Dependency Map. If you select an Investigator node, and the number of Introscope SPM SOA Dependency Map nodes exceeds the
For example, if you change from the Physical Agent to the Physical Services view, and the node count limit is exceeded, the SOA Dependency Map displays the error message and reverts back to the Physical Agent view. However, if you expand the ShowAllOperations or ShowAllServices view and the node count value is exceeded, the SOA Dependency Map displays the error message and displays any recently-added SOA Dependency Map nodes. Default: 500
Implementation Guide
Property
Definition/Default
Notes
com.wily.introscope.soa.dash Enables the data for a selected operation to Deviation data is board.typeviewer.average.ena display the Average Response Time Deviation available only if it is if graph in these Introscope SPM UI components: ble reported by the agent to the Enterprise SOA Performance - Most Critical Operations Manager, then dashboard displayed in the SOA Performance - Most Dependent Investigator. See Operations dashboard Using the Deviations Most Critical tab tab on page 118. Most Dependent tab If this property is also If set to True: in the The data for the selected operation displays in IntroscopeEnterpr the Average Response Time Deviation graph. iseManager.proper If set to False: The data for the selected operation in the Average Response Time Deviation graph does not display. Default: True
Workstation before changes to this property take effect. com.wily.introscope.soa.dash Enables the data for a selected operation to Deviation data is board.typeviewer.response.en display in the Responses Per Interval Deviation available only if it is if graph in these Introscope SPM UI components: able reported by the agent to the Enterprise SOA Performance - Most Critical Operations Manager, then dashboard displayed in the SOA Performance - Most Dependent Investigator. See Operations dashboard Using the Deviations Most Critical tab tab on page 118. Most Dependent tab If this property is also If set to True: in the The data for the selected operation displays in IntroscopeEnterpr the Responses Per Interval Deviation graph. iseManager.proper If set to False: The data for the selected operation in the Responses Per Interval Deviation graph does not display. Default: True
Property
Definition/Default
Notes
com.wily.introscope.soa.dash Enables the data for a selected operation to Deviation data is board.typeviewer.errors.enabl display in the Errors Per Interval Deviation available only if it is if graph in these Introscope SPM UI components: e reported by the agent to the Enterprise SOA Performance - Most Critical Operations Manager, then dashboard displayed in the SOA Performance - Most Dependent Investigator. See Operations dashboard Using the Deviations Most Critical tab tab on page 118. Most Dependent tab If this property is also If set to True: in the The data for the selected operation displays in IntroscopeEnterpr the Errors Per Interval Deviation graph. iseManager.proper If set to False: The data for the selected operation in the Errors Per Interval Deviation graph does not display. Default: True
Workstation before changes to this property take effect. com.wily.introscope.soa.dash Displays the Most Critical Operations board.typeviewer.mostcritical. dashboard in the Console and the Most Critical tab in the Investigator. enable If set to True: The SOA Performance - Most Critical Operations dashboard option appears in the drop-down menu and the Most Critical tab appears in the Investigator. If set to False: The Most Critical Operations dashboard option displays in the drop-down menu, but no dashboard appears. Instead, an error message appears that states: This dashboard is not available.To view it, set the com.wily.introscope.soa.dashboard.typeviewer. mostcritical.enable property to true. Additionally, the Most Critical tab does not appear in the Investigator. Default: True
If this property is also
in the
Implementation Guide
Property
Definition/Default
Notes
If this property is also
com.wily.introscope.soa.dash Displays the Most Dependent Operations board.typeviewer.mostdepend dashboard in the Console and the Most Dependent tab in the Investigator. ent.enable If set to True: The SOA Performance - Most Dependent Operations dashboard option appears in the drop-down menu and the Most Dependent tab appears in the Investigator. If set to False: The Most Dependent Operations dashboard option displays in the drop-down menu, but no dashboard appears. Instead, an error message appears that states: This dashboard is not available.To view it, set the com.wily.introscope.soa.dashboard.typeviewer. mostdependent.enable property to true. Additionally, the Most Dependent tab does not appear in the Investigator. Default: True
in the
com.wily.introscope.soa.dash Determines the total number of critical board.typeviewer.mostcritical. operations reported by all agents in the SOA Performance - Most Critical Operations count dashboard and the Most Critical tab. The minimum value is 0 and the maximum value should be less than or equal to the value of the
in the
Property
Definition/Default
Notes
com.wily.introscope.soa.dash Determines the total number of most If this property is also board.typeviewer.mostdepend dependent operations reported by the agents in the in the SOA Performance - Most Dependent ent.count IntroscopeEnterpr Operations dashboard and the Most Dependent iseManager.proper tab. ties file, the The minimum value is 0 and the maximum IntroscopeWorksta value should be less than or equal to the value tion.properties of the property overrides the
Workstation before changes to this property take effect. introscope.workstation.soa.de Controls the display of the metrics in the SOA pendencymap.fetchmetrics Dependency Map. If set to True: The Workstation requests from the Enterprise Manager and displays on the SOA Dependency Map map nodes the metrics based on your selections in the Primary Map Metric and Tooltips dropdown lists. If set to False: The Workstation does not request from the Enterprise Manager and does not display on the SOA Dependency Map map nodes the metrics based on your selections in the Primary Map Metric and Tooltips dropdown lists. Default: True
You must restart the
I ND E X
Index
Symbols
.NET Agent configuring for cross-process transaction tracing 186 required configuration after upgrade 317 version required for ASP.NET 29, 60, 69 version required for WCF 29, 60, 69 Agent extensions configuring 42 installing 41 uninstalling 47
A
adding a filter 199 Additional dependencies not found 169 Agent extensions .NET configuring 42 installing 41 uninstalling 47 about 34 configuration propertiesIntroscopeAgent.profile, Java Agent extension configuration properties 319 Java deploying 38, 53, 64, 75, 79 extracting 35, 63, 72 uninstalling 39, 65, 78, 81 supported native SOAP engines 34 agents .NET configuring for cross-process transaction tracing 186 disconnected 158, 179 greyed out 179
renaming 179 requirements 26 virtual, configuring for Introscope SPM 54 alert states, numerical meaning in Introscope 138 application Overview tab 94 servers, supported natively 34 solving problems using cross-process transaction trace 188 applications 147 asynchronous web service invocation response times 98 average response time interpreting 98
B
back-ends 147 Blame. See Boundary Blame Boundary Blame, about 128 Busiest Operations dashboard 104
C
checklists, for installation 29, 60, 69 client Dependencies tab 116 Deviations tab 122 health causes of slowness 97 dashboard 99 node Dependencies tab display 114 Deviations tab display 119 Overview tab 94, 107 web services, definition 17
Index 347
client-server dependency relationships 147 CLR boundaries and cross-process transaction tracing 186 relationship to web services client and server 17 clustered Introscope environment 172 Collectors 173 complex filters 200 components, seeing Blamed in Investigator tree 128 configuring Agent extension properties 319 EM extension 325, 339 content type Services 162 correlated events definition 201 viewing 201 cross-process transaction Java to .NET 194 Java to Java 191 tracing and JVM/CLR boundaries 186 definition 186 how to configure for .NET Agent 186 viewing to solve problems 188
dependencymap.sav 157 deployment, verifying 55 Deviations tab 120 tabs 118 disconnected agents 158, 179 discover web services 157 documentation, Introscope 23
E
EM extension configuring 326, 340 extracting 50, 66, 82, 85 uninstalling 53, 68, 84, 87 endpoints, running Transaction Traces against 203 Enterprise Architect 177 Enterprise Manager 156, 157, 158, 159, 174, 179 disconnected agent 158 rediscover all SOA dependencies 157 environments heterogeneous, defined 186 homogeneous, defined 186 error messages viewing for SOAP faults 206 snapshot pane 206 ErrorDetector errors per interval metric 132 required installed version 29 viewing error messages 206 SOAP faults 204 web service errors 204 errors per interval metric 129, 130 tab, viewing 126 viewing 126 viewing historical in Workstation historical 206 viewing live in Workstation live 205
D
dashboard Busiest Operations 104 Most Dependent Operations 102 dashboards Client Health 99 Most Critical Operations 101 Overview, interpreting 97 Server Health 100, 102, 104 SOA Performance Overview 96 debugging options 56 Dependencies tab 114, 115 dependencies 147 SOA 156 Dependency Direct 161 dependency relationships 146 dependencymap.bak 157
348 Index
Implementation Guide
F
failures, reasons for in web service invocations 16 faults 147 filters adding 199 complex 200 removing 199 setting 200 front-ends 147
management module filename 83 IntroscopeAgent.profile 179 Investigator 161, 163, 164, 169, 175, 176
J
Java Agent extensions, extracting 35, 63, 72 Jump here in tree 171 JVM, boundaries and cross-process transaction tracing 186
L
logical equivalence 184 heuristics 157 view 166
H
hardware requirements 26 health, determining for web services 140 heterogeneous environment, defined 186 homogeneous environment, defined 186
M
management modules file name for Introscope SPM 51 file name for Introscope SPM OSB 67 file name for Introscope SPM WPS 83 upgrading 57 managerSoapEndpoint, property defined 328, 342 map. See SOA Dependency Map max metric count, parameter defined 332 method Overview tab 94, 109 metrics 159 errors per interval 129, 130 SOAP faults per interval 128, 129, 131 web services, viewing per agent 132 MOM 172 SOA Dependency Map 172 Most Critical Operations dashboard 101 tab 124, 125 tabs 124 Most Dependent Operations dashboard 102 tab 125
I
illustration sample SOA implementation 13, 14 installation checklists 29, 60, 69 directory name conventions 27 ErrorDetector prerequisite, version 29 Introscope prerequisite, version 29, 60, 69 overview 26 prerequisites 29 summary of steps 31 Introscope .NET Agent upgrade configuration changes 317 version required 40 Agent requirements 26 documents you need 23 Investigator WebServices node, defined 94 metrics 159 required installed version 29, 60, 69 viewing web services metrics in Investigator 128 Workstation, starting 95 Introscope SPM Agent extension 156, 174 management modules file name 51 metrics 159 OSB management module filename 67 uninstalling 59 WPS
Index 349
N
name conventions, for installation directories 27 namespace node Dependencies tab display 114 Deviations tab display 119 namespaces Dependencies tab 117 Deviations tab 123 node, WebServices 94
O
operation Overview tab 94, 109 operations 147 options, debugging 56 OSB 146 Overview dashboard, SOA Performance 96 tabs 105
P
partial dependency map 156 physical view 166 prerequisites .NET Agent extension 40, 56 ErrorDetector version 29 installation 29 Introscope version 29, 60, 69 Java agent extension 38, 64, 75 Primary metric 159 setting 160
R
real-time dependency relationships 146 removing a filter 199 renaming agent, and SOA Dependency map updating 179 requirements hardware/software for installation 26 Introscope Agent 26 response times asynchronous web service invocations 98 interpreting 98 synchronous web service invocations 98
S
server causes of slowness 97
Dependencies tab 116 Deviations tab 122 health, dashboard 100, 102, 104 node Dependencies tab display 114 Deviations tab display 119 Overview tab 94, 107 web services, definition 17 service-oriented architecture. See SOA services 147, 162 setting a filter 200 size, setting max SOAP size property 321 SOA about 12 dependencies 156 implementation, illustration 13, 14 SOA Dependency Map 146, 147, 148, 156 Add Dependencies 156 Additional dependencies not found 169 changing the view 171 choose a view 166 choosing a content type 161 choosing content 159 components 151 Agent icon 154 Agent name 153 Arrow showing one web service item calling another 153 Client operation icon 152, 154 Client operation name 152 Client Service icon 154 Client service icon 154 Client service name 153 Content type dropdown list 152 Fit to tab 153 Magnify a selected area 153 Pan tool 153 Primary Metric dropdown list 152 Primary Metric value 152 Roll up Dependencies button 153 Save as image button 153 Scroll bar 153 Server operation icon 153, 154 Server operation name 153 Server Service icon 154 Server service icon 153 SOA Dependency Map tab 152 Tooltips button 152
350 Index
Implementation Guide
Unroll Dependencies button 153 View dropdown list 152 Zoom in and out 153 content type 148 agent 148 Agents 162 operation 148 operations 155 service 148 Services 162, 164 defaults 155 FAQs 180 from map to Investigator 171 hide dependencies 169 Introscope node 149 Investigator 148 logical view 166 map node 155 MOM 172 node aging and removal 159 output images 177 Physical Agent view 172 Physical Services view 173 Physical view 155 physical view 166 saving the map 157 setting the content type 165 Show All Operations 155 show all operations for a service 170 show all services for an agent 170 Show Next Dependency 156 tab 147 tasks 150 tooltips metrics 161 Transaction Trace 180 triage 176 unroll dependencies levels 169 View dropdown list 166 SOA Performance Overview dashboard 96 SOAP engines, native, supported 34 faults per interval metric 128, 129, 131 viewing error messages 206 viewing in ErrorDetector 204 messages setting max size 321 soapMessageSize, property defined 321
software download site 26 requirements 26 standalone map nodes 164 synchronous web service invocations, response times 98
T
tabs application Overview 94 Client Dependencies 116 Client Deviations 122 Client Overview 94, 107 Dependencies 115 Dependencies, about 114 Deviations 120 Deviations, about 118 Errors 126 method Overview 94, 109 Most Critical 124, 125 Most Dependent 125 namespaces Dependencies 117 namespaces Deviations 123 operation Overview 94, 109 Overview, about 105 Server Dependencies 116 Server Deviations 122 Server Overview 94, 107 web services Overview 94, 108 tooltips 159, 160, 161 metrics 161 Transaction Trace 180 definitions of cross-process 186 viewing to solve problems 188 Transaction Tracer 203 transactions 147 tracking web services business 186
U
uninstalling .NET Agent extensions 47 EM extension 53, 68, 84, 87 Introscope SPM 59 Java Agent extensions 39, 65, 78, 81 upgrading .NET Agent, required configuration after management module 57 using Errors tab 126
317
Index 351
V
variables, used in this guide 27 verifying, deployment 55 virtual agents configuring for Introscope SPM definition 54
54
W
web services 146, 156, 161 business transactions, tracking 186 causes of client/server slowness 97 client, definition 17 determining health 140 discover 157 endpoints, running Transaction Trace against 203 invocations, reasons for failures 16 metrics aggregated 135, 137 viewing per agent 132 name node in Investigator 134 operation name node 135 overview of managing 12 Overview tab 94, 108 seeing in Transaction Tracer 203 server, definition 17 viewing in Investigator 128 webservices node defined 94 Dependencies tab displaying on 114 Deviations tab displaying on 119 Wily software download site 26 Workstation 156, 158, 174, 175 starting 95 using to view errors historical 206 live 205 WPS/WESB 146
352 Index