HTTP status codes may be received from a Web Service. The Enterprise Gateway can
be configured to monitor these and generate alerts based on the number of
occurrences of certain types of status code response. HTTP status codes
are three digit codes that may be grouped into standard status "classes",
with the first digit indicating the status class. The status classes are
as follows:
HTTP Status Code Class
|
Description
|
1xx
|
These status codes indicate a provisional response.
|
2xx
|
These status codes indicate that the client's request was
successfully received, understood, and accepted.
|
3xx
|
These status codes indicate that further action needs to
be taken by the user agent in order to fulfill the request.
|
4xx
|
These status codes are intended for cases in which the
client seems to have erred. For example 401, means that
authentication has failed.
|
5xx
|
These status codes are intended for cases where the server
has encountered an unexpected condition that prevented it
from fulfilling the request. For example, 500 is used to
transmit SOAP faults.
|
The Enterprise Gateway may monitor a class (i.e. range) of status codes, or they
may monitor specific status codes. For example, it is possible to
configure the following HTTP status code requirements:
-
At least 97% of the requests must yield HTTP status codes
between 200 and 299
-
At most 2% of requests may yield HTTP status codes between
400 and 499
-
At most 0% of requests may yield HTTP status code 500
Click the Add button in the
HTTP Status Code Requirements section.
Select an existing status code or class of status codes from the
HTTP Status Code dropdown. To add a new code or range
of codes, click the Add button.
Enter a name for the new code or range of codes in the
Name field of the
Configure HTTP Status Code dialog. Enter the
first HTTP status code in the range of status codes
that you want to monitor in the Start Status field.
Then enter the last HTTP status code in the range of
status codes that you want to monitor in the End Status
field.
If you just want to monitor one specific status code, enter the same code
in the Start Status and End Status
fields.
Click OK when you are satisfied with the selected range
of status codes to return to the previous dialog. The remaining 2 fields
allow the administrator to specify the minimum or maximum percentage of
received HTTP status codes that fall into the configured range before an
alert is triggered.
Again, the use of percentages here is to allow for situations where a
very small number of requests return the status codes within the
"forbidden" range. By using percentages, such requests will not distort
the statistics collected by the Enterprise Gateway.
Click on the Message Text tab to configure the messages
that will appear in the alert message when the SLA is breached and also
when the SLA is cleared, i.e. when the breached conditions are no longer
in breach of the SLA.
|