Intro Scope Web View Guide

WebView User Guide for
SAP
Release 7.1
CA, Inc.
Wily Technology Division
6000 Shoreline Court, Suite 200
South San Francisco, CA 94080
1 888 GET WILY < US Toll Free >
1 650 534 9400 < phone >
1 650 534 9340 < fax >
www.wilytech.com
Introscope 7.1 WebView User Guide for SAP
Copyright 2006, CA. All Rights Reserved.
Wily Technology, Inc., the Wily Technology Logo and Introscope are registered trademarks of
CA. Blame, Blame Game, ChangeDetector, Get Wily, Introscope BRT Adapter, Introscope
ErrorDetector, Introscope Environment Performance Agent, Introscope LeakHunter,
Introscope PowerPack, Introscope SQL Agent, Introscope SNMP Adapter, Introscope
Transaction Tracer, Management 360, SmartStor, Web Services Manager, Whole Application,
Wily Customer Experience Manager, 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's Wily Technology Division, contact
Wily Technical Support at 1-888-GET-WILY or support@wilytech.com. If you are the
registered support contact for your company, you can access the support Web site directly at
http://support.wilytech.com/cgi-bin/wilytech.cfg/php/enduser/acct_login.php.
Introscope 7.1 WebView User Guide for SAP (12/18/06) Page 3
Contents
Chapter 1 About Introscope and WebView . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Overview: Introscope and WebView 6
The Managed Application and Introscope Components . . . . . . . . . . . . . . . . . . . . .6
How WebView Fits Into an Introscope Deployment . . . . . . . . . . . . . . . . . . . . . . .7
WebView and Introscope Workstation Functionality . . . . . . . . . . . . . . . . . . . . . . 8
WebView and Workstation Functionality Comparison . . . . . . . . . . . . . . . . . . . . . .8
Chapter 2 Viewing Introscope Data in WebView . . . . . . . . . . . . . . . . . . . . . . . 9
Starting WebView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Logging Into WebView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9
About the WebView Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Installing the Adobe SVG Plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
About the WebView Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
About the WebView Investigator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Logging Out of WebView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Viewing Introscope Data in WebView Console . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Opening a Console Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Accessing Dashboards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Using the Console Lens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Bookmarking Dashboards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Viewing Graph Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Accessing Hyperlinks On Dashboards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Viewing Metric Data in the Investigator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Opening an Investigator Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Expanding and Collapsing the Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Viewing Metric Data in the Preview Pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Viewing Automatic Filtered Views in the Preview Pane . . . . . . . . . . . . . . . . . . . . 18
Viewing Graph Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
WebView Data Viewers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Data Viewer Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Changing the Scale of Graph Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Export Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Viewing Historical Data in WebView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Viewing Historical Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Chapter 3 Viewing and Tracing Transactions in WebView . . . . . . . . . . . . . . . 25
About the WebView Transaction Viewer 26
Querying Historical Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Starting a New Transaction Trace Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Viewing Current Transaction Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Viewing Transactions: Trace, Tree, Summary, and Details . . . . . . . . . . . . . . . . 31
The Transaction Trace View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
The Transaction Tree View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
The Transaction Summary View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
The Transaction Details View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Stopping and Restarting a Transaction Trace . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Saving Transaction Trace Data as XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
1 About Introscope and WebView
Introscope
is a system management application created to help you manage Java

Application performance. Unlike development tools, Introscope is designed to scale with
minimal performance impact, enabling you to monitor and manage your application
performance in live production environments.
Introscope WebView provides a browser-based window into your Introscope deployment.
WebView makes it possible for Introscope users to view application performance data
using a Web browser.
Using WebView:
Offers location independenceyou can view Introscope application performance
data from any computer, anywhere, that is running a compatible browser.
Broadens access within your companymore people in your organization can
easily access application performance data without the need for installing special
software on their desktop.
Enables collaborationsupports different groups within your company in working
together to analyze and resolve application performance problems.
Contributes to business efficiencyWebView contributes to your mission of
achieving greater application uptime to support critical business processes.
This section includes these topics:
Overview: Introscope and WebView, page 6
WebView and Introscope Workstation Functionality, page 8
Overview: Introscope and WebView
Introscope, through the ProbeBuilder, adds Introscope Probes to a Java Application.
Using AutoProbe automates this process, with the ProbeBuilder dynamically adding
Probes to the Java Application when the application starts.
The Probes measure specific pieces of information about an application without changing
the applications business logic. An Introscope Agent is installed on the same machine as
the Introscope-enabled application. After the Probes have been installed in the bytecode,
the Java application is referred to as an Introscope-enabled application. When the Java
application with Probes is running, it is called a managed application.
This illustration shows how Introscope prepares a Java application to be managed:
The Managed Application and Introscope Components
As a managed application runs, Probes relay collected data to the Agent. The Agent then
collects and summarizes the data and sends it to the Enterprise Manager.
Data collected by the Enterprise Manager can be accessed through one or more
Workstations. You can use the Workstation to view performance data, and configure the
Enterprise Manager to perform such tasks as collecting information for later analysis, and
creating Alerts.
As a managed application runs, Introscope Agents collect performance data in real time,
and send the information to the Enterprise Manager. The Workstation allows you to
configure the Enterprise Manager, organize Metrics, define actions based on their values,
and display the information you choose in the most convenient format for you.
This illustration shows the Introscope components and how they cooperate and
communicate with one another:
How WebView Fits Into an Introscope Deployment
Introscope WebView is a browser-based alternative to the Workstation client application.
WebView is installed as part of the Introscope core package and runs independently of an
application server. After installing WebView, a standard Web browser is all that is
required to view Introscope data.
This illustration shows how WebView fits into an Introscope environment:
WebView is a view-only client, and implements a subset of the functions available in the
Workstation. WebView enables a user to view performance data, but does not provide the
advanced configuration and Alert capabilities provided by the Workstation.
WebView thus does not replace Introscope Workstation, but complements it. Introscope
customers often decide to deploy both the Workstation and WebView, to offer the
broadest level of data access capabilities to meet different users needs.
WebView and Introscope Workstation Functionality
Both the Introscope Workstation and WebView provide a window to view Metric data
reported by Introscope Agents. However, WebView provides a simplified, view-only
environment, and the Introscope Workstation provides a way to edit business logic
constructs as well as view Metric data.
WebView and Workstation Functionality Comparison
Both WebView and Workstation enable you to view Metric data in the Investigator and
Console Dashboards, but only the Workstation enables you to create and edit Elements
(Alerts, Metric Groups, etc.) and Dashboards.
This table shows the functional differences between WebView and the Workstation:
Consult the Introscope Workstation User Guide for help using the Introscope Workstation
to perform Workstation-only tasks.
Functionality WebView Workstation
View Investigator and Console in web browser X -
View Metric Data and Blame information in Investigator Tree X X
View pre-configured Dashboards X X
View Historical Data X X
Filter Dashboards to show only data from selected Agents X X
Create and Edit Dashboards - X
Change data viewer type in Investigator Preview Pane and
make temporary viewer modifications
- X
Receive Alert notifications - X
Create and edit Management Module Elements (Alerts,
Actions etc.) and view Element settings
- X
Perform administrative functions (mount/unmount Agents,
shut down Enterprise Manager, shut off Agents/Resources/
Metrics)
- X
2 Viewing Introscope Data in WebView
WebView provides a browser-based alternative to the Introscope Workstation, enabling
you to view data collected by the Enterprise Manager.
This chapter includes these topics:
Starting WebView
About the WebView Interface
Viewing Introscope Data in WebView Console
Viewing Metric Data in the Investigator
WebView Data Viewers
Viewing Historical Data in WebView
Starting WebView
You can start WebView from a browser or from Windows, depending on how WebView
was installed and configured (see the Introscope Installation and Configuration Guide).
Note: As of Introscope 7.1, the Enterprise Manager deploys WebView as a Web
application, so you can access WebView from a browser directly, without having to
run the Windows executable file.
To start WebView from a browser:
Open a browswer and type this URL:
http://localhost:8081/WebView
To start WebView on Windows:
Start > Introscope > Introscope WebView, or
run Introscope WebView.exe.
Logging Into WebView
Note: The Introscope Enterprise Manager must be running before you can log into
WebView.
To log into WebView:
1. Start Internet Explorer 6.0.1 or higher on a Windows machine.
2. Use the URL your administrator has set up to start WebView.
The Introscope WebView login screen opens.
3. Enter your username and password and click Log In.
Note: Username and password are authenticated through the Enterprise Manager,
so you can use the same username and password for WebView as you use for
logging into the Workstation.
If the username and password are valid, the Introscope Welcome Screen opens.
About the WebView Interface
You view information using two WebView windows:
Consoleshows data in Dashboards, which contain Data Viewers.
Investigatorshows all Agents, Domains and Metrics in hierarchical form.
Installing the Adobe SVG Plug-in
WebView requires the Adobe Scalable Vector Graphics (SVG) plug-in. SVG is a text-based
graphics language that describes images with vector shapes, text, and embedded raster
graphics. WebView requires the Adobe SVG plug-in to enable you to copy dashboards or
Investigator data viewers to the clipboard, then paste them into e-mail, Word, or other
document. If the SVG plug-in is not available on your system, WebView prompts you to
install it the first time you open a Console or Investigator window.
About the WebView Console
The WebView Console provides views of application performance, using the Dashboards
that are available from the Enterprise Manager into which WebView is logged. This
example shows a J2EE Overview dashboard:
Note: You can view, but not edit, all information in the WebView Console Dashboards.
Use the Introscope Workstation to create and edit Dashboards.
About the WebView Investigator
The WebView Investigator provides a hierarchical view of data collected by Agents:
The Investigator has two panes:
The Investigator Tree is a hierarchical structure that provides information about
each host and application managed by the Enterprise Manager to which WebView
is connected. The Investigator tree shows Metrics from all connected Agents.
The Preview pane shows a graphical view of data from the selected Metric or
Resource.
Investigator Tree Contents
The Investigator tree in Introscope WebView shows Metrics organized by hosts. The
contents of the Investigator tree vary based on the users permissions:
Users with SuperDomain permission (at least read permission) see all Domains for
that Enterprise Manager in the Investigator tree.
Users with permissions for multiple Domains see Domain information for those
Domains in the Investigator tree.
Users with permissions for only one Domain do not see Domain information in the
Investigator tree, they see only the Metrics folder
The Investigator tree contains two nodesSuperDomain and Domains:
The SuperDomain Node compiles all Agents and Metrics for all defined Domains.
The Domains Node sorts information into a Resource for each Domain. The
Resource contains any Agents mapped to that Domain, and a Custom Metric Host
for that Agent.
Metrics in the Investigator Tree
The Investigator tree displays Metric data reported by Introscope Agents, organized by:
Hostthe Host machine on which the Agent is running
Processthe instance of the managed application running
Agentthe reporting Agent
ResourceJ2EE components
MetricsMetric data generated by the ProbeBuilder Directives files (.pbd)
The Metrics that automatically appear in the Investigator tree are generated by the
default ProbeBuilder Directives files (.pbd files), and depend on the activity of the
managed application. You can specify additional Metric information to be generated by
creating Custom Tracers (see the Introscope Installation and Configuration Guide).
Metrics appear in the tree when data from that Metric is first reported by the Agent. After
that, the Metric will be visible in the tree, even if new data is not being received from the
Agent for that Metric.
These are the items in the SuperDomain or Domains folder in the Investigator tree.
Agent Icon Appearance In Investigator Tree
The Agent icon in the Investigator tree is indicates current Agent status information:
If the icon is colored in for any of these parts, it means:
Icon Tree Item Description
SuperDomain Domain that includes all defined Domains, as well as Agents
that are not assigned to other Domains. Only visible to users
with SuperDomain access.
Domains Resource that contains user-defined Domains. Only visible to
users with access to multiple Domains.
Host name
Custom Metric Host
Server on which your monitored application is running.
In addition to real hosts, the Workstation creates a virtual
host Custom Metric Host to contain Metrics generated by
Calculators.
Process name
Custom Metric Process
Each instance of the managed Java Application that is
running.
Process names appear here as specified in the application
profile.
The virtual Custom Metric Host contains a virtual process,
Custom Metric Process, to contain Metrics generated by
Calculators.
Agent Name
Custom Metric Agent
Name of Agent specified by the user or automatically
assigned in versions that support Agent auto-naming.
The Custom virtual Metric Process contains a virtual Agent,
Custom Metric Agent, to contain Metrics generated by
Calculators.
Resource Resources group Metrics. Resources can also contain sub-
resources that further group Metrics.
Metric Measurement of a specific application activity.
Agent connection status
Metric reporting status
Metric Reporting icon (gear)one or more Metrics under the Agent are reporting
Agent connection icon (double-ended arrow)Agent is connected to the
Enterprise Manager
Agent, Resource and Metric Appearance in the Investigator Tree
The Investigator tree in WebView can show if an Agent, Resource or Metric is shut off or
not reporting (it will be grayed out). However, it cannot show the reason why, because
the Agent/Resource/Metric settings cannot be viewed in WebView. Use the Introscope
Workstation to diagnose issues in Metric, Resource or Agent reporting.
Logging Out of WebView
To log out of WebView, click the Log Out link in the upper-right corner of the screen.
Viewing Introscope Data in WebView Console
To view Introscope data in Dashboards, you open a WebView Console.
Opening a Console Window
To open a Console window, click the Console tab at the top of the screen.
To open multiple Console windows, right-click the Console tab and select Open Link in
New Window from the menu
Accessing Dashboards
To access Dashboards in WebView:
Open an Introscope Console and select a dashboard from the drop-down list, then
click View.
Using the Console Lens
Users with multiple Agents often want to isolate and view data on a per-Agent basis, but
this is difficult to do without creating multiple copies of Dashboards, each one designed to
show data from a different Agent. The Console Lens solves this problem by enabling you
to immediately apply the Console Lens to filter the data on the Dashboard when new
Agents connect.
When a filter is applied in the Console, it persists even when you view other Dashboards,
switch back and forth from Investigator, or switch to Historical mode. The Console Lens
filtering persists until you:
use the Clear command
close the WebView browser session window
log out of WebView
Note: Graphs powered by Calculators are not supported in lensed dashboards.
Applying the Console Lens
To apply the Console Lens:
1. Click the Lens button.
The Apply Console Lens window opens.
2. Select an Agent, or select multiple Agents on which to filter.
To select multiple Agents, click and drag, or CTRL +click.
3. Click Apply.
Clearing the Console Lens
To clear the Console Lens:
click the Lens button, then click Clear.
Data appears in the Dashboards as originally configured.
Bookmarking Dashboards
You can bookmark Dashboards, for quick access to Dashboards you use often.
To bookmark a Dashboard:
1. Access the Dashboard youd like to bookmark.
2. From the browser menu, select Favorites > Add To Favorites.
3. Accept the suggested name for the Dashboard (or enter a new one).
4. Click OK.
The Dashboard is now available from the Favorites menu.
Accessing a Dashboard Through a Bookmark
To access a Dashboard saved as a Favorite:
Open the Favorites menu and select the bookmark for the desired Dashboard.
The Dashboard opens in a separate window.
Note: If you are not logged into WebView, the login window opens.
Viewing Graph Details
You use Graph Details to identify Metrics in a data viewer in the Console or Investigator.
Note: You cannot view details for a Traffic Light viewer.
To view graph details:
1. In the Console window, hover your mouse over the data viewer, then right-click and
select Details from the context menu. The Viewer Detail window opens.
2. The fully qualified names of all the Metrics in the graph appear, with their
corresponding Minimum, Average, Maximum, and Last values.
Note: If the Metric name is truncated you can widen the Metric name column to see
the full name, or hover your cursor over the Metric name to open a pop-up box
that shows the full name.
Accessing Hyperlinks On Dashboards
Introscope provides a quick and easy way to view related items, through hyperlinks.
Hyperlinks in Introscope WebView allow you to jump quickly from one area to another.
Links in Webview can link to other Dashboards, or to web pages.
A user with Dashboard edit permission to the Introscope Workstation can set up links that
can be viewed in WebView Dashboards. For information on creating and editing custom
links, see the Introscope Administration Guide.
You can access links for a selected Dashboard object in the Console through the Links
menu, or by clicking the default link:
To access Links menu links, right-click on the Dashboard object, select Links
submenu, then select the link. The Links menu shows available links for the
objectif no links are available, the Links menu is disabled.
Default links are visible when you mouse-over a Dashboard object:
For text blocks: If the text block has a default link defined for it, an underline
appears when you hover over it, and the cursor changes to a hand.
For other Dashboard objects: If the object has a default link defined, the mouse
pointer changes to a hand.
To use a default link, click on the dashboard object with the linkfor example:
Viewing Metric Data in the Investigator
The Investigator shows data collected by Agents in a hierarchical tree structure. The
Investigator tree is refreshed every 15 seconds to show current Agent and Metric data.
Opening an Investigator Window
To open an Investigator window, click the Investigator tab at the top of the screen.
To open multiple Investigator windows right-click the Investigator tab and select Open
Link in New Window from the menu.
Expanding and Collapsing the Tree
A black filled dot to the left of a tree node indicates that it contains a collapsed level.
To expand a node, click
the filled black dot.
To collapse a node, click
the open black dot.
Viewing Metric Data in the Preview Pane
When you click a Metric in the Investigator tree, its information appears in the
Investigator Preview pane:
Viewing Automatic Filtered Views in the Preview Pane
When you select certain Resources in the Investigator, they automatically show Top Ten
Filtered Views of Metrics that match the Metric Grouping associated with the Resource.
These Metrics appear in a bar chart in the Investigator Preview pane. Some Resources
that automatically show Top Ten Matching Metrics are Servlets, JSP, EJBs and JDBC.
You can also view the response times of the top 10 called components of a selected
Servlet, EJB, or JSP.
Viewing Automatic Filtered Views in Investigator
The Investigator preview pane shows the automatic Top Ten matching Metrics for the
selected Resource.
To view automatic top ten Metrics for Resources, click a Resource that is a link
(underlined).
The top ten matches appear in the Investigator Preview pane in the Bar Chart.
Note: If fewer than ten components are being monitored under a resource, you see only
the bars that correspond to the monitored components.
Viewing Graph Details
You use Graph Details to identify Metrics in a data viewer in the Console or Investigator.
Note: You cannot view details for a Traffic Light viewer.
1. In the Preview pane, hover over the data viewer. Right-click, and select Details from
the context menu to open the Viewer Detail window.
2. The fully qualified names of all the Metrics displayed in the graph are shown, along
with the minimum, maximum, average, and last values of those Metrics.
Note: If the Metric name is truncated you can widen the Metric name column to see
the full name, or hover over the Metric name to open a pop-up box that shows
the full name.
WebView Data Viewers
Data Viewers are objects in the Investigator Preview pane or in a Dashboard in the
Console that show data from a managed application in a visual form. Data is displayed in
a Data Viewer type that corresponds to the type of Data.
Data Viewers in WebView can display data from a Metric, or from a Resource.
Data Viewer Types
Depending on the type of Metric or Element, Introscope can show the data in a Data
Viewer with these Data Viewer display types:
Graph Graphs plot values over time. In real-
time views, the Graph dynamically
displays the most recent time period
that fits in the Graph.
If the Graph displays an Alert, caution
and danger thresholds appear as
yellow and red lines, respectively.
You can change the scale of graph
charts while viewing live data, to see
data in a more readable viewsee
Changing the Scale of Graph
Charts, page 21.
Bar Chart Bar Charts display current data
values as horizontal bars.
The Bar Chart is the default view for
Top N Filtered Views.
If a bar chart is showing an Alert, the
bars will be either green, yellow or
red to correspond to Alert status.
The Bar Chart is available for live
data viewing only.
Graphic
Equalizer
Graphic equalizers show the current
value of the data, as well as recent
high levels.
A Graphic Equalizer can only display
data for a single Metric.
Note: The Graphic Equalizer viewer
type is only seen in a WebView
Console Dashboard.
Changing the Scale of Graph Charts
You can change the scale of graph charts while viewing live data in Introscope WebView,
to provide a more readable view. You change the scale of a chart by setting a minimum
and maximum value for the charts data axis.
Dial Meter Dial meters depict current data
values as positions on a half-round
dial.
Note: The dial meter viewer type is
only seen in a WebView Console
Dashboard.
String
Viewer
String Viewers can display a value as
a line of text. String Viewers allow
some values to display in a relatively
small space. You can also use a String
Viewer for simple values that do not
change, such as Launch Time or IP
Address.
Text Viewer Text viewers show the text for data
when new values are added to old
onesfor example, a system or
exception log.
Traffic Light A Traffic light shows the current
status of an Alert by lighting one of
three colored circles, that
corresponds to Alert conditions
defined in the Alert:
Green = status normal
Yellow = caution threshold was
crossed
Red = danger threshold was crossed
If the Alert has no data, no appears.
A Traffic light can also appear as a
single light.
Note: Traffic lights are only seen in
a WebView Console Dashboard.
The chart scaling feature is available only for graph charts in Live mode. It is not
available in Historical mode or for any other viewer type such as bar chart, top ten, or
string viewer.
Note: Scale changes that you make to a chart are temporarythe settings are not saved
with the dashboard. When you select a new dashboard or close the Console
window, Introscope discards the settings and returns to the scale options that
were applied when the dashboard was created.
To change the scale of a graph chart:
1. Select the chart in one of these ways:
Click on a chart to select it, then select Viewer > Scale options.
Right-click the chart and select Scale Options from the context menu.
The Data Options dialog box opens.
2. Enter the minimum and maximum values for the data axis of the graph.
For example, if the chart data values lie primarily between 150 and 700 but the chart
value axis shows 0-10,000, it might be helpful to set the scale Min value to 100 and
Max value to 1,000 for a better view of the relevant data.
Export Options
WebView offers several options for exporting data from a data viewer or Dashboard,
whether in the Investigator or Console:
Export data to CSV file
Copy SVG to clipboard
Export Data to CSV File
In WebView, you can export a snapshot of current data in a Data Viewer to a comma-
separated values (.csv) file for use laterfor example, you might want to analyze this
data in an external program. You can export data from all Data Viewer types except the
traffic light.
Setting the Auto Scale
Minimum and Maximum
default values provides
a more readable view
of charts in Live mode.
To export data from a Data Viewer:
1. Right-click the Data Viewer, and select View as CSV file from the context menu.
2. From the dialog box you can:
Click the Open button, to view the contents of the .csv file.
Note: Excel starts if it is the default program for .csv files.
Click Save, pick a name and location for the .csv file, and click Save.
Copy SVG To Clipboard
You can copy an entire Dashboard or Investigator Preview Pane Data Viewer to the
clipboard and then paste it into an e-mail, Word or other document.
To copy SVG to the clipboard:
1. Display the desired Investigator Preview Pane data viewer or Console Dashboard.
2. Hover your pointer over it, right-click, and select Copy SVG from the context menu.
3. Paste the clipboard contents:
In Microsoft Word, select Edit > Paste Special
Note: Do not use the regular Paste command in Microsoft Word, or only XML
data will be pasted into the document.
In any other program, use the Paste command.
Viewing Historical Data in WebView
As you monitor your managed application, live data views change continuously to show
you the most recent data. You can also select a range of time to view historical data, to
help you identify the time a problem occurred:
You can view live or
historical data in the
Console...
...and in the
Investigator.
Viewing Historical Data
To view historical data in the Console or the Investigator, you select a time range. When
you select a time range, Introscope immediately shows the data for that range.
To view historical data:
1. Select the metric or dashboard for which to view historical data.
2. Select a time range for the historical view from the Time Range drop-down menu.
3. Click Reset if you want to reset the end time of the range to the current time.
Defining a Custom Time Range
To define a custom time range to view historical data:
1. Select the metric or dashboard for which you want to see historical data.
2. Select Custom Range from the Time Range drop-down menu.
The Historical Range window opens:
3. Enter start and end dates and times for the historical view, and click Update.
Introscope shows the data for the custom range.
You can select a time range from the list, or select Custom Range to
define a range (see Defining a Custom Time Range, page 24).
3 Viewing and Tracing Transactions in WebView
You use the Introscope WebView Transaction Viewer to trace the activity of transactions
as they flow through a Java Virtual Machine. You can also query and view historical
transactions, and view any transactions that are currently being monitored by Agents.
This chapter includes these topics:
About the WebView Transaction Viewer, page 26
Querying Historical Data, page 26
Starting a New Transaction Trace Session, page 27
Viewing Current Transaction Traces, page 30
Viewing Transactions: Trace, Tree, Summary, and Details, page 31
Stopping and Restarting a Transaction Trace, page 33
Saving Transaction Trace Data as XML, page 34
About the WebView Transaction Viewer
You use the Transaction Viewer to:
Query and view historical datasee Querying Historical Data, page 26
Start a new transaction trace session to capture new data.
Tracing transactions helps you reduce the time to identify the problem component
in a transaction, by enabling you to trace the activity of transactions as they flow
through the boundaries of a Java Virtual Machine. See Starting a New Transaction
Trace Session, page 27.
View any transactions that are currently being monitored by Agentssee Viewing
Current Transaction Traces, page 30
Querying Historical Data
Transaction Viewer session results are automatically stored in the Transaction Event
Database. The Transaction Event database enables you to query the saved events for
traces matching certain criteria.
Note: Be sure that you run some Transaction Trace sessions before you use the
historical query, so that there is data to query.
The WebView Transaction Viewers historical query syntax enables a variety of searches.
You can:
query by specific fields: Domain, Agent, Host, Process, etc. (host:server3)
query by time: use "time:[YYYYMMDD TO YYYYMMDD]" to pick out specific dates,
or use "time:[YYYYMMDDHH TO YYYYMMDDHH]" to pick out a specific hour
Note: The smallest time period to search is by hour.
use wildcards: enter any fragment of a search term and the asterisk to find
anything that contains the search term
use boolean logic to combine search terms ("AND", "OR", "NOT" and "()"
groupings)
use remove from results: Use "+JDBC -CICS" to look for transactions with JDBC
but no CICS
To query historical data:
1. In Introscope WebView, click Transaction Viewer.
The Transaction Viewer opens:
2. Open the drop-down list and choose Historical Query.
3. In the Query field, enter the query terms, then click Go.
The Transaction Viewer shows the results of your query.
4. Select a transaction to open the component details pane.
The components pane opens when you select a transaction, and offers four views of
the transactions componentsSummary, Tree, Trace, and Transaction Details. See
Viewing Transactions: Trace, Tree, Summary, and Details, page 31.
Starting a New Transaction Trace Session
When you start a Transaction Trace session, you configure basic information about it:
the trace session time period (in minutes)during this period, all targeted Agents
collect and report Transaction Trace data.
which Agents to tracetransactions from one or more Agents, or all supported
Agents.
You can filter the transaction trace session to reduce the number of results returned and
thus lower the amount of overhead on your system. You can filter the session by:
threshold execution time (in seconds or milliseconds)
Choose Historical
Query from the
drop-down list...
...then enter query
terms and click Go.
The first time you select a transaction, the component details pane
opens to the Summary View tab. When you select a transaction that
has been opened before, it opens in the most recently selected view.
Selecting a
transaction...
...opens the
component
details pane.
specific values for transaction trace data typeUser ID, HTTP request headers,
request parameters, session attributes, session ID, username, URLs and URL
Query strings
Transactions that match your filter criteria appear in the Transaction Trace Viewer
window, and are saved in the Enterprise Manager.
Note: For detailed information about configuring the Agent profile to capture additional
transaction trace data, see the Introscope Workstation User Guide.
To start a new transaction trace:
2. Open the drop-down list and choose New Trace.
3. Choose a time range for the trace, or accept the default of All.
4. Click View to open the New Transaction Trace Session window.
5. Specify the trace parameters. You can run a basic trace, filter the trace by execution
time, or filter the trace by transaction trace data type.
To run a basic trace:
1. Type the length of time to run the trace in
the Run session for N minutes field.
2. Select the Agents to trace.
Trace all supported Agents traces all Agents that are currently connected and any
that connect during the session (supported for Agents version 4.x and higher.)
Trace selected Agents traces the Agents you select from the list (CTRL + click to
select multiple Agents)
4. Click OK to start tracing transactions.
As the trace runs, the results appear in the Transaction Viewer window:
To filter the trace by execution time:
To filter the trace by transaction trace data type:
1. Specify the length of time to run
and select the Agents to trace, as
for a basic query.
2. Check the Lasting longer than box.
3. Type a threshold execution time.
4. Select milliseconds or seconds from
the drop-down list.
Note: Threshold execution time must be a minimum of 1 millisecond. Note that
extremely low (less than 1 second) threshold traces can have a negative impact
on performance.
1. Check the second box in the
Trace Transactions section of
the window and choose a data type:
User ID, URL, URL Query, Session ID, Request Header,
Request Parameter, or Session Attribute.
If you choose a data type of Request Header,
Request Parameter or Session Attribute, enter a name
for the data type in the second field.
Note: This data type information is not available to be filtered
unless the Introscope Agent is configured to capture it. See
the Workstation User Guide for information on configuring the
Agent to capture additional information.
2. Choose a filter condition from the third fields drop-down
menu: equals, does not equal, contains, does not contain,
starts with, ends with, exists, or does not exist.
3. In the fourth field, enter a value for the specified data type.
If you chose the condition exists or does not exist, this field is
disabled.
The Transaction Viewer
lists transactions that
match your trace criteria.
Each row represents one
transaction trace.
The Transaction Viewer shows this information for each transaction:
5. Select a transaction to open the component details pane.
The components pane opens when you select a transaction, and offers four views of
the transactions componentsSummary, Tree, Trace, and Transaction Details. See
Viewing Transactions: Trace, Tree, Summary, and Details, page 31.
Viewing Current Transaction Traces
You can view any transactions that are currently being monitored by Agents:
The Transaction Viewer opens.
Type Specifies the type of information in the trace row, either transaction trace
(T), or error (E). Error data only appears if ErrorDetector is running.
Domain Domain to which the traced Agent is mapped
Host Host on which the traced Agent is running
Process Agent Process name
Agent Agent Name
Timestamp Start time, in the Agent machines system clock, of the invocation of the root
component
Duration Wall clock execution time of the root component
UserID The ID of the logged-in user that is running the transaction (if it is
configured and available)
The first time you select a transaction, the component details pane
opens to the Trace View tab. When you select a transaction that has
been opened before, it opens in the most recently selected view.
Selecting a
transaction...
...opens the
component
details pane.
2. Open the drop-down list to choose from current transactions.
3. Select a transaction and click View.
Viewing Transactions: Trace, Tree, Summary, and Details
When you select a transaction in the WebView Transaction Viewerfrom either the
results of a historical query or a transaction tracethe component details pane opens at
the bottom of the window. The components pane offers four views of the transactions
componentsTrace, Tree, Summary, and Transaction Details.
The first time you select a transaction, the components pane opens to the Trace View tab.
Transactions that have been opened before open in the most recently selected view.
The Transaction Trace View
Trace View shows the transaction graphically, and includes a zoom slider.
If you specified additional transaction trace information to be collected as described in the
Introscope Workstation User Guide, these details appear in the Component Details pane:
Key Appears In Value
User ID Servlet, JSP User ID of the user invoking the HTTP servlet request,
as determined by one of the standard mechanisms
defined in the Workstation User Guide.
Transactions that are currently being
monitored by Agents appear in this list.
The zoom slider is automatically set to the
lowest level of magnification. Use it to zoom
to a level high enough to view even the
shortest transaction components.
The Transaction Tree View
Tree View shows the transaction components hierarchically. You can hover your mouse
pointer over a component to open a tooltip that shows component details.
When you hover your mouse cursor over a component, these details appear:
URL Servlet, JSP URL passed through to the servlet or JSP, not including
the query string (text after the ? delimiter in the URL)
URL Query Servlet, JSP Portion of the URL that specifies query parameters in
the HTTP request (text after the ? delimiter in the URL)
Session ID Servlet, JSP The HTTP session ID associated with the servlet
request, if any.
Dynamic SQL Dynamic JDBC
Statements, when
SQL Agent is installed
Generalized dynamic SQL statement, as it would be
seen in the aggregate form in the SQL Agent
Callable SQL Callable JDBC
statements, when SQL
Agent is installed
Callable SQL (with the ? still present)
Prepared
SQL
Prepared JDBC
statements, when SQL
Agent is installed
Prepared SQL (with the ? still present)
Method Blamed Tracers
(everything but
servlets, JSPs and
JDBC statements)
Name of the traced method
Metric Path Full resource name of the component
Component Name Name of component (for example, myEJB, myServlet, loginServlet)
Component Type High-level component (for example, EJB, Servlet, JSP)
Duration Execution time (in milliseconds) of the selected component
Timestamp
(relative)
Start time (in Agent JVMs clock) of the invocation of the selected
component
Key Appears In Value
The Transaction Summary View
Summary View shows details of the Metrics that are included in a transaction.
The Transaction Details View
The Transaction Details pane shows details about the transaction itself.
Stopping and Restarting a Transaction Trace
To stop a running trace click Stop Trace. WebView disables the Stop Trace button
and shows the number identifier of the stopped trace in parentheses:
To restart a stopped trace, click Restart Trace. When you restart the trace, the
trace identifier number appears without the parentheses.
When you restart a trace, WebView resets the timeout to the time period you
specified, and continues to trace transactions in the targeted Agents, using the
original threshold criteria you specified.
You can restart a Transaction Trace session:
after a session has timed out
to restart a session you have stopped
to restart an in-progress session
Parameters Component parameters
% of total
transaction time
Percentage of total transaction time taken by the selected component
Saving Transaction Trace Data as XML
To save Transaction Trace data to an XML file:
1. In the Transaction Viewer, select a Transaction Trace to save. You can select multiple
traces using the CTRL + click keyboard command.
2. Click Save As to open the File Download dialog box.
3. You can open the file, or click Save to select a location and save the file.
This example shows a transaction opened as an XML file:
Index
C
charts, graph scaling 21
Console
opening 14
viewing data in 14
Console Lens 14
applying 14
clearing 15
D
Dashboards
accessing 14
through a bookmark 15
bookmarking 15
Data Viewer
Bar Chart 20
Dial Meter 21
Graph 20
Graphic Equalizer 20
String Viewer 21
Text Viewer 21
Traffic Light 21
types 20
E
Export Options
Copy SVG 23
Export to CSV 22
F
functions available 8
G
graph charts, scaling 21
H
historical data
querying 26
hyperlinks
from links menu 16
I
Interface 10
Console 11
Investigator 11
Investigator tree 12
Agent icon appearance 13
Agent, Resource and Metric appear-
ance in 14
Domains node 12
Metrics in 12
SuperDomain node 12
Preview pane 12
Investigator
navigation
expanding and collapsing Investigator
tree 17
opening 17
tree
expanding and collapsing 17
viewing Metric data in 17
L
logging out 14
O
overview 6
P
Preview pane
viewing automatic filtered views 18
viewing Metric data in 18
Q
querying historical data 26
R
restarting a trace 33
S
scaling graph charts 21
stopping a trace 33
summary view of transaction 33
T
trace view of transaction 31
tracing transactions
basic trace 28
filter by execution time 29
filter by trace data type 29
starting 27
transaction details view 33
transaction trace
basic 28
by execution time 29
details view 33
filter by data type 29
optional information collected 31
restarting a session 33
saving data as XML 34
starting 27
stopping a session 33
summary view 33
trace view 31
tree view 32
viewing current traces 30
Transaction View
component details 31
Transaction Viewer
about 25, 26
optional information collected 31
querying historical data 26
starting a transaction trace 27
summary view 33
trace information 30
trace view 31
tracing transactions 28
transaction details 33
tree view 32
viewing current traces 30
tree view of transaction 32
V
viewing data
in Console 14
viewing Metric data
in Investigator 17
in Preview pane 18
W
WebView and Workstation, compared 8
WebView in the Introscope deployment 7
X
XML
saving trace data as 34

Intro Scope Web View Guide

Transféré par

Informations du document

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

Intro Scope Web View Guide

Transféré par

Droits d'auteur :

Formats disponibles

WebView User Guide for

is a system management application created to help you manage Java

Vous aimerez peut-être aussi