10.6.4 Add/Delete monitor area

(1) Window configuration

To Page Top

(2) Window description

The following table lists the items that are displayed:

No.	Item	Description
1	Source IP	Specifies the IP address of the source. When you launch URI detection for monitored services, only sources that match this IP address are detected. By default, this area displays the IP address of the machine you are currently working on (the machine on which you launched the browser to access ITSLM). If the system is configured to convert IP addresses through a device such as a router or load balancer, you must change this IP address to the converted IP address. An IP address is entered in the format XXX.XXX.XXX.XXX (XXX: 0 to 255).
2	Start detection button or Stop detection button	Start detection button Clicking this button starts URI detection. This button is displayed while the status is Stopped and when the Add/Delete monitor area is being displayed. Once you click this button to start detection, it changes into the Stop detection button. Stop detection button Clicking this button stops URI detection. This button is displayed while the status is Detecting. Once you click it to stop detection, it changes into the Start detection button.
3	Status	This field indicates whether monitored services are being detected. One of the following is displayed: Detecting: Monitored services are being detected. Stopped: Monitored services are not being detected.
4	Add line button	Clicking this button adds a blank line so that you can enter a URI directly.
5	Monitor configuration pull-down menu	When ITSLM is linked to Performance Management, select one of the following monitoring configurations for the service to be registered: Service System This field is displayed when ITSLM is linked to Performance Management. The default depends on the value set for the dashboardPrioritizeSystem property in ITSLM - Manager's system definition file (jp1itslm.properties): true: System is the default. false: Service is the default.
6	New service	This area displays the monitored services for which a URI has been detected. Select a service group and enter the name of a monitored service. Check boxes Select the check boxes for the monitored services that are to be registered. If you select the check box in the header, the check boxes in all rows become selected. Similarly, if you clear the check box in the header, the check boxes in all the rows are cleared. Service group Select the service group to which each monitored service belongs. The pull-down menu contains the names of the service groups that the logged-in user is responsible for monitoring (the resource group names registered in JP1/Base). Service Enter a name for each monitored service. A monitored service's URI is displayed by default. You can enter between 1 and 64 characters. Do not use ", ,, ', \, space, tab, platform-dependent characters, or control characters. We recommend that you not begin the name with a hyphen (-) so that it is not confused with a command option. URI# This column displays each monitored service's URI. You can enter between 1 and 255 characters. You cannot enter space, ", #, <, >, ?, [, \, ], ^, `, {, |, }, or non-ASCII characters. The notation must conform to RFC 3986. Enter a URI to which the user has full access. An entry can be made in this field when ITSLM is linked to Performance Management and Service is selected in Monitor configuration. Web server IP This column displays the IP address of the Web server that is executing each monitored service. An entry can be made in this field when ITSLM is linked to Performance Management and Service is selected in Monitor configuration. ITSLM - UR IP This column displays the IP address of the ITSLM - UR that is performing detection of each monitored service. An entry can be made in this field when ITSLM is linked to Performance Management and Service is selected in Monitor configuration. IP addresses are entered using the format XXX.XXX.XXX.XXX (XXX: 0 to 255).
7	Registration button	Clicking this button registers the monitored services whose check boxes are selected in the new services area. Monitored services that have been successfully registered are displayed under Registered services.
8	Registered services	This area displays a list of the monitored services that have been registered. Check boxes Select monitored services to be deleted. If you select the check box in the header, the check boxes in all rows become selected. Similarly, if you clear the check box in the header, the check boxes in all rows are cleared. A check box that has been selected is cleared if you click the Start detection button, Stop detection button, or Registration button. Service group This column displays the name of the service group to which each monitored service belongs. Service This column displays the name of each monitored service. URI This column displays the URI of each monitored service. The URI is displayed when ITSLM is linked to Performance Management and the monitoring configuration for the monitored service is Service. If the monitoring configuration for the monitored service is System, - is displayed. Web server IP This column displays the IP address of the Web server that is executing each monitored service. The IP address of the Web server is displayed when ITSLM is linked to Performance Management and the monitoring configuration for the monitored service is Service. If the monitoring configuration for the monitored service is System, - is displayed. ITSLM - UR IP This column displays the IP address of the ITSLM - UR that is performing the detection of each monitored service. The IP address of the ITSLM - UR is displayed when ITSLM is linked to Performance Management and the monitoring configuration for the monitored service is Service. If the monitoring configuration for the monitored service is System, - is displayed.
9	Delete button	Clicking this button deletes the monitored services whose check boxes have been selected in the Registered services area.

To Page Top

(3) Supplemental notes

Detecting a monitored service

• If you click the Start detection button after monitoring of monitored services has started, an error message is displayed and detection of monitored services is not initiated.

• Once you click the Start detection button, all areas outside the Add/Delete monitor area cannot be used until after you click the Stop detection button.

• Once you click the Start detection button, you cannot click the Registration or Delete button until after you click the Stop detection button.

• In the event of a failure or termination in some part of ITSLM - UR processing after you start detection of services by clicking the Start detection button, detection of services by ITSLM - UR will nevertheless continue if possible. However, if ITSLM - UR is unavailable, detection will fail and remain in Stopped status. Similarly, when you stop detection of services by clicking the Stop detection button, a failure somewhere in ITSLM - UR will result in an error message but stop processing will continue.

• If you exit the browser or log out by pressing the F5 key on the keyboard while Status shows Detecting, detection will stop after a two-minute timeout. Even if you log in again during this two minutes, it will not be possible to detect monitored services until the timeout is completed.

Registering a monitored service

• Multiple service names can be registered under the same URI. Even though they share the same URI, the services will be treated as separate services.

• All monitored services in the same service group must have unique service names. An error message will be displayed if you try to register under a service group a monitored service that has a name that has already been used in that service group. Monitored services with the same service name can be registered under different service groups.

• If you register multiple monitored services at the same time, the registration process proceeds in order from the top of the list. If registration of a monitored service fails during registration processing of the list, the monitored service before the one that fails will be registered, but registration stops with the failed monitored service and the subsequent monitored services are not registered.

• If you attempt to register a monitored service that has been deleted from another browser, an error message will be displayed.

• If multiple users are logged into ITSLM - Manager, and a service group administrator registers a monitored target, the timing for reflecting the change on the other users' screens is described in 3.2.9(1) Timing of updating the number of registered monitored targets.

• If the IP address of a monitored service's Web server changes (such as after a server migration, for example), it will need to be re-registered as a new service.

Deleting a monitored service

• If you attempt to delete a monitored service that has been deleted from another browser, an error message will be displayed.

• If multiple users are logged into ITSLM - Manager, and a service group administrator deletes a monitored target, the timing for reflecting the change on the other users' screens is described in 3.2.9(1) Timing of updating the number of registered monitored targets.

• If you attempt to delete a Web transaction belonging to a deleted monitored service, an error message will be displayed.

• If you attempt to delete a monitored service whose monitoring has not stopped, an error message will be displayed.

• If you delete multiple monitored services at the same time, the deletion process proceeds in order starting from the top of the list. If deletion of a monitored service fails during processing of the list, the monitored service before the one that fails will be deleted, but deletion stops with the failed monitored service and the subsequent monitored services are not deleted.

• When you delete a monitored service, some of its data will remain in the ITSLM - Manager database. Especially after you have deleted a number of monitored services, we recommend that you execute the database cleanup command to delete data that is no longer needed so that unwanted data does not accumulate in the database.

  For details about the cleanup command, see jslmmgrdbcleanup (cleans up database) in 9. Commands.

• When you delete a monitored service, its access logs are not deleted.

URIs supported by ITSLM

• The URIs supported by ITSLM depend on the version of ITSLM. The ITSLM version-specific URI formats shown in the table below are based on the following URI notation:

  • scheme://authority path <?query><#fragment>

  The following table shows the supported formats.

  Table 10‒4: Supported URI formats depending on the ITSLM version

  No.	URI element	Supported formats
  		09-50	09-51 and later
  1	scheme	Only http is supported. https is not supported.
  2	authority	Only host names are supported. If a port number is specified, an error message will be displayed when monitoring of the monitored service begins. A host name must consist of 1 to 255 characters. If it exceeds 255 characters, only the first 255 characters are used.	Host names and port numbers are both supported. A host name must consist of 1 to 255 characters. If it exceeds 255 characters, only the first 255 characters are used. A port number must be an integer between 0 and 65535.
  3	path	Not supported	The path format is supported. A path must consist of 1 to 255 characters. If it exceeds 255 characters, only the first 255 characters are used. URL-encoded characters in UTF-8 can be used.
  4	query	Not supported	The query format is supported. URL-encoded characters in UTF-8 can be used.
  5	fragment	Not supported

  Only an entry in the applicable supported format is considered a URI. If an unsupported format is specified, the entry will be ignored.

  If your system configuration has ITSLM - Manager or ITSLM - UR in a mixture of version 09-50 and version 09-51 or later, only version 09-50 URIs are supported.

• You cannot register a URI that specifies a loopback address, or a URI where localhost is specified as the host name. Service detection will run, but upon detection the URI will not be displayed as a new service in the Add/Delete monitor area.

To Page Top