NetScaler System Log Test

When an error or event occurs on the ADC appliance, administrators should determine what caused the error or how the event was generated, attempt to recover any lost data, and prevent errors from recurring. To help administrators in this, important events/errors, such as system failures, changes in configuration,  excessive resource utilization etc are recorded in a log file. Administrators can  use the log to determine what was the root-cause of the errors and identify the context in which they occurred. By periodically viewing the log, administrators may be able to identify problems (such as system failures) before they cause irreparable damage. To aid administrato rs in the process, eG Enterprise offers the NetScaler System Log test.

This tests periodically monitors the log file of the target ADC appliance and reports the statistical details about the events that occurred on the target appliance.

Target of the test : An ADC VPX/MPX

Agent deploying the test : A remote agent

Outputs of the test : One set of results for the target ADC appliance

Configurable parameters for the test
Parameter Description

Test Period

How often should the test be executed.

Host

The IP address of the host for which the test is being configured.

NetScaler Username and NetScaler Password

To monitor a ADC device, the eG agent should be configured with the credentials of a user with read-only privileges to the target ADC device. Specify the credentials of such a user in the NetScaler Username and NetScaler Password text boxes.

Confirm Password

Confirm the ADC Password by retyping it here.

SSL

The eG agent collects performance metrics by invoking NITRO (ADC Interface Through Restful interfaces and Objects) APIs on the target ADC device. Typically, the NITRO APIs can be invoked through the HTTP or the HTTPS mode. By default, the eG agent invokes the NITRO APIs using the HTTPS mode. This is why, the SSL flag is set to Yes by default. If the target ADC device is not SSL-enabled, then the NITRO APIs can be accessed through the HTTP mode only. In this case, set the SSL flag to No.

Report Using Manager Time

By default, this flag is set to Yes. This indicates that the user login time displayed in the detailed diagnosis page for this test will be based on the eG manager's time zone by default. Set this flag to No if you want the login times displayed in the detailed diagnosis page for this test to be based on the target ADC’s local time.

DD Frequency

Refers to the frequency with which detailed diagnosis measures are to be generated for this test. The default is 1:1. This indicates that, by default, detailed measures will be generated every time this test runs, and also every time the test detects a problem. You can modify this frequency, if you so desire. Also, if you intend to disable the detailed diagnosis capability for this test, you can do so by specifying none against DD frequency.

Detailed Diagnosis

To make diagnosis more efficient and accurate, the eG Enterprise embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the detailed diagnosis capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option.

The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled:

  • The eG manager license should allow the detailed diagnosis capability
  • Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.
Measurements made by the test
Measurement Description Measurement Unit Interpretation

UP events

Indicates the number of UP events that were recorded in the log file.

Number

The detailed diagnosis of this measure reveals the time stamp at which the UP event was generated, number and code of the UP event, ID and name of the device for which the UP event was generated and the brief description about the event.

DOWN events

Indicates the number of DOWN events that were recorded in the log file.

Number

The detailed diagnosis of this measure reveals the time stamp at which the DOWN event was generated, number and code of the DOWN event, ID and name of the device for which the DOWN event was generated and the brief description about the DOWN event.

Other events

Indicates the number of other events that were recorded in the log file.

Number

The detailed diagnosis of this measure reveals the time stamp at which the Other event was generated, number and code of the Other event, ID and name of the device for which the Other event was generated and the brief description about the Other event.