9.6 jslmmgrconfig (setting a monitored service) : JP1 Version 11 JP1/Service Level Management Description

Function

This command has the following functions:

Changing the monitoring configuration of a monitored service
Obtaining Performance Management configuration information and system monitor item settings
Updating Performance Management configuration information and system monitor item settings
Obtaining the monitoring settings of a monitored service
Updating the monitoring settings of a monitored service
Adding a monitored service

This command is to be executed upon satisfying the following conditions:

The following services of SLM - Manager have been started.
- Service SLM - Manager DB Service (service name: HiRDBEmbeddedEdition_JL0)
- Service SLM - Manager Service (service name: JP1_ITSLM_MGR_Service)
Monitoring of the monitored service you wish to change the settings of is stopped.

Execute the command with the active server in the case of a cluster system. If the command is executed on the standby server, an error will result.

The only option that can be specified with the -t option when executing a command in relation to a slave instance of SLM - Manager is edit. Using an option other than edit results in an error.

When executing the command with set specified for the -t option, execute the command in advance upon specifying get for the -t option and specify the CSV file that is output as the argument. This prerequisite is to be executed for the -m option of each when specifying either config or monitor with the -m option. An error will occur if the command is not executed in advance with get specified for the -t option and the command is executed with set specified for the option.

The indicator "jslmmgrconfig" is configured to messages output to the message log by this command.

For details about the message log, see 7.2.4 Message logs.

For details about the messages that are output when commands are executed, see 11.3 Messages.

Format

Changing the monitoring configuration of a monitored service

jslmmgrconfig -t edit
              -g service-group-name -s service-name
              -c { service web-server-IP-address SLM-UR-IP-address URI | system }

Obtaining the Performance Management configuration information and system monitor item settings

jslmmgrconfig -t get -m config
              -g service-group-name -s service-name
              [ -r ] -o CSV-file-path-of-output-destination [ -f ]

Updating the Performance Management configuration information and system monitor item settings
```
jslmmgrconfig -t set -m config
              [ -f ] -i CSV-file-path-of-input-source
```

Obtaining the monitoring settings of a monitored service

jslmmgrconfig -t get -m monitor
              -g service-group-name -s service-name
              -type { service | system } -o CSV-file-path-of-output-destination [ -f ]

Updating the monitoring settings of a monitored service

jslmmgrconfig -t set -m monitor
              -i CSV-file-path-of-input-source

Adding a monitored service

jslmmgrconfig -t add
             [ -p { registration-destination-SLM-Manager-host-name | registration-destination-SLM-Manager-IP-address } ] 
             -g service-group-name -s service-name
             -c { service web-server-IP-address SLM-UR-IP-address URI | system }

Execution permission

User account that belongs to the OS's Administrators group

Storage folder

SLM-Manager-installation-folder\mgr\bin\

Arguments

-g service-group-name

Specifies the name of the service group of the monitored service. A name beginning with a hyphen (-) cannot be specified.

-s service-name

Specifies the name of the monitored service. A name beginning with a hyphen (-) cannot be specified.

-c

Changes the monitoring configuration of the service to a different monitoring configuration. The following explains the specification method.

service

Specified when adding a monitored service of the service monitoring configuration or when changing a monitored service of the system monitoring configuration to the service monitoring configuration. Specify the IP address of the web server, the IP address of the UR, and the URI in the following manner:

IP address of web server

Specifies the IP address of the web server providing the monitored service.

IP address of SLM - UR

Specifies the IP address of SLM - UR.

URI

Specifies the URI of the monitored service.

1 to 255 characters can be entered. You cannot enter spaces, ", #, <, >, ?, [, \, ], ^, `, {, |, }, or non-ASCII characters. The notation must conform to RFC 3986.

Enter a URI to which the user has full access.

Make sure that each URI ends with a slash (/). However, when the end of the URI detected immediately after is not a slash (/), as long as the URI is not edited, registration is possible as a monitored service with which all paths of the URI are subject to monitoring. A URI is specified in the following format:

authority path

The meanings of these values are as follows:

authority

Corresponds to host, port. The host must consist of 1 to 255 characters and if it exceeds 255 characters, only the first 255 characters are used. The port must be a numeric value between 0 and 65,535. If no port number is specified, all port numbers are targeted.

path

The path must consist of 1 to 255 characters and if it exceeds 255 characters, only the first 255 characters are used. Double-byte characters cannot be used. URL-encoded characters in UTF-8 can be used.
system

Specified when changing the service monitoring configuration of a monitored service to the system monitoring configuration. The following items are deleted along with the change to the system monitoring configuration:
- Setting up service performance monitoring
- Web transactions
- Service performance information
When the access log function has been used prior to changing the monitoring configuration and the access log function will not be used with all monitored services registered after the change, it is necessary to manually delete the folder specified with the system definition property (accessLogFilePath) of SLM - UR and delete the specification of the property.

-o CSV-file-path-of-output-destination

Specifies the file path for the output destination of the obtained information. The obtained information is output in CSV format. An absolute file path can be specified for the file path name.

If the specified directory does not exist, an error will result.

If the specified output file already exists, the specification of the -f option is observed.

Output format of CSV file

The output format of the CSV file is as follows: The output format differs depending on the obtained information.

When the Performance Management configuration information and system monitor item settings have been obtained

The output format when the Performance Management configuration information and system monitor item settings have been obtained is as follows:

service-group-name,service-name
Registor,Business group,Host,Monitored target,Monitor item,Key field 1,Key field 2,Key field 3,Key field 4,Key field 5,Key field 6,Key field 7,Key field 8,Key field 9,Key field 10
Register-value,Business group-value,Host-value,Monitored target-value,Monitor item-value,Key field 1-value,Key field 2-value,Key field 3-value,Key field 4-value,Key field 5-value,Key field 6-value,Key field 7-value,Key field 8-value,Key field 9-value,Key field 10-value

The format information of the output format is as follows:

Table 9‒3: Format information of the output format
Line number	Category	Description
Line 1	Service information	Information about service to be obtained
Line 2	Header information of data section	Item information of data section
Line 3 and following lines	Data section	Actual data placed in data section

Output information of the output format is as follows:

Table 9‒4: Output information of the output format
Category	Item	Description
Service information	`Service group name`	Service group name subject to obtaining of monitoring configuration information
Service information	`Service name`	Service name subject to obtaining of monitoring configuration information
Data section	`Register value`	The following value is output. 0: Not registered with specified service 1: Registered with specified service
	`Business group value`	Business group name
	`Host value`	Host name
	`Monitored target value`	Monitored target name
	`Monitor item value`	Monitor item name
	`Key field 1 value` to `Key field 10 value`	Key value Null characters are output when a key value has not been set.

When the monitoring settings of a monitored service have been obtained

The output format when the monitoring settings of a monitored service (service monitoring settings or system monitoring settings) have been obtained is as follows:

Service monitoring settings

service-group-name,service-name,service,Period-value
Monitored target,Avg.response-Reg,Threshold,Trend monitor-Reg,Trend monitor,Throughput-Reg,Threshold,Trend monitor-Reg,Trend monitor,Error rate-Reg,Threshold,Days in baseline calculation,Days till start,Error Predict. Settings-Reg(Avg. response),Sensitivity(Avg. response),Correlated items,Error Predict. Settings-Reg(Throughput),Sensitivity(Throughput),Error Predict. Settings-Reg(Error rate),Sensitivity(Error rate)
Monitored target-value,Avg.response-Reg-value,Threshold-value,Trend monitor-Reg-value,Trend monitor-value,Throughput-Reg-value,Threshold-value,Trend monitor-Reg-value,Trend monitor-value,Error rate-Reg-value,Threshold-value,Days in baseline calculation-value,Days till start-value,Error Predict. Settings-Reg(Avg. response),Sensitivity(Avg. response),Correlated items,Error Predict. Settings-Reg(Throughput),Sensitivity(Throughput),Error Predict. Settings-Reg(Error rate),Sensitivity(Error rate)

The format information of the output format is as follows:

Table 9‒5: Format information of the output format
Line number	Category	Description
Line 1	Service information	Information about service to be obtained
Line 2	Header information of data section	Item information of data section
Line 3 and following lines	Data section	Actual data placed in data section

Output information of the output format is as follows:

Table 9‒6: Output information of the output format
Category	Item	Description
Monitoring settings	`Service group name` `Service name` service	The information about the service monitoring settings of the service referenced when the data is obtained.
Period of analysis of out-of-range value detection	`Period value`	Outputs one of the following for the configured period of analysis for out-of-range value detection: Short range: Past 60 days Long range: Past 5 years
Target	`Monitored target value`	Outputs one of the following for the subject of service monitoring settings of the specified service: All Web Access `Web transaction name` The web transaction names are displayed in the order of registration.
Monitoring flag	`Avg. response-Reg value` Existence of average response time `Trend monitor-Reg value` Existence of average response time (trend monitor) `Throughput-Reg value` Existence of throughput `Trend monitor-Reg value` Existence of throughput (trend monitor) `Error rate-Reg value` Existence of error rate `Error Predict. Settings(Avg. response) value` Existence of average response time (out-of-range value detection) `Error Predict. Settings(Throughput) value` Existence of throughput (out-of-range value detection) `Error Predict. Settings(Error rate) value` Existence of error rate	Information on whether monitoring is being implemented is output by using the following values: 0: Without monitoring flag 1: With monitoring flag
Value input	`Threshold value` Threshold of average response time `Trend monitor value` Average response time (trend monitor) `Threshold value` Threshold of throughput `Trend monitor value` Throughput (trend monitor) `Threshold value` Threshold of error rate `Days in baseline calculation value` Number of days of accumulation at baseline `Days till start value` Start time	The configured value is output.
Sensitivity input	`Sensitivity(Avg. response) value` Sensitivity of response time of out-of-range value detection `Sensitivity(Throughput) value` Sensitivity of throughput of out-of-range value detection `Sensitivity(Error rate) value` Sensitivity of error rate of out-of-range value detection	Information on the sensitivity of monitoring settings is output using the following values: l: Low m: Medium h: High The value is not case-sensitive.
Correlated items	`Correlated items value`	The information set to be subject to correlation with the response time is output using the following values: NO: None TH: Throughput

System monitoring settings

Service group name,Service name,system,Period value
Host Name,Monitored target Name,Monitor item Name,SLO monitor-Reg,Threshold,Times exceeded,measured,Trend monitor-Reg,hours,Error Predict-Reg,Days in baseline calculation,Days till start,Sensitivity,Times exceeded,measured,Select 
Host Name value,Monitored target Name value,Monitor item Name value,SLO monitor-Reg value,Threshold value,Trend monitor value,Times exceeded value,measured value,Trend monitor-Reg value,hours value,Error Predict-Reg value,Days in baseline calculation value,Days till start value,Sensitivity value,Times exceeded value,measured value,Select value

The format information of the output format is as follows:

Table 9‒7: Format information of the output format
Line number	Category	Description
Line 1	Service information	Information about the service to be obtained
Line 2	Header information of data section	Item information of data section
Line 3 and following lines	Data section	Actual data placed in data section

Output information of the output format is as follows:

Table 9‒8: Output information of the output format
Category	Item	Description
Monitoring settings	Service group name `Service name` system	The information of the system monitoring settings of the service referenced when the data is obtained.
Period of analysis of out-of-range value detection	`Period value`	Outputs one of the following for the configured period of analysis for out-of-range value detection: Short range: Past 60 days Long range: Past 5 years
Target	`Host Name value` Monitored host name `Monitored target Name value` Monitored target name `Monitor item Name value` Monitor item name	The subjects of the system monitoring settings of the specified service.
Monitoring flag	`SLO monitor-Reg value` Existence of threshold value monitor `Trend monitor-Reg value` Whether to monitor trends `Error Predict-Reg value` Existence of out-of-range value detection	Information on whether monitoring is being implemented is output by using the following values: 0: Without monitoring flag 1: With monitoring flag
Value input	`Threshold value` Threshold `Times exceeded value` Number of times the threshold has been exceeded `measured value` Number of times the threshold has been measured `hours value` Number of trend monitor hours `Days in baseline calculation value` Number of days of accumulation at baseline `Days till start value` Start time out-of-range value detection `Times exceeded value` Number of times the out-of-range value detection has been exceeded `measured value` Number of times the out-of-range value detection has been measured	The configured value is output.
Sensitivity input	`Sensitivity value`	Information on the sensitivity of out-of-range value detection is output using the following values: l: Low m: Medium h: High The value is not case-sensitive.
Reference selection	`Select value`	In the case of the system monitoring configuration, whether to select an item to serve as a reference for the creation of the baseline is output using the following values: 0: Do not select as a reference 1: Select as a reference

Output character code

Output is in the UTF-8 format.

-i CSV-file-path-of-input-source

Specifies the file path for the input source of the updated information. The file is input in the CSV format. An absolute file path can be specified for the file path name.

If the specified directory does not exist, an error will result.

Input format of CSV file

The input format of the CSV file is as follows: The input format differs depending on the information to be updated.

When updating the Performance Management configuration information and system monitor item settings

The input format when updating the Performance Management configuration information and system monitor item settings is as follows:

service-group-name,service-name
Registor,Host,Business group,Monitored target,Monitor item,Key field 1,Key field 2,Key field 3,Key field 4,Key field 5,Key field 6,Key field 7,Key field 8,Key field 9,Key field 10
Register-value,Business group-value,Host-value,Monitored target-value,Monitor item-value,Key field 1-value,Key field 2-value,Key field 3-value,Key field 4-value,Key field 5-value,Key field 6-value,Key field 7-value,Key field 8-value,Key field 9-value,Key field 10-value,itemAddName-value

The format information of the input format is as follows:

Table 9‒9: Format information of the input format
Line number	Category	Description
Line 1	Service information	Information about service to be updated
Line 2	Header information of data section	Item information of data section
Line 3 and following lines	Data section	Actual data placed in data section