Use the tacmd suggestBaseline command to
calculate a baseline (situation override) value by using one of several
statistical functions for a situation attribute based on historical
data from the Tivoli® Data
Warehouse.
Note:
If you want to use the current tacmd
tepsLogin values for user name, password, and server host name,
do not enter any of these options for the suggestBaseline command.
If you specify values for some, but not all of these options, you
are prompted to specify the user name and password if they are missing.
Note:
The managed system specified with the -m|--system
option must be online in order to run the command.
Note:
For a managed system group, the overrides are only
applied to members of the list that are override-eligible. Overrides
are not distributed to ineligible managed systems.
tacmd suggestBaseline
{-s|--situation} SITNAME
{-m|--system} SYSTEM|SYSTEM_LIST
{-p|--predicate} PREDICATE
{-f|--function} STATISTICAL_FUNCTION
{-d|--startdata} START_TIMESTAMP
{-e|--enddata} END_TIMESTAMP
[{-k|--key} KEY_CONDITION ...]
[{-x|--xmlfile} XMLFILE]
[{-u|--userid} TEPS_USERID]
[{-w|--password} TEPS_PASSWORD]
[{-h|--tepshostname} TEPS_HOSTNAME]
[{-c|--calendarentry} CALENDAR_ENTRY]
where:
- -s|--situation
- Specifies the situation to calculate the baseline value and
set the overrides for. If you include either the & character or
the < character in the situation name, you must quote the name,
for example "abc&def"or "abc<def".
- -m|--system
- The name of the managed system or managed system group to calculate
the baseline value and set the overrides for. Historical data results
from the warehouse used for statistical calculations are restricted
to values recorded for the managed system or managed systems specified.
- -c|--calendarentry
- Specifies the name of the calendar entry that defines the time
period when the override is active. If one or more calendar entries
are entered, historical data results from the warehouse are filtered
such that only the results that fall within each calendar entry are
used to calculate the baseline value. A separate baseline value is
calculated for each calendar entry.
- -d|--startdata
- Specifies the starting time from which historical data from
the warehouse will be used. Historical results queried from the warehouse
are bounded by the start and end times. The start time value is specified
as a timestamp in the format CYYMMDDHHmmSS or CYYMMDDHHmmSSsss, where:
- C=the century identifier (use 1 for year 2000 and later, 0 for
earlier)
- YY=the year (for example, '08' for 2008)
- MM=the month (for example, '01' for January, or '12' for December)
- DD=the day of the month (for example,. '06' for the 6th, or '31'
for the 31st)
- HH=the hour of the day (for example, '08' for 8 A.M. or '17' for
5 P.M.)
- mm=the minute of the hour (for example, '00' for 'on the hour',
'30', and so on.)
- SS=the second (for example, '01' for one second past the minute)
- sss=milliseconds (for example, '500' for half a second). This
value is optional.
- -e|--enddata
- Specifies the ending time from which historical data from the
warehouse will be used. Historical results queried from the warehouse
are bounded by the start and end times. The start time value is specified
as a timestamp in the format CYYMMDDHHmmSS or CYYMMDDHHmmSSsss, where:
- C=the century identifier (use 1 for year 2000 and later, 0 for
earlier)
- YY=the year (for example, '08' for 2008)
- MM=the month (for example, '01' for January, or '12' for December)
- DD=the day of the month (for example,. '06' for the 6th, or '31'
for the 31st)
- HH=the hour of the day (for example, '08' for 8 A.M. or '17' for
5 P.M.)
- mm=the minute of the hour (for example, '00' for 'on the hour',
'30', and so on.)
- SS=the second (for example, '01' for one second past the minute)
- sss=milliseconds (for example, '500' for half a second). This
value is optional.
- -f|--function
- Specifies the statistical function which is used to calculate
baseline values for the historical data queried from the warehouse.
The statistical function is specified in the format:
{ mode | percent NUM | avg[{+|-}NUM] | min[{+|-}NUM] | max[{+|-}NUM] }
where:
min[{+|-}NUM] : minimum value +/- NUM percent of the value
max[{+|-}NUM] : maximum value +/- NUM percent of the value
avg[{+|-}NUM] : average value +/- NUM standard deviations
percent NUM : value for the NUM percentile
mode : most frequently observed value
When the mode
calculation yields multiple results and an output xml file has been
specified by using the -x|--xmlfile option, the first result will
be used by the acceptBaseline command for the
purposes of setting the override value in the xml file.
- -p|--predicate
- Specifies the situation formula predicate for which the baseline
value is calculated. The predicate must be enclosed in double quotation
marks and entered in the format "ATTRIBUTE OPERATOR VALUE"
with spaces between ATTRIBUTE, OPERATOR, and VALUE. The predicate
OPERATOR must be one of the following: "EQ", "NE", "GT", "LT", "GE",
or "LE". Historical data results from the warehouse used for
statistical calculations is restricted to values recorded for the
attribute specified by this predicate.
The attribute can be entered
by using either the formula name or the display name for the attribute.
Run the tacmd listSitAttributes -s SITNAME command
to view the eligible attribute names for the situation.
- -k|--key
- Specifies the key condition or key conditions restricting the
predicate attribute for which the baseline value is calculated. Each
key condition must be enclosed in double quotation marks and entered
in the format "ATTRIBUTE OPERATOR VALUE" with spaces between
ATTRIBUTE, OPERATOR, and VALUE. The key condition OPERATOR is restricted
to the value "EQ". Historical data results from the warehouse
used for statistical calculations is restricted to values recorded
for the predicate attribute where all of the key conditions (where
ATTRIBUTE equals VALUE) are satisfied.
The key condition attribute
name can be entered by using either the formula name or the display
name for the attribute. Run the tacmd listSitAttributes
-s SITNAME command to view the eligible
key condition attribute names for the situation.
- -x|--xmlfile
- Specifies the name and location of the xml file where the situation
override definitions for each suggested baseline value is persisted.
This xml file can be used as input by the tacmd
setOverride command.
Overrides set by using this xml file only
apply for the situation and managed systems specified. If calendar
entries are specified, the overrides only apply during the specified
calendar entries. If calendar entries are not specified, the override
applies for all time periods. If key conditions are entered, the
overrides only apply when the (optional) key conditions are met.
- -u|--userid
- Specifies the existing User ID to log on to the Tivoli Enterprise Portal Server.
- -w|--password
- Specifies the password for user authentication.
- -h|--tepshostname
- Specifies the Tivoli Enterprise
Portal Server host name.
This example calculates suggested baseline values by using the
average value plus 1 standard deviation for managed system Primary:LEVER:NT
for the NT_NotesServerProcess situation, where the "Binary Path" attribute
value is equal to "C:\Notes\NotesServer\nserver.exe" .
Baseline values for the calendar entries WeekdayMorning and WeekdayAfternoon
are calculated by using metrics stored in the Tivoli Data Warehouse between 5:59 a.m. July 28th,
2008, and 1 a.m. August 29th, 2008. Suggested baseline values are
written to the xml file cpubaseline.xml in the local execution
directory:
tacmd suggestbaseline --userid sysadmin --password ******** --system
Primary:LEVER:NT --situation NT_NotesServerProcess --predicate "%
Processor Time GE 50" --function AVG+1 --startdata 1080728055900
--enddata 1080829010000 --key "Binary Path EQ C:\Notes\NotesServer\nserver.exe"
--calendarentry WeekdayMorning WeekdayAfternoon
This example calculates suggested baseline values by using 10%
below the minimum value for managed system Primary:LEVER:NT for the
NT_Disk_Space_Low situation, where the "Logical Disk Name" attribute
value is equal to "C:" . The baseline value is calculated by using
metrics stored in the Tivoli Data
Warehouse between 5:59 a.m. July 28th, 2008, and 1 a.m. August 29th,
2008:
tacmd suggestbaseline --userid sysadmin --password ********
--system Primary:LEVER:NT --situation NT_Disk_Space_Low
--predicate "% Free LE 15" --function MIN-10
--startdata 1080728055900 --enddata 1080829010000 --key "Logical Disk Name EQ C:"