SWATCH-MIB: View SNMP OID List / Download MIB

The number of network servers currently monitored by this agent.

The next available row index that can be used for the creation of a new ServiceWatch request. If there are no available rows, 0 is returned.

The list of network servers and their status. The number of entries is given by the value of isNumber.

An entry for a network server containing objects describing the health and performance of the network server.

A unique value for each URL entry. Its value ranges between 1 and isNumber. Row/ index numbers start at row 1. around to 0, etc.

The name of the ServiceWatch request.

See 'RequestStatus' definition for possible values, except the value of isStatus will never be notReady(3): if this row exists, it will ALWAYS be ready. The notReady(3) value typically means the row exists, but was missing information. In this case, ServiceWatch automatically fill in defaults for any values that were missing, so notReady(3) will NEVER set here.

The URL monitored. You can add new URLs to be monitored by setting a URL in isURL.

The username to use for access to the network service. Currently used for web and ftp services only.

A password to use for access to the network service. Currently used for web and ftp services only.

The hostname of a web proxy server, if any. If an isProxy server is set to a web proxy server name, the request will be sent to the proxy server, instead of directly to the hostname specified in the URL.

The current operational state of the server. Enumeration: 'down': 2, 'unknown': 3, 'up': 1.

A textual description of the server software.

The response time, in seconds, for the server to complete the request. Note: A string containing a floating point number: real floating point values do not exist in the SNMP protocol, so a floating point string is used. For the response time as an integer, refer to 'isResponseTimeInteger.'

The response time, in seconds, for the server to complete the request. (An integer.)

The time for the server to complete the request exceeded maximum amount of time allowed. (See the isMaxWait variable which is related to this variable.) The request to the server was consequently aborted It will be set to unknown(3) if the request is not active. Enumeration: 'true': 1, 'false': 2, 'unknown': 3.

The maximum amount of time to wait before timing out during an attempt to perform a query on the server.

The error level to set when an event occurs for this URL. The type of error level can be determined by the user: For example 1-10, or 'low', 'medium', 'high', etc.

The type of error that occurred (if any). Enumeration: 'receiving-from-server-failed': 4, 'connect-to-server-failed': 5, 'dns-warning-name-error': 10, 'could-not-determine-our-enet-addr': 60, 'protocol-specific-error': 40, 'telnet-error-appeared-to-not-be-a-telnet-server': 30, 'dns-warning-unknown-server-reply': 13, 'child-poller-never-received-a-request': 24, 'dns-warning-query-format-error': 8, 'ping-record-route-option-set-failed': 32, 'unknown-monitoring-failure': 23, 'dns-warning-response-not-in-correct-format': 15, 'could-not-fork-child-process': 28, 'could-not-exec-extensible-program': 35, 'unknown-error': 70, 'gopher-error-No-answer-after-request': 18, 'extensible-monitoring-filename-missing': 37, 'dns-warning-incorrect-id-returned': 14, 'pipe-failure': 39, 'transmission-to-server-failed': 3, 'unknown-protocol-or-API-not-licensed': 42, 'could-not-run-the-ServiceWatch-polling-program': 27, 'invalid-server-response': 61, 'bad-protocol-type-in-URL': 22, 'transfer-time-exceeded-maximum': 6, 'child-poller-died-unexpectedly': 25, 'snmp-no-such-objectid': 55, 'dns-warning-has-not-implemented-this-kind-of-query': 11, 'unused': 20, 'snmp-error-response': 57, 'smtp-error-Unexpected-response-maybe-wrong-port': 19, 'dns-warning-server-failure': 9, 'snmp-no-such-name': 56, 'extensible-directory-missing-or-inaccessible': 36, 'client-bootp-or-dhcp-port-used-by-another-process': 29, 'could-not-create-socket': 59, 'extend-program-sent-no-results': 41, 'none': 1, 'could-not-create-pipe-for-child': 26, 'dns-warning-refused-to-perform-query': 12, 'extensible-file-open-failure': 38, 'no-answer-from-server-after-connection': 16, 'web-retrieval-request-error': 7, 'hostname-in-URL-not-found-via-name-service': 21, 'ssl-connection-failed': 52, 'connection-timed-out': 2, 'smtp-error-No-answer-after-connection': 17, 'telnet-error-server-could-not-accept-reply': 31, 'ssl-feature-not-enabled': 50, 'ssl-connection-timed-out': 51.

The number of data bytes read from the server on the last request.

The rate of bytes per second read from the server on the last request.

The TCP/IP or UDP/IP port number used to contact the network server. You specify the port number to use in isURL.

For DNS, isPortType can be either TCP or UDP. For other protocols, it can be only TCP, since the other protocols speak only TCP. Enumeration: 'udp': 2, 'tcp': 1.

Options (bitstring) on how the server will be contacted. You can add these together to set more than one option: none(1): By defaut, a sample query to the server will be performed. noQuery(2): Do not attempt to do a query to the network server (it will only check the port to determine if there IS a server there. reResolve(4): Reresolve the hostname into an IP address immediately before EACH attempted contacted with the network server. proxyNocache(8): When using a proxy server, inform the proxy server to not use its cache. logAll(32): Log information from all poll requests to the log file. (Otherwise, only exceptions/traps will be logged.) notifyStateChange(64): Notify ONLY on a state change of a network service. For example, notify only if 1) A service has been down exactly NCFailsAlert times, OR: 2) A service has been down and then comes back up. Note: If NotifyStateChange is set, then only 1 notification will occur until/unless the network server comes up again. The KIND of notification done (trap and/or log to a file and/or run a program) is determined by the isEventType variable. allEprog(128): Run the program specified in isEprog after EACH poll attempt to the service (rather than only when there is an event, etc.). traceRoute(256): If an event occurs and email is sent (isEmail is set), then include a traceroute to the host that had the failed network service. disableAutoStart(512): Do not start this request during 'Start All Requests' or system reboots. sslWorkarounds(1024): Enable SSL bug workarounds.

The number of times to perform the request.

The number of seconds to wait, after the completion of the last request, before starting the next request.

The request number (relates to isNRequests and isInterval.

The type of notification that will be performed. Add all of the options you wish to use and set isEventType to the total of these options. For example, if you want logging to a file (2) and an snmp-trap to be sent (4), then set isEventType to 6 (2 + 4). The default is snmp-trap(4). The possible choices are: none(1): No logging is performed. If this bit is set, all other bits are then cleared in this variable. log(2): Logging to a file is performed. snmp-trap(4): Sending an SNMP trap is performed.

The filename of the program to run when an event occurs (or after every poll attempt if isOptions has allEprog set).

The email address to send email when an event occurs. If this variable is not null, then email will be sent to this email address when an event occurs.

The email address of an alphanumeric pager to send email formatted for a pager when an event occurs. If this variable is not null, then email formatted for alphanumeric pagers will be sent to this email address when an event occurs.

The number of CONSECUTIVE failures when attempting to complete the request to a network server.

Report a failure when isNCFailsAlert consecutive failures have occurred. Failures are reported as defined by the isEventType variable. The default for isNCFailsAlert is 1: After 1 failure, report it.

The response type as returned from the server. For example 200-299 means the request succeeded, 400-499 are bad requests, etc.

A textual description of the server's response type, as returned from the server. (This response should contain the string describing the responseType byte.)

The last time that this agent attempted to contact the network server. The format returned: Thu Oct 3 13:18:50 1996

The first time the network service failed this round of failures. The format returned: Tue Jan 4 23:08:21 2000

The retrieved file's type, such as text/html, image/gif etc. (Applies to web servers only, currently).

The IP address to which this entry's monitoring information pertains.

Additional information or data returned from the sample request.

The network server failed to correctly reply to the request in the time allowed.

If notifyStateChange is set in isOptions and the state of the network service changed from down to up, then a 'serverUp' trap is sent.

This trap is sent when the ServiceWatch agent starts

This trap is sent when the ServiceWatch agent terminates