Agents Administration - Tests
 

Configuration of ACUserSysTest

This test auto-discovers the users who are currently logged into the AppController, and for each user, reports the open sessions for that user and the number of successful and failed application launches per user. This way, the test points to those users with the maximum number of failed application launches. Such users naturally are the ones with a poor quality experience with the AppController.

For this test to run and report metrics, the AppController should be configured to create a Syslog file in a remote Syslog server, where the details and status of all user interactions with the AppController will be logged. To configure the Syslog server where this Syslog file should be created, refer to the Monitoring the Citrix AppController document.

The default parameters associated with this test are:

  • The TEST PERIOD list box helps the user to decide how often this test needs to be executed.

  • Specify the host for which the test is to be configured in the HOST text box.

  • Specify the port at which the specified HOST listens in the PORT text box. By default, this is NULL.

  • This test reports metrics by parsing a Syslog file. Specify the full path to the Syslog file in the LOG FILE PATH text box. To know how to configure the Syslog server where the AppController will be creating this file, click here.

  • The test discovers the users who are currently logged into the AppController by reading the entries in the User column of the specified syslog file. Sometimes, this column may have a few blank entries. By default, this test ignores these blank entries. This is why, the SHOW OTHER USERS flag is set to No by default. If you set this flag to Yes, then the test will report metrics for these blank entries as well. In this case, the test will additionally report a set of metrics for an Others descriptor. Each measure of the Others descriptor will report a value that is an aggregate of the values recorded for the blank entries in the Syslog file.

  • Indicate whether/not AppController is SSL-enabled. By default, the SSL flag is set to Yes.

  • To make diagnosis more efficient and accurate, the eG Enterprise suite 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.

  • If multiple components of the same component type are awaiting configuration, then an APPLY TO OTHER COMPONENTS check box will appear in this page. Clicking on this check box will allow you to apply the configuration to all/selected components of that type.

  • Once the necessary values have been provided, clicking on the UPDATE button will register the changes made.

When changing the configuration for specific servers, a “*” beside the text box corresponding to the parameter signifies that these values have to be manually configured by the user. The parameter values that require to be configured will typically be prefixed with a “$” or contain a series of “*”. A value of "none" in the parameter value indicates that the corresponding parameter value can be changed if required.