AppC Users Test

To assess a user’s experience with the AppController, administrators must track a user’s sessions on the AppController and audit the quality of the application launches attempted by that user. The AppC Users test does exactly this! 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 know how to configure the Syslog server where the AppController will be creating this file, Configuring the Syslog server.

Target of the test : Citrix AppController

Agent deploying the test : A remote agent

Outputs of the test : One set of results for the Citrix AppController being monitored.

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.

Port

The port at which the host listens. By default, this is NULL.

Log File Path

This test reports metrics by parsing a Syslog file. Specify the full path to the Syslog file here. To know how to configure the Syslog server where the AppController will be creating this file, Configuring the Syslog server.

Show Other Users

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.

SSL

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

Detailed Diagnosis

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.
Measurements made by the test
Measurement Description Measurement Unit Interpretation

User sessions

Indicates the number of open sessions for this user currently.

Number

This is a good indicator of the session load imposed by a particular user on the AppController. In the event of a session overload, you can compare the value of this measure across users to know which user has contributed to the overload.

Use the detailed diagnosis of this measure to know which applications are being accessed by a user and which client/receiver that user is using to launch the application.

Successful application launches

Indicates the number of successful application launches for this user.

Number

Use the detailed diagnosis of this measure to know which applications were successfully launched by a user and which client/receiver that user used to launch each application.

Failed application launches

Indicates the number of application launches that failed for this user.

Percent

Use the detailed diagnosis of this measure to know which applications a user could not launch and which client/receiver that user used to launch each application.