User Interface Help IBM SmartCloud Monitoring - Application Insight SC27-5618-01

IBM SmartCloud Monitoring - Application Insight
User Interface Help
SC27-5618-01
IBM SmartCloud Monitoring - Application Insight
User Interface Help
SC27-5618-01
ii
IBM SmartCloud Monitoring - Application Insight: User Interface Help
SmartCloud Monitoring - Application Insight
Enterprises are increasingly moving to the cloud to accelerate time to market,
improve serviceability, and to reduce costs.
As a cloud consumer, you can use SmartCloud Monitoring - Application Insight to
monitor your cloud virtual machine applications to ensure optimal performance
and efficient use of resources.
Application Insight is able to scale up or down elastically in keeping with the
ability to grow and shrink, providing multi-tenant monitoring for most workload
deployments. The monitoring technology can be embedded in virtual machine base
images and initiated automatically when new workloads are deployed based on
those images.
Overview
Enterprises are increasingly moving to the cloud to accelerate time to market,
improve serviceability, and to reduce costs. Cloud computing consumers need to
monitor their applications and workloads and quickly recognize problems.
SmartCloud Monitoring - Application Insight is a lightweight monitoring solution
that is designed for short-term performance and availability analysis, independent
of the management infrastructure, yet providing for scalability.
The dashboard navigator is hierarchical in nature, giving a status overview of the
VMs that you own or have permission to see. To learn more about your monitored
resources, you can click a link in the Status Overview tab.
Consider, for example, that your application has slow response time. The issue is
revealed in the dashboard. Starting from the top, you can follow the problem
down to the source by clicking links and group widgets to discover the culprit,
such as high CPU usage on the VM due to an out-of-control process.
Go to IBM Service Management Connect to get usage tips and insightful
information from subject matter experts, ask questions on the forum, and see video
demonstrations: IBM SmartCloud® Monitoring - Application Insight
(https://www.ibm.com/developerworks/servicemanagement/apm/sim/
index.html). More information is available at IBM® Application Performance
Management > Application Monitoring (http://www-01.ibm.com/software/tivoli/
products/application-monitoring).
© Copyright IBM Corp. 2013
1
Figure 1. SmartCloud Monitoring - Application Insight users and cloud provider users. In this conceptual illustration, the
cloud consumers are operations, development operations, and line of business personnel. They might create their own
VM instances or request them. They can monitor their own workloads with the Application Insight dashboards.
Application Dashboard - Groups
After you select an application in the Application Dashboard, the groups that are
displayed include Users (if SmartCloud Application Performance Management for
Mobile Applications is installed), Transactions, and Components.
You can select a subgroup or an instance within a subgroup to display detailed
metrics.
End User Transactions KPIs
End User Transactions dashboards may be available in your installation. Use these
dashboards to understand the performance and availability of transaction requests,
applications, and servers in your environment.
End User Transactions summary dashboard
Use the End User Transactions Summary dashboard to analyze the performance
and availability of transaction requests in your environment.
Requests by Status group widget:
A bar chart showing the number of good, slow, and failed transactions per period
for the selected application.
The following table contains information about the key performance indicators in
this group widget.
2
IBM SmartCloud Monitoring - Application Insight: User Interface Help
KPI
Description
Derived from
Overall Volume
Shows the number of good (green), slow
(yellow), and failed (red) transactions per
period.
T5APPCS.SUCCREQ (Good),
T5APPCS.SLOWREQ (Slow),
T5APPCS.FAILREQ (Failed)
The status of the transaction is determined
by the Response Time Threshold:
v Good Requests The number of recorded
transactions that completed successfully,
and whose response time was less than the
Minimum Response Time Threshold (10
seconds).
v Slow Requests The number of recorded
transactions that completed successfully,
but whose response time was greater than
or equal to the Minimum Response Time
Threshold (10 seconds).
v Failed Requests The number of recorded
transactions that did not complete
correctly, or reported an error during the
monitoring interval.
Average Response Time group widget:
A line graph showing the average response time of transactions, in seconds, for the
selected application.
The following table contains information about the key performance indicators in
this group widget.
KPI
Description
Derived from
Average
Response Time
The average response time, in seconds, of the
transactions.
T5APPCS.OATIME
Transactions - Top 10 group widget:
A table showing the transactions of most interest in the selected application over
the last period.
The following table contains information about the key performance indicators in
this group widget.
KPI
Description
Derived from
Transaction
Name of the transaction
T5TXCS.TRANSACTN
Status
T5TXCS.PCGOOD
Overall status for the transaction based on the
response time of its subtransactions. If the
number of good subtransactions are less than
50%, the status for the transaction is "warning"
(yellow); if the number of good subtransactions
are less than 10%, the status of the transaction is
"critical" (red); otherwise the status is "good"
(green). If there are no subtransactions, the
status is "good".
SmartCloud Monitoring - Application Insight
3
KPI
Description
Derived from
Requests
Total number of transaction requests per period, T5TXCS.TOTREQ
summarized from all Web Response Time agents
Failed
Percentage of failed transactions in the current
period
T5TXCS.PCFAIL
Slow
Percentage of slow transactions in the current
period
T5TXCS.PCSLOW
Response Time Average response time, in seconds, of the
transactions in the current period
T5TXCS.OATIME
Timestamp
T5TXCS.TIMESTAMP
Time of collection of the summarized data
End User Transactions details dashboard
Use the End User Transactions Details dashboard to analyze the status of the
selected server, and the volume and overall status of transactions for the
applications on that server.
From this dashboard, select View Enclosing WebSphere Application Servers to
view a summary of all requests on the associated server, and all requests
associated with the transaction you selected. From that dashboard, you can drill
down further into the Application Performance Dashboards.
Transaction Requests by Status group widget:
A bar chart showing the number of good, slow, and failed subtransactions for the
selected transaction, at selected intervals.
The following table contains information about the key performance indicators
used in this group widget.
KPI
Description
Derived from
Transaction
Volume
Shows the number of good (green), slow
(yellow), and failed (red) subtransactions for the
selected transaction, over the last period.
T5TXCS.SUCCREQ (Good),
T5TXCS.SLOWREQ (Slow),
T5TXCS.FAILREQ (Failed)
The status of the subtransaction is determined by
the Response Time Threshold:
v Good Requests The number of recorded
subtransactions that completed successfully,
and whose response time was less than the
Minimum Response Time Threshold (10
seconds).
v Slow Requests The number of recorded
subtransactions that completed successfully,
but whose response time was greater than or
equal to the Minimum Response Time
Threshold (10 seconds).
v Failed Requests The number of recorded
subtransactions that either did not complete
correctly, or reported an error during the
monitoring interval.
4
IBM SmartCloud Monitoring - Application Insight: User Interface Help
Transaction Average Response Time group widget:
A line graph with the average response time of subtransactions for the selected
transaction, in seconds, over the period.
The following table contains information about the key performance indicators in
this group widget.
KPI
Description
Derived from
Average Response The average response time, in seconds, of the
Time
subtransactions, over the current period
T5TXCS.OATIME
Runs On group widget:
A table with summary information about the servers that host the selected
applications or web servers.
The following table contains information about the key performance indicators
used in this group widget.
KPI
Description
Derived from
Server
The name or IP address and port of the server
hosting the application or web server
T5TXCS.SERVER
Status
Overall status for the server based on the
T5TXCS.PCGOOD
response time of its transactions. If the number
of good transactions are less than 50%, the
status for the server is "warning" (yellow); if
the number of good transactions are less than
10%, the status of the server is "critical" (red);
otherwise the status is "good" (green). If there
are no transactions, the status is "unknown".
Requests
Total number of transactions for the server in
the current period
T5TXCS.TOTREQ
Failed
Percentage of failed transactions for the server
in the current period
T5TXCS.PCFAIL
Slow
Percentage of slow transactions for the server
in the current period
T5TXCS.PCSLOW
Response Time
Average response time, in seconds, of the
transactions for the server, in the current
period
T5TXCS.OATIME
Timestamp
Time of collection of the summarized data
T5TXCS.TIMESTAMP
Mobile Devices and Authenticated Users KPIs
Use Mobile Devices and Authenticated Users dashboards to understand the loads
created by mobile devices, and the loads for users. These dashboards are available
only when SmartCloud Monitoring - Application Insight V1.2 is installed as part of
SmartCloud Application Performance Management V7.7.0.1.
Mobile Devices Summary
Use the Mobile Devices summary dashboard to gain insight into users accessing
you application with a mobile device. View the load and response time for
different mobile operating systems.
SmartCloud Monitoring - Application Insight
5
Total Active Sessions group widget:
A line graph showing the number of active sessions serving mobile devices
compared to the total number of active sessions over the last period.
The following table contains information about the key performance indicators in
this group widget.
KPI
Description
Derived from
Active sessions
The number of open sessions serving mobile
devices compared to the number of active general
sessions. If there are no mobile users, a single line
showing the active general sessions only is
displayed.
T5USRSS.NUMSESSION,
T5APPCS.NUMSESS
The information is aggregated for the application.
Tip: All sessions marked as active are counted. Sessions where the user is no
longer using the application, but has not logged out and the session has not yet
timed out, are included in the count.
Active Sessions by Mobile OS - Top 5 group widget:
A bar chart showing the operating systems with the most active sessions.
The following table contains information about the key performance indicators in
this group widget.
KPI
Description
Derived from
Active sessions
The number of active sessions serving mobile
devices for an operating system
T5USRSS.NUMSESSION
The information is aggregated for the application and for each mobile operating
system.
Tip: All sessions marked as active are counted. Sessions where the user is no
longer using the application, but has not logged out and the session has not yet
timed out, are included in the count.
Session Duration by Mobile OS - Top 5 group widget:
A bar chart showing the average duration of sessions, in seconds, serving mobile
devices running different operating systems.
The following table contains information about the key performance indicators in
this group widget.
KPI
Description
Derived from
Session duration
Average session duration, in seconds, that is,
T5USRSS.SESSDURATN
how long a session is running, for users running
different mobile operating systems.
The information is aggregated for the application and for each mobile operating
system.
6
IBM SmartCloud Monitoring - Application Insight: User Interface Help
Requests by Mobile OS - Top 5 group widget:
A bar chart showing the operating systems with the most requests.
The following table contains information about the key performance indicators in
this group widget.
KPI
Description
Derived from
Number of
requests
The number of requests processed during the
last period for the different mobile operating
systems
T5USRSS.TOTREQ
The information is aggregated for the application and for each mobile operating
system.
Percentage Failures by Mobile OS - Top 5 group widget:
A bar chart showing the operating systems with the highest number of failed
requests.
The following table contains information about the key performance indicators in
this group widget.
KPI
Description
Derived from
Request status
Shows the number of good (green), slow
(yellow), and failed (red) requests for each
mobile operating system.
The status of the request is determined by the
Response Time Threshold:
v Good Requests The number of requests that
completed successfully, and whose response
time was less than the Minimum Response
Time Threshold (10 seconds).
T5USRSS.PCGOOD
(Good)
T5USRSS.PCSLOW
(Slow)
T5USRSS.PCFAIL
(Failed)
v Slow Requests The number of requests that
completed successfully, but whose response
time was greater than or equal to the
Minimum Response Time Threshold (10
seconds).
v Failed Requests The number of requests that
either did not complete correctly or reported
an error during the monitoring interval.
The information is aggregated for the application and for each mobile operating
system.
Mobile Devices Details
Use the Mobile Devices details dashboard to analyze the load created by mobile
devices running a particular operating system and the server performance on this
load.
Device Active Sessions group widget:
A line graph showing the number of active sessions serving mobile devices
running this operating system.
The following table contains information about the key performance indicators in
this group widget.
SmartCloud Monitoring - Application Insight
7
KPI
Description
Derived from
Active sessions
The number of open sessions serving mobile
devices running this operating system
T5USRSS.NUMSESSION
The information is aggregated for the application and the mobile operating system.
Tip: All sessions marked as active are counted. Sessions where the user is no
longer using the application, but has not logged out and the session has not yet
timed out, are included in the count.
Device Average Session Duration group widget:
A line graph showing the average session duration (in seconds) for sessions
serving mobile devices running this operating system.
The following table contains information about the key performance indicators in
this group widget.
KPI
Description
Derived from
Session duration
Average session duration in seconds, that is,
how long a session is running, for mobile
devices running this operating system.
T5USRSS.SESSDURATN
The information is aggregated for the application and for each mobile operating
system.
Device Requests by Status group widget:
A bar chart showing the number of good, slow, and failed requests for mobile
devices running this operating system.
The following table contains information about the key performance indicators in
this group widget.
KPI
Description
Derived from
Request status
T5USRSS.SUCCREQ (Good),
Shows the number of good (green), slow
(yellow), and failed (red) requests at various T5USRSS.SLOWREQ (Slow),
time points for mobile devices running this T5USRSS.FAILREQ (Failed)
operating systems.
The status of the request is determined by
the Response Time Threshold:
v Good Requests The number of requests
that completed successfully, and whose
response time was less than the Minimum
Response Time Threshold (10 seconds).
v Slow Requests The number of requests
that completed successfully, but whose
response time was greater than or equal
to the Minimum Response Time
Threshold (10 seconds).
v Failed Requests The number of requests
that either did not complete correctly or
reported an error during the monitoring
interval.
The information is aggregated for the application and the mobile operating system.
8
IBM SmartCloud Monitoring - Application Insight: User Interface Help
Device Response Time group widget:
A line graph showing the minimum, average, and maximum response time for
requests serving mobile devices running this operating system.
The following table contains information about the key performance indicators in
this group widget.
KPI
Description
Derived from
Minimum
response time
The response time for the request that was
processed fastest
T5USRSS.MINRTT
Average
response time
The average response time for requests
T5USRSS.OATIME
Maximum
response time
The response time for the request that was
processed slowest
T5USRSS.MAXRTT
The information is aggregated for the application and the mobile operating system.
Authenticated Users Summary
Use the Authenticated Users summary dashboard to view who is currently using
the application, and which users are experiencing problems.
Logged-in Users group widget:
A line graph showing the fluctuation in mobile user numbers over the last period.
The following table contains information about the key performance indicators in
this group widget.
KPI
Description
Derived from
Number of
users
The number of users who are logged in.
T5APPCS.TOTUSERS
The information is aggregated for the application.
Active Sessions by User - Top 5 group widget:
A bar chart showing the users who have the highest number of active sessions.
The following table contains information about the key performance indicators in
this group widget.
KPI
Description
Derived from
Active sessions
The number of open sessions serving the
user
T5URSS.NUMSESSION
The information is aggregated for the application and for each user.
Tip: All sessions marked as active are counted. Sessions where the user is no
longer using the application, but has not logged out and the session has not yet
timed out, are included in the count.
Session Duration by User - Top 5 group widget:
A bar chart showing the users with the longest average active sessions, in seconds.
SmartCloud Monitoring - Application Insight
9
The following table contains information about the key performance indicators in
this group widget.
KPI
Description
Derived from
Session duration
Average session duration in seconds, that
is, how long a session is running, for this
user.
T5USRSS.SESSDURATN
The information is aggregated for the application and for each user.
Tip: All sessions marked as active are counted. Sessions where the user is no
longer using the application, but has not logged out and the session has not yet
timed out, are included in the count.
Requests by User - Top 5 group widget:
A bar chart showing the users who have generated the largest number of requests.
The following table contains information about the key performance indicators in
this group widget.
KPI
Description
Derived from
Number of
requests
The number of requests processed during
the period for the user
T5USRSS.TOTREQ
The information is aggregated for the application and for each user.
Percentage Failures by User - Top 5 group widget:
A bar chart showing the users with the highest percentage of failed requests. The
number of good and slow requests are also shown for these users.
The following table contains information about the key performance indicators in
this group widget.
KPI
Description
Derived from
Request status
Shows the number of good (green), slow
(yellow), and failed (red) requests for
different users.
T5USRSS.PCGOOD (Good),
T5USRSS.PCSLOW (Slow),
T5USRSS.PCFAIL (Failed)
The status of the request is determined by
the Response Time Threshold:
v Good Requests The number of requests
that completed successfully, and whose
response time was less than the
Minimum Response Time Threshold (10
seconds).
v Slow Requests The number of requests
that completed successfully, but whose
response time was greater than or equal
to the Minimum Response Time
Threshold (10 seconds).
v Failed Requests The number of
requests that either did not complete
correctly, or reported an error during
the monitoring interval.
The information is aggregated for the application and for each user.
10
IBM SmartCloud Monitoring - Application Insight: User Interface Help
Authenticated Users Details
Use the Authenticated Users details dashboard to view load and response time for
each user to discover who is having problems.
User Active Sessions group widget:
A line graph showing the number of active sessions serving this user over time.
The following table contains information about the key performance indicators in
this group widget.
KPI
Description
Derived from
Active
sessions
The number of open sessions serving this
user
T5USRSS.NUMSESSION
The information is aggregated for the application and for the user.
Tip: All sessions marked as active are counted. Sessions where the user is no
longer using the application, but has not logged out and the session has not yet
timed out, are included in the count.
User Average Session Duration group widget:
A line graph showing the average session duration, in seconds, for sessions serving
this user.
The following table contains information about the key performance indicators in
this group widget.
KPI
Description
Derived from
Session duration
Average session duration, that is, how long a
session is running, for this user.
T5USRSS.SESSDURATN
The information is aggregated for the application and for the user.
User Requests by Status group widget:
A bar chart showing the number of good, slow, and failed requests for this user
over time.
The following table contains information about the key performance indicators in
this group widget.
SmartCloud Monitoring - Application Insight
11
KPI
Description
Derived from
Request status
T5USRSS.SUCCREQ (Good),
Shows the number of good (green), slow
(yellow), and failed (red) requests at various T5USRSS.SLOWREQ (Slow),
T5USRSS.FAILREQ (Failed)
time points for this user.
The status of the request is determined by
the Response Time Threshold:
v Good Requests The number of requests
that completed successfully, and whose
response time was less than the Minimum
Response Time Threshold (10 seconds).
v Slow Requests The number of requests
that completed successfully, but whose
response time was greater than or equal
to the Minimum Response Time
Threshold (10 seconds).
v Failed Requests The number of requests
that either did not complete correctly or
reported an error during the monitoring
interval.
The information is aggregated for the application and for the user.
User Response Time group widget:
A line graph showing the minimum, average, and maximum response time, in
seconds, for requests serving this user during the last period.
The following table contains information about the key performance indicators in
this group widget.
KPI
Description
Derived from
Minimum
response time
The response time for the request that was
processed fastest
T5USRSS.MINRTT
Average
response time
The average response time for requests
T5USRSS.OATIME
Maximum
response time
The response time for the request that was
processed slowest
T5USRSS.MAXRTT
The information is aggregated for the application and for the user.
Usage Statistics
The Usage Statistics dashboard presents the average, maximum, and minimum
number of open VMs reporting to the Monitoring Infrastructure Node over time.
These values can help you analyze VM usage for different time periods.
At the beginning of the next hour after the infrastructure node is operational,
usage statistics are saved to an hourly log. These hourly logs hold the maximum
number of open VMs per hour. At the beginning of the next day, statistics begin to
accumulate in a daily log. The log stores the average, maximum, and minimum
number of open VMs for each day.
12
IBM SmartCloud Monitoring - Application Insight: User Interface Help
As an example, if you installed the infrastructure node on Monday, August 26, at
7:30 AM, you would start seeing statistics from the hourly log at 9:00 AM, when
the first complete hour was logged, and you would start seeing statistics from the
daily log on Tuesday at 00:01 AM.
Reporting > Usage Statistics, initially, a clustered bar chart is
After you click
displayed. The chart shows the aggregate monthly usage statistics for the present
year. The chart shows one column cluster per month since the infrastructure node
was started. Each cluster contains the average, maximum, and minimum number
of open VMs for that month. You can change the report period and you can view
the statistics in a table instead of in a graph.
Report Period
The default time period is This Year, and you can select other periods.
The unit value of each bar or table row is one hour for Today, one day for
This Week and This Month, and one month for This Quarter, Last 12
Months, Last 18 Months, and Last 24 Months.
The chart displays the statistics that are available in the database for the
selected time period. If not enough data was collected for the period you
select, the chart does not render and an error message is displayed; select a
shorter period of time.
Graph and table statistics
Except for Today, which shows only the maximum number of VMs that
were open each hour, you get a three-bar grouping showing the average,
maximum, and minimum number of VMs that were open during that time
period.
Click the Table button to see a row for each time period and a cell for each
statistic.
and type the beginning of
v Click inside the filter text box
the value to filter the table by. As you type, the table rows that do not fit
the criteria are filtered out and the Total is updated for the number of
or press the
rows found. Click the “x” in the filter box
Backspace key to clear the filter/
v Click inside a column heading to sort by that column. Click the same
column heading again to switch between ascending and descending sort
order.
Summary statistics
A footer is displayed at the bottom of the dashboard showing summary
values for the selected report period: Average for entire period is an
average of the average columns that are currently displayed; Maximum for
entire period is the highest number overall; and Minimum for entire
period is the lowest number overall.
Restriction: In this milestone, the average for the entire period is an
average-of-averages, which is only an approximation of the true average.
Examples
The first chart plots the maximum values Today from midnight to 5:00 AM.
The second chart plots This Month with average, maximum, and minimum
values for the first seven days:
SmartCloud Monitoring - Application Insight
13
Threshold Manager
Use the Threshold Manager to review the predefined thresholds for a data type
and to create and edit thresholds.
Thresholds are used to compare the sampled value of an attribute with the value
set in the threshold. If the sampled value satisfies the comparison, an event is
opened. The event closes automatically when the threshold comparison is no
longer true.
System Configuration > Threshold Manager, the page is
After you click
displayed with a table of the thresholds that were defined for the selected data
type. Here you can add, edit and delete thresholds.
Select data source type
The data types that display when you click the list box are those that are
included in your managed environment. Select the data type for which you
want to create or view thresholds.
Existing Thresholds
This table lists all the thresholds that were created for the selected data
type.
New opens the Threshold Editor for defining a threshold for the
selected data type.
Select a threshold and click
editing the definition.
Edit to open the Threshold Editor for
Select a threshold that you no longer want and click
14
IBM SmartCloud Monitoring - Application Insight: User Interface Help
Delete.
After you click
New or select a threshold and click
Editor is displayed with the following fields:
Edit, the Threshold
Name Enter a name for the threshold that users can see in the dashboards. The
name must begin with a letter and can be up to 31 letters, numbers and
underscores, such as “Average_Processor_Speed_Warning”. All thresholds
must have unique names.
Category
Select the category for grouping events in the OS Event Summary table in
the Group Details dashboard: CPU, Memory, Disk, Network, or Other. The
category affects the event aggregation for the OS status.
Description
Optional. A description is useful for recording the purpose of the threshold
that users can see in the Threshold Manager.
Severity
Select the appropriate event severity from the list:
Minor
Warning, or
Unknown.
Fatal,
Critical,
Interval
Enter or select the time to wait between taking data samples in HHMMSS
format, such as 00 15 00 for fifteen minutes. For sampled-event thresholds,
the minimum interval is 000030 (30 seconds) and the maximum is 235959
(23 hours, 59 minutes, and 59 seconds).
A value of 000000 (six zeroes) indicates a pure event threshold. Pure events
are unsolicited notifications. Thresholds for pure events have no sampling
interval, thus there is no constant metric that can be monitored for current
values.
Required consecutive samples
Specify how many consecutive threshold samples must evaluate to true
before an event is generated. This means, for any threshold with a setting
of 1 and a sample that evaluates to true, an event is generated
immediately; a setting of 2 means that 2 consecutive threshold samples
must evaluate to true before an event is opened.
Data set
Select the data set for the type of data to be sampled. The metrics available
for inclusion in the condition are from the chosen data set. If the threshold
has multiple conditions, they must all be from the same data set.
Logical Operator
You can ignore this field if your threshold has only one condition. If you
are measuring multiple conditions, select one of the following operators
New to add the next condition:
before clicking
And (&) if the previous condition and the next condition must be met
for the threshold to be breached
Or (|) if either of them can be met for the threshold to be breached
A mix of logical operators is not supported; use either all And operators or
all Or operators. The threshold can have up to 9 conditions when the Or
operator is used; up to 10 conditions when the And operator is used.
Conditions
The threshold definition can logically include multiple simultaneous
thresholds or conditions.
SmartCloud Monitoring - Application Insight
15
Click
New to add a condition. Select a condition and click
Edit to
modify the expression, or click
Delete to remove the expression.
New or
Edit, complete the fields in the Add
After you click
Condition dialog box that opens:
Metric Select the metric that you want to compare in this condition.
Operator
Select the relational operator for the type of comparison: Equal,
Not Equal, Greater than, Greater than or Equal, Less than, or
Less than or equal.
Value Enter the value to compare using the format that is allowed for the
metric, such as 20 for 20% or 120 for 2 minutes.
After you click Save, the threshold is applied to all managed systems of the same
data type.
You can control event behavior and event forwarding through the Event Managerr
options, as described in “Advanced Configuration” on page 26.
Historical Data Configuration
Your environment already has historical data configurations for key data sets that
are shown in the dashboards. You can add more historical data configurations for
other data sets.
System Configuration > Historical Data Configuration, the
After you click
page is displayed for you to see and work with historical data configurations.
Select data source type
The data types that display when you click the list box are those that are
included in your managed environment. Select the data type for which you
want to view or configure historical data collection.
Existing Historical Data Configurations
This table lists all the historical data configurations that were created for
the selected data type. The data sets are prefixed with the data type code,
such as KLZ for Linux OS and WRT for Response Time.
New opens the Add Historical Record dialog box for the selected data
type.
Edit to open the Edit
Select a historical data configuration and click
Historical Record for editing the data collection definition.
Select a historical data configuration that you no longer want and click
Delete.
New or select a historical data configuration and click
Edit,
After you click
the Add Historical Record or Edit Historical Record dialog box is displayed with
the following fields:
Data Set
Select a data set for which you want to collect historical data. The data sets
available are for the chosen data type.
16
IBM SmartCloud Monitoring - Application Insight: User Interface Help
Interval
Enter the data sampling frequency, from 5 to 60 minutes. Historical data
samples are saved at the monitored resource for retrieval into the
dashboards.
Retain Enter the number of hours to keep the historical data samples for, from 2
to 72 hours.
After you click OK, the historical data configuration is saved to the data set list
and historical data begins to be collected from all data sources of the same data
type.
Agent Configuration
Use the Agent Configuration tabbed page for configuring the monitoring agents
that you installed.
System Configuration > Agent Configuration from the
After you click
navigation bar, a tabbed dashboard is displayed with one tab for each configurable
monitoring agent. The table shows a row of configuration information, such as the
name and IP address for each managed system.
Actions
Use the Actions options to enable or disable tracing for the selected
managed system.
Column resize
Drag a column heading border to the right or left to adjust the column
width.
Column sort
Click inside a column heading to sort by that column. Click the same
column heading again to switch between ascending and descending sort
order.
Table filter
and type the beginning of
Click inside the filter text box
the value to filter the table by. As you type, the table rows that do not fit
the criteria are filtered out and the row Total is updated for the number of
rows found.
Click the “x” in the filter box
clear the filter.
or press the Backspace key to
Managing applications
The Application Performance Dashboard navigator has tools that you can use to
add or edit applications and their supporting software resources, or to remove an
application.
When you add an application, you can create a new application and apply the
managed resources that are available, or select one from any discovered
applications.
Before you begin
You must have administrator role privileges to use the
navigator.
tools in the
SmartCloud Monitoring - Application Insight
17
Note: A “My Components” application in the navigator contains the managed
systems that were discovered by the Monitoring Infrastructure Node. The managed
systems have no status and the application cannot be edited or deleted.
About this task
Complete the following steps to add, edit, or remove an application from the
Application Performance Dashboard.
Procedure
1. If the Application Performance Dashboard is not displayed, select it from the
Performance Menu or, if you are in the Getting Started page, click
View application status.
2. In the Applications section of the navigator, add, remove, or modify an
application:
. The Add Application window is displayed.
v To add an application, click
v To modify an application, select it and click
. The Edit Application
window is displayed.
. After you click OK to
v To remove an application, select it and click
confirm, the application is deleted. This method does not uninstall the
supporting components; only their appearance in the Application
Dashboard.
3. Click Read to open the Read Application window with a list of any
discovered applications, and take one or more of the following steps.
v Click Detail to see the components of an application.
v Select the radio button for the application you want to use, and click Save.
The Read Application window closes, the source repository is displayed in
the Application read from: field, and the components are listed in
Application components.
v Click Cancel to close the window without making a choice.
A discovered application can save you the effort of defining an application.
4. Enter or edit the name of your application in the Application name field. You
can add a description in the Description field. Do not use the & * % ? < > { } !
" ' symbols in the name or description:
5. In the Template field, keep the Custom Application template or select a
list and click Save. Any associated component
different template from the
types and instances are shown in the Application components list. If you are
editing an application, you cannot specify a different template, except for
Custom Application.
Note: The Monitoring Agent for Ruby shows two Application components:
Ruby Applications, for monitoring all the Ruby applications on the managed
system; and Enable Ruby App Situations, for monitoring thresholds that have
been defined for instance (subnode) level attributes. For a typical setup, select
Ruby Applications. If you have multiple Ruby applications on the same
system and want to have thresholds that monitor a subset, select Enable Ruby
, and select the application instance or instances that
App Situations, click
you want to monitor and view events from. After selecting the Ruby
Applications option, select the Enable Ruby App Situations option for every
Ruby application that you want to monitor and see events from in the Events
page.
18
IBM SmartCloud Monitoring - Application Insight: User Interface Help
6. If you want to add components and instances to the application, take the
following steps.
and, in the Select Component window that opens, select a
a. Click
component from the list. The Component Editor is displayed.
Toolbar to search for
b. Click an instance to select it or use the
instances that contain the text in the search text box, select all instances, or
clear all instances. You can also edit the component name, which is used as
the display name in the navigator for this application.
c. Click Add to add the instance or instances, and click Back.
d. You can select another component to add instances to, or click Close.
The Application components list is updated with the new component names.
A number in parentheses after the name indicates how many instances are
associated with the component.
7. If you want to edit a component name or change the instance that is
associated with it, select the component from the Application components list
:
and click
a. To associate a different instance with the component, search for and select
the instance that you want.
b. To change the component name that is used as the display name in the
navigator for this application, edit the Component name field.
c.
8.
9.
10.
11.
Click Save.
The Application components list is updated with the changes that you made.
If you want to remove a component or instance from the application, select it
. Click OK to confirm that you want to remove it.
and click
If other instances are related to the components in the Application
components list, a blue button that shows the number of related instances is
displayed and you can take the following steps:
to see the related instances in the Updated Details window. A bar
a. Click
is shown for each type of update, with the name of the instance below the
bar. For example, if one of the components was removed, it shows below
the “Deleted components” bar.
b. Select one or more instances and click Save to update the Application
resources list.
Select from the Roles to access this application list and click Save. Only users
with the assigned roles can view the application data in the dashboard.
When you are finished creating or editing the application, close the
application editor by clicking Save to save your changes, or Cancel to undo
the changes.
Results
The new or edited application is displayed in the Application Dashboard and the
navigator Applications section. When the application is selected, the components
are displayed in the Groups section. If you deleted an application, it is no longer
displayed.
SmartCloud Monitoring - Application Insight
19
Access Credentials
If any managed systems are not returning monitoring data, the user credentials
might have changed. Use the Access Credentials page to update the user name and
password that are required for logging in to the system where the monitoring
agent is installed.
System Configuration > Access Credentials, a list of systems
After you click
that don't have valid user credentials associated with the system where one or
more monitoring agents is installed is displayed. This can happen if you change
the password of the VM or computer being monitored.
Lock indicator and enter valid user credentials that the Monitoring
v Click the
Infrastructure Node can use to access the system for monitoring.
After you click OK, the credentials you entered are used to access the system the
indicator is removed if the
next time the managed resource is polled, and the
credentials are valid.
See also the Default VM Credentials, Default Linux VM Credentials, and Default
Windows VM Credentials options in “Advanced Configuration” on page 26.
Configuration Wizard
Use the Configuration Wizard to edit the connection settings between the
Monitoring Infrastructure Node and your host provider.
You can further configure your environment settings through the Advanced
Configuration page.
Configuring the infrastructure node for SmartCloud
Provisioning
After installing the Monitoring Infrastructure Node on your deployed VM, you
must configure the infrastructure node for communication with the SmartCloud
Provisioning service delivery platform.
The Configuration Wizard starts automatically the first time you log on to the
Application Performance Management UI after installation. Thereafter, you can
start the wizard whenever you have configuration changes.
Before you begin
Initial configuration of the infrastructure node involves establishing key credentials
with the web service host, starting the database, and initializing the configuration
database. Most of the configuration is automatic after the private key has been
established.
Have at hand the information that is required from SmartCloud Provisioning for
configuring the Monitoring Infrastructure Node: the SmartCloud Provisioning web
host IP address, your access ID, and the private key that is associated with your
ID.
Procedure
1. If the Configuration Wizard is not open, click
Configuration Wizard.
20
IBM SmartCloud Monitoring - Application Insight: User Interface Help
System Configuration >
2. For the service delivery platform, select the SmartCloud Provisioning option
and click Next.
3. For the SmartCloud Provisioning platform configuration, complete the
following fields and click Next:
a. Access ID is shown on the SmartCloud Provisioning Home page after you
sign in.
b. Web Service Host is the IP address of the SmartCloud Provisioning host.
c. Web Service Port is set to the default 5678.
d. Service Region is the region hosted by SmartCloud Provisioning, and is set
to “query” by default.
e. Private Key is pasted from SmartCloud Provisioning Home page by
clicking Show Access Key, copying the entire Private Key text including the
-BEGIN- and -END- lines, and pasting here.
4. When a message asks if you want to set up event notification email, click Yes
to open the Advanced Configuration page to establish event notification now,
or click No.
5. If you clicked Yes to set up event notification email or event forwarding to an
event integration facility (EIF), complete the Event Manager fields.
v For forwarding to one or more EIF receivers, you must know the IP address
(IPv4 only) or fully qualified host name of the EIF receiver. Use a comma (,)
to separate multiple receivers.
v For sending event notification emails, you must have a configured SMTP
server, the credentials to communicate with it, and the proper port
configured on any firewalls that reside between the cloud and your SMTP
server. Use a comma (,) to separate multiple target email addresses.
v For more information, see the Event Manager options in “Advanced
Configuration” on page 26.
6. Optional. In the Default tab, enter the default user ID and password for the
most commonly used monitoring agent in your workload:
a. User ID, such as root.
b. Password, such as passw0rd.
c. Confirm Password.
d. Repeat for the Linux and Windows tabs if you want to enter a default user
ID and password for the monitoring agents that run on those operating
systems.
Results
After you click Finish, the configuration parameters are updated on the
infrastructure node.
What to do next
v Click
Performance > Application Performance Dashboard and add a new
application as described in “Managing applications” on page 17.
System Configuration > Threshold Manager to see and work with
v Click
thresholds that test for certain conditions and raise an event when the threshold
has been breached.
System Configuration > Historical Data Configuration to see and
v Click
work with historical data configurations for data sets that you want to see
historical data from.
SmartCloud Monitoring - Application Insight
21
Configuring the infrastructure node for Amazon EC2
After installing the Monitoring Infrastructure Node on your deployed VM, you
must configure the infrastructure node for communication with the Amazon Elastic
Compute Cloud service delivery platform.
The configuration wizard starts automatically the first time you log on to the
Application Performance Management UI after installation. Thereafter, you can
start the wizard whenever you have configuration changes.
Before you begin
Log on to your Amazon Web Service Management Account (http://
aws.amazon.com/console) and gather the following information for entry in step 3:
v Your Access Key ID and Secret Access Key as described in Getting Your AWS
Access Keys (http://docs.aws.amazon.com/ses/latest/DeveloperGuide/get-awskeys.html).
v Your entry point URL, which is based on your Region (shown in the Navigation
area) and listed in the table at Regions and Endpoints - Amazon EC2
(http://docs.amazonwebservices.com/general/latest/gr/rande.html#ec2_region).
Review the Prerequisites (http://eden1.tivlab.austin.ibm.com:2215/help/topic/
com.ibm.scmai.doc_1.2/install/scmai_prerequisites.htm) and Dependencies
(http://eden1.tivlab.austin.ibm.com:2215/help/topic/com.ibm.scmai.doc_1.2/
install/scmai_install_dependencies.htm) for the supported platforms and
requirements for infrastructure nodes.
Procedure
1. If the Configuration Wizard is not open, click
Configuration Wizard.
System Configuration >
2. For the service delivery platform, select the Amazon Elastic Compute Cloud
option and click Next.
3. For the Amazon EC2 platform configuration, complete the following fields and
click Next:
a. Access Key ID is the Amazon Web Services Access Key ID for accessing
AWS SES.
b. Secret Access Key is the Secret Access Key for accessing AWS SES.
c. Confirm Secret Access Key is the Secret Access Key, which you enter a
second time to ensure that you typed the key correctly.
d. Region Endpoint URL is the URL that represents the entry point for AWS
and is based on your Region, such as http://ec2.us-west-1.amazonaws.com
for US West (Northern California) Region.
4. When a message asks if you want to set up event notification email, click Yes
to open the Advanced Configuration page to establish event notification now,
or click No.
5. If you clicked Yes to set up event notification email or event forwarding to an
event integration facility (EIF), complete the Event Manager fields.
v For forwarding to one or more EIF receivers, you must know the IP address
(IPv4 only) or fully qualified host name of the EIF receiver. Use a comma (,)
to separate multiple receivers.
v For sending event notification emails, you must have a configured SMTP
server, the credentials to communicate with it, and the proper port
22
IBM SmartCloud Monitoring - Application Insight: User Interface Help
configured on any firewalls that reside between the cloud and your SMTP
server. Use a comma (,) to separate multiple target email addresses.
v For more information, see the Event Manager options in “Advanced
Configuration” on page 26.
6. Optional. In the Default tab, enter the default user ID and password for the
most commonly used monitoring agent in your workload:
a.
b.
c.
d.
User ID, such as root.
Password, such as passw0rd.
Confirm Password.
Repeat for the Linux and Windows tabs if you want to enter a default user
ID and password for the monitoring agents that run on those operating
systems.
Results
After you click Finish, the configuration parameters are updated on the
infrastructure node.
What to do next
v Click
Performance > Application Performance Dashboard and add a new
application as described in “Managing applications” on page 17.
System Configuration > Threshold Manager to see and work with
v Click
thresholds that test for certain conditions and raise an event when the threshold
has been breached.
System Configuration > Historical Data Configuration to see and
v Click
work with historical data configurations for data sets that you want to see
historical data from.
Configuring the infrastructure node for VMware
After installing the Monitoring Infrastructure Node on your deployed VM, you
must configure the infrastructure node for communication with the VMware
service delivery platform.
The configuration wizard starts automatically the first time you log on to the
Application Performance Management UI after installation. Thereafter, you can
start the wizard whenever you have configuration changes.
Procedure
1. If the Configuration Wizard is not open, click
Configuration Wizard.
System Configuration >
2. For the service delivery platform, select the VMware Virtual Center option and
click Next.
3. For the VMware platform configuration, complete the following fields and click
Next:
a. User ID is the VMware login ID.
b. Password is the VMware user password.
c. Confirm Password is the VMware user password, which you enter a second
time to ensure that it was typed correctly.
d. Host Name is the fully qualified host name or IP address of the VMware
service host.
e. Port Number is set to the default 80.
SmartCloud Monitoring - Application Insight
23
f. Use SSL is set to false by default, and the Keystore and Validate certificates
fields are disabled. Select true if Secure Socket Layer will be used for
communications with the VMware service host.
g. Keystore File is set to /opt/ibm/ccm/CCM-Certs/ccm.truststore by default.
If Use SSL is set to true, enter the full path to the keystore file that contains
the set of certificates that are trusted by SmartCloud Monitoring Application Insight.
h. Keystore Password and Keystore Confirm Password are disabled because
the password has already been established. If Use SSL is set to true, these
fields are enabled for you to set the password.
i. Validate Certificates is set to false by default. If Use SSL is set to true,this
field is enabled and you can set it to true if you want the SSL connection
certificates to be validated against the certificates imported into the
infrastructure node truststore. For details about importing certificates, see
Enabling certificate validation for communication with VMware
(http://eden1.tivlab.austin.ibm.com:2215/help/topic/
com.ibm.scmai.doc_1.2/install/scmai_installvmware_certificate.htm).
4. When a message asks if you want to set up event notification email, click Yes
to open the Advanced Configuration page to establish event notification now,
or click No.
5. If you clicked Yes to set up event notification email or event forwarding to an
event integration facility (EIF), complete the Event Manager fields.
v For forwarding to one or more EIF receivers, you must know the IP address
(IPv4 only) or fully qualified host name of the EIF receiver. Use a comma (,)
to separate multiple receivers.
v For sending event notification emails, you must have a configured SMTP
server, the credentials to communicate with it, and the proper port
configured on any firewalls that reside between the cloud and your SMTP
server. Use a comma (,) to separate multiple target email addresses.
v For more information, see the Event Manager options in “Advanced
Configuration” on page 26.
6. Optional. In the Default tab, enter the default user ID and password for the
most commonly used monitoring agent in your workload:
a. User ID, such as root.
b. Password, such as passw0rd.
c. Confirm Password.
d. Repeat for the Linux and Windows tabs if you want to enter a default user
ID and password for the monitoring agents that run on those operating
systems.
Results
After you click Finish, the configuration parameters are updated on the
infrastructure node.
What to do next
v Click
Performance > Application Performance Dashboard and add a new
application as described in “Managing applications” on page 17.
System Configuration > Threshold Manager to see and work with
v Click
thresholds that test for certain conditions and raise an event when the threshold
has been breached.
24
IBM SmartCloud Monitoring - Application Insight: User Interface Help
v Click
System Configuration > Historical Data Configuration to see and
work with historical data configurations for data sets that you want to see
historical data from.
Configuring the infrastructure node for other systems
You can use the Other discovery capability to discover and monitor any set of VMs
or stand-alone systems.
Instead of using a cloud provider service to retrieve information about the systems
that belong to a user, you can create a list of systems to be monitored in a text file.
The Other discovery plug-in monitors the text file periodically for changes in the
system information.
Before you begin
Install SmartCloud Monitoring - Application Insight in your provisioning
environment, such as VMware, and begin monitoring your VMs.
Procedure
1. Create the list of system addresses:
a. On the Monitoring Infrastructure Node VM, create a text file (such as
ips.txt) in the /opt/ibm/ccm/ directory.
b. Enter each VM address that you want to monitor on a new line with the
following syntax:
ipaddress hostname description
where:
ipaddress is the IP address of the system to be monitored, such as 9.3.2.1
hostname is the host name of the same system, such as
myAPMUI.tivlab.raleigh.ibm.com
description is the name or description of the system to be monitored, such
as My MIN. You can include spaces; quotation marks are not necessary. Lines
that start with a number sign (#) are considered commentary and ignored.
Empty lines are also ignored.
c. After you are finished creating the list, save and close the text file. Make a
note of the path and file name for setting in step 4
In the following text file example, the Monitoring Infrastructure Node
addresses are for individually monitoring the MySQL data source and the
Linux OS data source; each consumer VM address is added for monitoring the
MySQL data source and the Linux OS data source:
# Entries for MIN MySQL
9.77.33.11 v1234fdf602 My Infrastructure Node
9.77.33.22 v2345efe713 MySQL CVM
# Entries for MIN Linux OSAgent
9.77.33.33 v1234fdf602 My Infrastructure Node
9.77.33.44 v2345efe713 My Linux OSAgent CVM
2. If the Configuration Wizard does not open automatically, click
System
Configuration > Configuration Wizard.
3. Select the Other option and click Next.
4. Edit the path for the text file that you created earlier; click Next.
5. When a message asks if you want to set up event notification email, click Yes
to open the Advanced Configuration page to establish event notification now,
or click No.
SmartCloud Monitoring - Application Insight
25
6. If you clicked Yes to set up event notification email or event forwarding to an
event integration facility (EIF), complete the Event Manager fields.
v For forwarding to one or more EIF receivers, you must know the IP address
(IPv4 only) or fully qualified host name of the EIF receiver. Use a comma (,)
to separate multiple receivers.
v For sending event notification emails, you must have a configured SMTP
server, the credentials to communicate with it, and the proper port
configured on any firewalls that reside between the cloud and your SMTP
server. Use a comma (,) to separate multiple target email addresses.
v For more information, see the Event Manager options in “Advanced
Configuration.”
7. Optional. In the Default tab, enter the default user ID and password for the
most commonly used monitoring agent in your workload:
a. User ID, such as root.
b. Password, such as passw0rd.
c. Confirm Password.
d. Repeat for the Linux and Windows tabs if you want to enter a default user
ID and password for the monitoring agents that run on those operating
systems.
Results
The SDP adapter Other plug-in on the infrastructure node uses the address file to
locate the managed systems, maintains the monitoring agents, and gathers data for
display in the Application Performance Dashboard.
Advanced Configuration
Initial Monitoring Infrastructure Node configuration is done in the Configuration
Wizard.
Use the Advanced Configuration page to control communications settings and
advanced features such as event forwarding.
Agent Service Interface
The settings here are required information that is used by the infrastructure
node to configure communications with the monitoring agents.
v Polling Interval controls the frequency, in minutes, for checking that a
monitoring agent is active. Default: 1 minute.
v Missed Poll Limit, in an IBM Application Performance Management
(SaaS) environment, is the number of times that a monitoring agent does
not respond to a polling event before it is considered to be offline.
Default: 5 intervals.
v Port (HTTP) is the HTTP port used to communicate with monitoring
agents. Default: 51920.
v Secure Port (HTTPS) is the HTTPS port used to communicate with
monitoring agents. Default: 53661.
v Protocol is the default networking protocol to use for communicating
with the monitoring agents. Default: http.
Agent Central Configuration
26
IBM SmartCloud Monitoring - Application Insight: User Interface Help
v Refresh Interval controls the frequency, in minutes, that the monitoring
agents use to query configuration details from the infrastructure node.
Default: 5 minutes.
Host Name Override is an optional override for the host name or IP
address of the Central Configuration Server if the value of the
infrastructure node is not correct.
v Protocol establishes whether HTTP or HTTPS is the protocol to
communicate with the monitoring agent. Default: HTTPS.
v
Trace
The trace log component that is used to gather data about the performance
of the Application Insight system.
v Package Level Trace String A regular expression string describing the
classes to trace at a specified JLog level. Default: /com/ibm/tivoli/ccm/
config\\.*:ERROR.
v Trace Level The level of detail for logging trace entries. The possible
values are, from lowest level to most detailed: ERROR, DEBUG_MIN,
DEBUG_MID and DEBUG_MAX. Higher levels give you more detailed
information, which is useful for investigating any problems or errors
that occur. Default: ERROR.
v Maximum Log Files determines the number of log files to use before
wrapping the log entries. After the maximum is reached, the oldest log
file is replaced by the newest. Default: 5 files.
v Maximum File Size sets the maximum size of each log file in bytes.
Default: 5000000 bytes (5 MB).
Elasticity
Elasticity is the dynamic creation of additional Monitoring Infrastructure
Node instances when the number of VMs is higher than can be optimally
managed by the existing infrastructure node. Likewise, when an
infrastructure node is no longer needed because of a reduction in
monitored VMs, it is deleted. The settings here determine whether to
enable elasticity. When elasticity is enabled, additional infrastructure node
instances are created from the master infrastructure node image.
Note: Elasticity is not available on Amazon EC2, nor is it available for the
trial version of SmartCloud Monitoring - Application Insight. You can
enable elastic mode after purchasing a license.
v Mode determines the elasticity functionality. Default: DISABLED.
DISABLED means that no infrastructure node image is captured for
creating new infrastructure node instances after the threshold number of
VMs is reached.
ENABLED uses the VM that the elasticity SDP adapter determines is the
master infrastructure node to create additional instances from.
In VMware environments, the infrastructure node is cloned rather than a
new instance being created.
v Image Check Interval is used when Mode is set to ENABLED. It is the
frequency for checking if the new image that is being instantiated from
the master infrastructure node is ready for use. Default: 5 minutes.
v Image Capture Interval is required when Mode is set to ENABLED. It is
the number of hours to wait before requesting a new image capture if
the previous image was not captured successfully. Default: 1 hour.
v Elastic Node Check Interval determines the maximum number of hours
to wait for the requested infrastructure node to be started. Default: 1
hour.
SmartCloud Monitoring - Application Insight
27
v Monitoring Infrastructure Node Count determines the maximum
number of elastic nodes that the master infrastructure node can create.
Default: 2 elastic nodes (total of 3 infrastructure nodes counting the
master infrastructure node).
v Monitoring Infrastructure Node Resource Count determines the
maximum number of resources that an infrastructure node can monitor
before a new infrastructure node instance is created. Default: 500
managed resources.
v Maximum Threshold sets the percentage of the infrastructure node
resource count for indicating that the infrastructure node is reaching the
maximum number of monitored resources and needs to expand. Default:
90%.
v Minimum Threshold sets the percentage of the infrastructure node
resource count for indicating that the infrastructure node is reaching the
minimum number of monitored resources and needs to contract. Default:
10%.
The master infrastructure node running in elastic mode relies on subnet
multicasts to discover the elastic infrastructure nodes that it creates. For
this discovery functionality to be operational, you must configure the
network interfaces of the master infrastructure node VM in the following
manner:
1. Configure the VM IP address on the subnet where elasticity is running
as DHCP so that the VMs launched from the source master
infrastructure node do not have the same fixed IP address.
2. If the Master Fabric Node VM is configured with multiple network
interfaces, ensure that the network interface associated with the subnet
where elasticity is running is defined as eth0.
Otherwise, when the elasticity thresholds are reached and the master
infrastructure node starts a new elastic infrastructure node to redistribute
the resources load, the elastic node starts as the master, preventing the
infrastructure node from expanding.
Note: An attempt to clone the infrastructure node VM or to capture an
image of it (or both) while elasticity is enabled, generates the VM or image
with elasticity enabled. Thus, the generated VM or image acts as an elastic
node when deployed.
Event Manager
The Event Manager controls the flow through (forwarding to
Netcool/OMNIbus Probe for Tivoli® EIF and Simple Mail Transfer
Protocol) and the storage of received events.
v EIF Port is the port to use for Event Integration Facility operations.
Default: 5151.
v Event Cache Time determines the number of hours that events are
retained in the local cache, up to 96 hours. If the Event list is very long,
consider reducing the number of hours that are kept. Or, if you want to
see events over a weekend period, increase the number of hours.
Default: 24 hours.
v Pure Event Close Time determines how long to leave a pure event open
before closing it. Default: 24 hours.
v EIF Event Target(s) specifies the list of host names or IP addresses to
which all received Event Integration Facility events are forwarded. For
example, if you are forwarding events to the Netcool/OMNIbus Probe
28
IBM SmartCloud Monitoring - Application Insight: User Interface Help
for Tivoli EIF, enter the fully qualified host name or IP address of the
computer where the probe is installed. Separate each host name with a
comma (,), such as 9.87.65.111,9.12.34.115,myhostname.en.ibm.com.
IPv6 addresses are not supported for EIF transmission.
v Master Reset Event controls whether to send a master reset event to
clear previously received events. Default: True.
v Target Email Addresses specifies the email addresses that events are
forwarded to. Separate each address with a comma (,), such as
[email protected],[email protected],[email protected].
v Email Subject Line is the text to use in the subject line of every
forwarded SMTP email event. Default: SCM-AI Event.
v Sending Email Account is the email address to use when sending an
SMTP email event.
v Sending Email Account Password is the password associated with the
sending email account.
v SMTP Server Address is the fully qualified host name of the SMTP
server that is used for sending events as emails, such as smtp.gmail.com.
v Use SSL determines whether to use SSL as the SMTP (Simple Mail
Transfer Protocol) transport mechanism. Default: False.
v SMTP Port is the port number to use for sending SMTP email. Default:
25.
v SSL SMTP Port is the port number to use for sending SMTP email
using the SSL (Secure Socket Layer) protocol. Default: 465.
HTTP Interface
The HTTP interface is used with the Agent Service Interface to
communicate with the data sources. The time out values are controlled
here. If the connection times out frequently, consider increasing the time
out and retry values.
v Connection Timeout is the amount of time to wait before an HTTP
connection attempt fails. Default: 2 seconds.
v Read Timeout is the amount of time to wait before an HTTP read
attempt fails. Default: 4 seconds.
SDP Adapter
The Socket Direct Protocol (SDP) adapter is responsible for providing the
interface between SmartCloud Monitoring - Application Insight and the
underlying cloud platform.
v Discovery Plug-ins determines the plug-in to be started. Select the type
of discovery plug-in from the list: SCP, OTHER, VMWARE, AMAZON.
v Discovery Interval is the time to wait between discovery cycles. Default:
30 seconds.
SDP Adapter - Amazon Plug-in
An SDP adapter specifically to support integration with the Amazon EC2
environment.
v Amazon Access Key is the access key that is associated with the
Amazon Web Service account.
v Amazon Secret Key is the secret key that is associated with the Amazon
Web Service account.
v Amazon Regional End-point is the URL that represents the entry point
for the Amazon Web Service.
SmartCloud Monitoring - Application Insight
29
SDP Adapter - Other Plug-in
In an environment where you know the identity of the resources that you
want to monitor, you can provide the host names and IP addresses in a file
that is used by the Monitoring Infrastructure Node for discovery.
v File Name is the fully-qualified path and name of the text file that
contains the resource identifiers. For more information, see “Configuring
the infrastructure node for other systems” on page 25. Default:
/opt/ibm/ccm/ips.txt.
SDP Adapter - SCP Plug-in
A SmartCloud Provisioning plug-in that provides support for the IBM
SmartCloud Provisioning environment.
v Access ID is the user ID that is used for SmartCloud Provisioning
authentication.
v SCP Web Service Host is the SmartCloud Provisioning Web Service host
name.
v SCP Web Service Port is the SmartCloud Provisioning Web Service port.
Default: 5678.
v SCP Service Region determines the region that defines the SmartCloud
Provisioning service type. Default: query.
v Private Key is the text version of the private key. Example:
-----BEGIN RSA PRIVATE KEY----MIIBOwIBAAJBAMT4+BqTONg6w94VB1YHRTr4TIa9u9nX5ng/
FmupfpGTrseS0W6aLTNSQLqmPMzumilEt6Zml6c04kRX6lrR8NUCAwEAAQJBAK
ssVaf6kubOQtLnYWWwkchKaW6ayfnpNv7+jERpmnV05CS1Pk5Kqxa3MEIwQz
vGHC3QSabqef95TJxOgYhBv6ECIQDr8mjucvFFjOvTlyK+oMMQtgvevgM4zp
PviWQNHuGfnQIhANW2lA6TtuxBbdxufcX+EGD0n+ex96ik7l5YZELA1/yZ
AiEAurbMHtZK4/
UOshSJ5Dyn4NOPNSc8uXmQTCB3UoK7nWkCIFLvlMuHZZCP36uQsXy
ZmQ+XP0ryFLM8tkikstv47JjZAiA2WQBTwZi3FVjlUyEeck2iXSf
+Duky4S9LNahCVOz1Vg==
-----END RSA PRIVATE KEY----v SCP Requests Timeout is the number of seconds to wait before a
request to SmartCloud Provisioning times out. Default: 30 seconds.
SDP Adapter - VMware Plug-in
An SDP adapter that provides support for the VMware environment.
v Virtual Center User Name is a user ID with sufficient privileges to
collect monitoring data.
v Virtual Center Password is the password for the Virtual Center User
Name.
v Virtual Center Host is the Virtual Center host name.
v Virtual Center Port is the Virtual Center port. Default: 80 when SSL is
disabled; 443 when SSL is enabled.
v Use SSL determines whether to use an SSL connection to the Virtual
Center. Default: False.
v Validate Certificates determines whether certificate host names must be
validated. Default: False.
Truststore
The truststore is the internal security key repository.
v Java Keystore File is the fully-qualified path of the keystore file
containing the collection of certificates trusted by this client. Default:
/opt/ibm/ccm/CCM-Certs/ccm.truststore.
30
IBM SmartCloud Monitoring - Application Insight: User Interface Help
v Java Keystore File Password is the password to access the keystore file
that contains the collection of certificates trusted by this client.
Default VM Credentials
The default operating system credentials that are used to attempt access to
the managed data source for collecting data.
v Default User ID is the user ID to be tried for all monitoring agents that
are used to collect data. Default: root.
v Default Password is the password to be tried for all monitoring agents
that are used to collect data. Default: passw0rd.
If you have the Linux and Windows default credentials set, the Monitoring
Infrastructure Node determines which credentials to use for accessing a
monitoring agent by the OS agent that is installed on that managed
system. If, however, no OS agent is installed on the managed system, the
main default user credentials are used.
If the default user credentials are not valid for a particular managed
system, use the Access Credentials page to enter the correct credentials for
that managed system. For more information, see “Access Credentials” on
page 20.
Default Linux VM Credentials
The default operating system credentials that are used to attempt access to
the managed data sources running on Linux for collecting data.
If the Default VM Credentials are set for Linux, you don't need to set them
here.
v Default User ID is the user ID to be tried for all monitoring agents that
are used to collect data.
v Default Password is the password to be tried for all monitoring agents
that are used to collect data.
Default Windows VM Credentials
The default operating system credentials that are used to attempt access to
the managed data sources running on Windows for collecting data.
v Default User ID is the user ID to be tried for all monitoring agents that
are used to collect data.
v Default Password is the password to be tried for all monitoring agents
that are used to collect data.
SmartCloud Monitoring - Application Insight
31
32
IBM SmartCloud Monitoring - Application Insight: User Interface Help
Privacy policy considerations
IBM Software products, including software as a service solutions, (“Software
Offerings”) may use cookies or other technologies to collect product usage
information, to help improve the end user experience, to tailor interactions with
the end user or for other purposes. In many cases no personally identifiable
information is collected by the Software Offerings. Some of our Software Offerings
can help enable you to collect personally identifiable information. If this Software
Offering uses cookies to collect personally identifiable information, specific
information about this offering’s use of cookies is set forth below.
Depending upon the configurations deployed, this Software Offering may use
session cookies that collect each user’s user name for purposes of session
management, authentication, and single sign-on configuration. These cookies can
be disabled, but disabling them will also likely eliminate the functionality they
enable.
If the configurations deployed for this Software Offering provide you as customer
the ability to collect personally identifiable information from end users via cookies
and other technologies, you should seek your own legal advice about any laws
applicable to such data collection, including any requirements for notice and
consent.
For more information about the use of various technologies, including cookies, for
these purposes, See IBM’s Privacy Policy at http://www.ibm.com/privacy and
IBM’s Online Privacy Statement at http://www.ibm.com/privacy/details the
section entitled “Cookies, Web Beacons and Other Technologies” and the “IBM
Software Products and Software-as-a-Service Privacy Statement” at
http://www.ibm.com/software/info/product-privacy.
© Copyright IBM Corp. 2013
33
34
IBM SmartCloud Monitoring - Application Insight: User Interface Help
Accessibility
Accessibility features help users with physical disabilities, such as restricted
mobility or limited vision, to use software products successfully. SmartCloud
Monitoring - Application Insight supports a command prompt interface for
installation and a web-based interface for configuration and usage. Product
functionality and accessibility features vary according to the interface.
The major accessibility features in this product enable users in the following ways:
v Use assistive technologies, such as screen-reader software and digital speech
synthesizer, to hear what is displayed on the screen. Consult the product
documentation of the assistive technology for details on using those technologies
with this product.
v Operate specific or equivalent features using only the keyboard.
v
Magnify what is displayed on the screen.
In addition, the product documentation was modified to include the following
features to aid accessibility:
v All documentation is available in both HTML and convertible PDF formats to
give the maximum opportunity for users to apply screen-reader software.
v All images in the documentation are provided with alternative text so that users
with vision impairments can understand the contents of the images.
Application Insight and its related publications, are accessibility-enabled. For more
information about the accessibility features of the information center, see
Accessibility and keyboard shortcuts in the information center.
Interface information
The interface offers the greatest range of functionality, but is not entirely accessible.
Navigating the interface using the keyboard
Standard shortcut and accelerator keys are used by the product and are
documented by the operating system. See the documentation provided by your
operating system for more information.
Magnifying what is displayed on the screen
You can enlarge information on the product windows using facilities provided by
the operating systems on which the product is run. For example, in a Microsoft
Windows environment, you can lower the resolution of the screen to enlarge the
font sizes of the text on the screen. See the documentation provided by your
operating system for more information.
IBM and accessibility
See the IBM Human Ability and Accessibility Center for more information about
the commitment that IBM has to accessibility.
© Copyright IBM Corp. 2013
35
36
IBM SmartCloud Monitoring - Application Insight: User Interface Help
Notices
This information was developed for products and services offered in the U.S.A.
IBM may not offer the products, services, or features discussed in this document in
other countries. Consult your local IBM representative for information on the
products and services currently available in your area. Any reference to an IBM
product, program, or service is not intended to state or imply that only that IBM
product, program, or service may be used. Any functionally equivalent product,
program, or service that does not infringe any IBM intellectual property right may
be used instead. However, it is the user's responsibility to evaluate and verify the
operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not give you
any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785 U.S.A.
For license inquiries regarding double-byte (DBCS) information, contact the IBM
Intellectual Property Department in your country or send inquiries, in writing, to:
Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan, Ltd.
19-21, Nihonbashi-Hakozakicho, Chuo-ku
Tokyo 103-8510, Japan
The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law :
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS
PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS
FOR A PARTICULAR PURPOSE.
Some states do not allow disclaimer of express or implied warranties in certain
transactions, therefore, this statement might not apply to you.
This information could include technical inaccuracies or typographical errors.
Changes are periodically made to the information herein; these changes will be
incorporated in new editions of the publication. IBM may make improvements
and/or changes in the product(s) and/or the program(s) described in this
publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for
convenience only and do not in any manner serve as an endorsement of those Web
sites. The materials at those Web sites are not part of the materials for this IBM
product and use of those Web sites is at your own risk.
© Copyright IBM Corp. 2013
37
IBM may use or distribute any of the information you supply in any way it
believes appropriate without incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose
of enabling: (i) the exchange of information between independently created
programs and other programs (including this one) and (ii) the mutual use of the
information which has been exchanged, should contact:
IBM Corporation
2Z4A/101
11400 Burnet Road
Austin, TX 78758 U.S.A.
Such information may be available, subject to appropriate terms and conditions,
including in some cases payment of a fee.
The licensed program described in this document and all licensed material
available for it are provided by IBM under terms of the IBM Customer Agreement,
IBM International Program License Agreement or any equivalent agreement
between us.
Any performance data contained herein was determined in a controlled
environment. Therefore, the results obtained in other operating environments may
vary significantly. Some measurements may have been made on development-level
systems and there is no guarantee that these measurements will be the same on
generally available systems. Furthermore, some measurement may have been
estimated through extrapolation. Actual results may vary. Users of this document
should verify the applicable data for their specific environment.
Information concerning non-IBM products was obtained from the suppliers of
those products, their published announcements or other publicly available sources.
IBM has not tested those products and cannot confirm the accuracy of
performance, compatibility or any other claims related to non-IBM products.
Questions on the capabilities of non-IBM products should be addressed to the
suppliers of those products.
All statements regarding IBM's future direction or intent are subject to change or
withdrawal without notice, and represent goals and objectives only.
This information is for planning purposes only. The information herein is subject to
change before the products described become available.
This information contains examples of data and reports used in daily business
operations. To illustrate them as completely as possible, the examples include the
names of individuals, companies, brands, and products. All of these names are
fictitious and any similarity to the names and addresses used by an actual business
enterprise is entirely coincidental.
COPYRIGHT LICENSE:
38
IBM SmartCloud Monitoring - Application Insight: User Interface Help
Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of
International Business Machines Corp., registered in many jurisdictions worldwide.
Other product and service names might be trademarks of IBM or other companies.
A current list of IBM trademarks is available on the web at “Copyright and
trademark information” at www.ibm.com/legal/copytrade.shtml.
Adobe, Acrobat, PostScript and all Adobe-based trademarks are either registered
trademarks or trademarks of Adobe Systems Incorporated in the United States,
other countries, or both.
IT Infrastructure Library is a registered trademark of the Central Computer and
Telecommunications Agency which is now part of the Office of Government
Commerce.
Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo,
Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or
registered trademarks of Intel Corporation or its subsidiaries in the United States
and other countries.
Linux is a trademark of Linus Torvalds in the United States, other countries, or
both.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of
Microsoft Corporation in the United States, other countries, or both.
ITIL is a registered trademark, and a registered community trademark of The
Minister for the Cabinet Office, and is registered in the U.S. Patent and Trademark
Office.
UNIX is a registered trademark of The Open Group in the United States and other
countries.
Java and all Java-based trademarks and logos are trademarks or registered
trademarks of Oracle and/or its affiliates.
Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the
United States, other countries, or both and is used under license therefrom.
Linear Tape-Open, LTO, the LTO Logo, Ultrium, and the Ultrium logo are
trademarks of HP, IBM Corp. and Quantum in the U.S. and other countries.
Notices
39
40
IBM SmartCloud Monitoring - Application Insight: User Interface Help
Index
A
Access Credentials page 20
accessibility features 35
Active Sessions by Mobile OS - Top 5
group widget 6
Active Sessions by User - Top 5 group
widget 9
advanced configuration 26
agent
configuration 17
agent service interface 26
Amazon EC2
configuring 22
SDP adapter 29
applications 17
Authenticated Users 5
Authenticated Users Details
dashboard 11
Authenticated Users Summary
dashboard 9
Average Response Time group widget 3
events (continued)
thresholds for 14
port (continued)
53661 26
5678 20, 30
80 23, 30
infrastructure node 23
port configuration 26
privacy policy 33
H
historical data
configuration 16
HTTP interface 29
R
I
infrastructure node
configuring Amazon EC2
configuring SmartCloud
Provisioning 20
configuring VMware 23
22
L
Logged-in Users group widget
9
C
M
configuration
advanced 26
agent 17
historical data 16
thresholds 14
cookies 33
copyright 37
managing applications 17
Mobile Devices 5
Mobile Devices Details dashboard 7
Mobile Devices Summary dashboard 6
monitoring agent
default user 31
monitoring agents
See also data sources
user ID for accessing 20
Monitoring Infrastructure Node
configuring other discovery 25
D
dashboard
usage statistics 13
dashboards
Authenticated Users 5
Mobile Devices 5
data sources
port 26
Device Active Sessions group widget 7
Device Average Session Duration group
widget 8
Device Requests by Status group
widget 8
Device Response Time group widget 9
N
notices
37
O
other discovery
configuring 25
overview 1
P
E
email configuration 28
End User Transactions Details 2, 4
End User Transactions Summary 2
error log
See trace log
event integration facility 28
event manager 28
events
flow and storage configuration 28
© Copyright IBM Corp. 2013
Percentage Failures by Mobile OS - Top 5
group widget 7
Percentage Failures by User - Top 5
group widget 10
polling interval 26
port
25 28
443 30
465 28
5151 28
51920 26
refresh interval 26
Requests by Mobile OS - Top 5 group
widget 7
Requests by Status group widget 2
Requests by User - Top 5 group
widget 10
Runs On group widget 5
S
SDP adapter 29
security
Java keystore 30
truststore 30
Session Duration by Mobile OS - Top 5
group widget 6
Session Duration by User - Top 5 group
widget 10
SmartCloud Provisioning
configuring 20
SDP adapter 30
SMTP 28
SSL 28
T
thresholds
configuration 14
Tivoli monitoring agents
See data sources
Total Active Sessions group widget 6
trace log 27
trademarks 39
Transaction Average Response Time
group widget 5
Transaction Requests by Status group
widget 4
Transactions - Top 10 group widget 3
U
usage statistics 13
User Active Sessions group widget 11
User Average Session Duration group
widget 11
user ID 20, 31
User Requests by Status group
widget 11
User Response Time group widget 12
41
V
VMware
configuring 23
SDP adapter 30
W
widgets
Active Sessions by Mobile OS - Top 5
group 6
Active Sessions by User - Top 5
group 9
Average Response Time group 3
Device Active Sessions group 7
Device Average Session Duration
group 8
Device Requests by Status group 8
Device Response Time group 9
Logged-in Users group 9
Percentage Failures by Mobile OS Top 5 group 7
Percentage Failures by User - Top 5
group 10
Requests by Mobile OS - Top 5
group 7
Requests by Status group 2
Requests by User - Top 5 group 10
Runs On group 5
Session Duration by Mobile OS - Top
5 group 6
Session Duration by User - Top 5
group 10
Total Active Sessions group 6
Transaction Average Response Time
group 5
Transaction Requests by Status
group 4
Transactions - Top 10 group 3
User Active Sessions group 11
User Average Session Duration
group 11
User Requests by Status group 11
User Response Time group 12
42
IBM SmartCloud Monitoring - Application Insight: User Interface Help
Printed in USA
SC27-5618-01