Entering content frame

Procedure documentation Monitoring Web Pages with GRMG Lite Locate the document in its SAP Library structure

Use

You can monitor the availability of a URL by creating a GRMG Lite scenario. You do not need to implement a GRMG application to use this function check. Instead, GRMG Lite uses standard capabilities of the HTTP protocol.

To create a GRMG Lite scenario, you must enter a complete URL. You do not require any property values unless authentication is required.

GRMG Lite allows you to economically ping a Web server and a particular Web page. No implementation or installation of a GRMG application on the monitored server is required. Network traffic and server load is reduced, since the content of the page is not returned.

Procedure

...

       1.      Start transaction GRMG. The Generic Request and Message Generator screen appears.

       2.      Choose the button This graphic is explained in the accompanying text Edit/Delete ® Create GRMG Lite Scenario, and confirm the subsequent query.

       3.      On the following screen, Create GRMG Scenario, enter details about the name and description of the scenario and the component. In this way, you determine the name under which the scenario is displayed in the Alert Monitor, and the MTE classes to which the corresponding nodes belong. You can enter the following data:

Input Field

Meaning

Scenario Name

Determines the MTE class of the monitoring context (the MTE class of the monitoring context is GRMG_<scenario name>)

Version (Scenario)

Field, which you can leave empty, since GRMG has automatic version numbering

Description (Context Name)

Name of the monitoring context and therefore of the root node under which the scenario is displayed in the Alert Monitor

URL/RFC Destination

Defines whether a URL or an RFC connection is to be monitored using the scenario

Note

You can only monitor RFC destinations of types G and H (HTTP connections) in a GRMG Lite scenario.

Component Name

Determines the MTE class of the summary node (GRMG_<scenario name>_<component name>) and of the monitoring object (GRMG_<component name>_OBJ)

Version (Component)

Field, which you can leave empty, since GRMG has automatic version numbering

Description (Summary Node)

Name of the summary node and therefore of the subtree that contains the availability and the status messages for the monitored URL

Note

Use the names of the MTE classes to create your own rule-based monitors (see Creating a Rule-Based GRMG Monitor).

       4.      On the screen Edit GRMG Customizing, enter the name of the URL or RFC destination to be monitored in the URL/Destination input field.

Caution

If you want to monitor a URL, ensure that it is actually a page that exists on the Web server. Although Web servers should response with HTTP header data for the default page if they are called without a page, most servers do not. Instead, they often return the return code 404 (Page not found), if the URL does not define a page.

This error does not occur if you assign the value GET to the property GET_OR_HEAD (see below).

In this way, for example, pinging http://www.cnn.com (we do not recommend that you try this) returns the return code 404 and the message that the scenario cannot be executed due to an HTTP communication error. On the other hand, pinging http://www.cnn.com/index.html returns a return code 200 (ok).

       5.      If you want to enter additional information for user authentication for the call of the URL or RFC destination, enter this information in the Editable Properties table.

If you enter passwords in the editable properties, assign these the type PW. Properties of this type are stored in an encrypted format in the secure storage, displayed with asterisks (*), and protected with additional security measures.

Example

To monitor the availability of a Web page that requires a user/password logon, make the following entries:

Property Name

Type

Property Value

LOGON_USER

 

<user>

LOGON_PASSWORD

PW

<Password>

USE_BASIC_AUTHENTICATION

 

X

       6.      You can use GRMG Lite to monitor not only the header data, but also the content of an HTML page. To do this, assign the value GET to the property GET_OR_HEAD. Then assign the character string(s) for which you want to monitor the content of the page to the property CHECK_STRING_1 (and, if necessary, also the properties CHECK_STRING_2 and CHECK_STRING_3).

If you enter a property value !<character string>, a red alert is generated if <character string> exists in the HTML page. If you enter any first character other than !, the GRMG generates a red alert if <character string> does not exist in the HTML page.

Example

To check whether an HTML page contains the character string Error, and to generate a red alert if it does, make the following entries:

Property Name

Property Value

GET_OR_HEAD

GET

CHECK_STRING_1

!Error

       7.      The availability of a URL is determined by the HTTP return code. By default, a return code 2xx (OK) or 3xx (redirect) in the response header is interpreted as available. The status code 4xx (client error) or 5xx (server error) is interpreted as unavailable. You can use the values of the property name AVAILABLE_RESPONSE_CODES to determine the HTTP return codes with which the URL is regarded as available. When doing so, you can use the plus character as a placeholder for any individual character or individual number in that position. Separate the different valid return codes using commas.

Note

In addition to the availability itself, you can also determine the response time of the Web site (see Measuring the Runtime of Availability Monitoring with the GRMG).

       8.      Save your entries and exit the editing screen by choosing This graphic is explained in the accompanying text Exit.

       9.      To start the scenario, select the corresponding row , and choose the This graphic is explained in the accompanying text Start button.

This graphic is explained in the accompanying text

Result

You have created a GRMG Lite scenario for monitoring a URL or an RFC destination. The availability is displayed in the Availability and Performance Overview monitor (see Displaying the Availability Monitoring with the GRMG in the Alert Monitor).

This graphic is explained in the accompanying text Monitoring with the Generic Request and Message Generator start page

 

Leaving content frame