Configuration of AzrSessHostTest

This test checks the availability of every host pool, and alerts administrators if any host pool is unavailable. For available host pools, the test further tracks the status of the hosts in the pool, and notifies administrators if any host is in an abnormal state. The abnormality can imply that a host is unavailable / powered off / disconnected, or that an upgrade failure has occurred on the host. Additionally, the test also reveals if any host in a pool is idle - idle hosts are resource drainers, and hence, their numbers should be kept at a minimum. The test also monitors user sessions to the hosts in every pool, and reports the status of these sessions. Host pools with sessions in a disconnected or an ‘Unknown’ state are thus pinpointed. If any session is waiting too long to connect to a host, or there are one/more sessions that have abruptly logged off, then administrators are informed of the same, This way, the test draws administrator attention to host pools with ‘unhealthy’ hosts and sessions. Detailed diagnosis of the test, if enabled, lead administrators to the exact hosts in the pool that are in an abnormal state. Using the detailed metrics, you can also identify the hosts in the pool with sessions in an unhealthy state.

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.

• In the HOST text box, specify the HOST for which this test is to be configured.

• Specify the GUID which uniquely identifies the Microsoft Azure Subscription to be monitored in the SUBSCRIPTION ID text box.To know the ID that maps to the target subscription, click here.

• Specify the Directory ID of the Azure AD tenant to which the target subscription belongs in the TENANT ID text box. To know how to determine the Directory ID/Tenant ID, click here.

• The eG agent communicates with the target Microsoft Azure Subscrption using Java API calls. To collect the required metrics, the eG agent requires an Access token in the form of an Application ID and the client secret value.Specify the Application ID of the created Application in the CLIENT ID TEXTBOX To know how to determine the Application ID, click here. Specify the client secret value in the CLIENT PASSWORD text box. To obtain the client secret value, click here.

• In some environments, all communication with the Azure cloud be routed through a proxy server. In such environments, you should make sure that the eG agent connects to the cloud via the proxy server and collects metrics. To enable metrics collection via a proxy, specify the IP address of the proxy server and the port at which the server listens against the PROXY HOST and PROXY PORT parameters. By default, these parameters are set to none , indicating that the eG agent is not configured to communicate via a proxy, by default.

• If the proxy server requires authentication, then, specify a valid proxy user name and password in the PROXY USERNAME and PROXY PASSWORD parameters, respectively. Then, confirm the password by retyping it in the Confirm Password text box.

• By default, the Log Analytics Workspace Name parameter is set to All. This indicates that the test reads log data from all Log Analytics Workspaces configured for the target subscription, by default. However, if you want the test to use only those Log Analytics Workspaces to which a host pool's logs are sent, then provide the names of these workspaces here as a comma-separated list. To determine the names of the workspaces, do the following, click here. However, If the Log Analytics workspace column is blank for all the existing diagnostic settings, it is a clear indication that the host pool's logs are yet to be configured to be sent to any Log Analytics Workspace. In this case therefore, you should create a new diagnostic setting for the target host pool where a Log Analytics Workspace is configured as the destination for the logs. To achieve this, click here.

• By default, this test does not report detailed diagnostics for the ACTIVE SESSIONS measure. Accordingly, ACTIVE SESSION DD parameter is set to No by default.

  Typically, in large AVD roll-outs, this measure can report numerous records as part of detailed diagnostics. In such environments therefore, the detailed statistics for this measure can consume excessive space in the eG database. This default setting conserves valuable database space by ensuring that the test does not collect detailed metrics for the Active sessionsmeasure.

  However, If you have a well-sized and well-tuned eG database, you can configure the test to capture detailed metrics for this measure. To achieve this, set ACTIVE SESSION DD flag to Yes.

• By default, this test does not report detailed diagnostics for the DISCONNECTED SESSIONS measure. Accordingly, DISCONNECTED SESSION DD parameter is set to No by default. However, if needed, you can configure the test to capture detailed metrics for this measure. To achieve this, set this flag to Yes.

• By default, this test does not report detailed diagnostics for the UNKNOWN SESSIONS measure. Accordingly, UNKNOWN SESSIONS DD parameter is set to No by default. However, if needed, you can configure the test to capture detailed metrics for this measure. To achieve this, set this flag to Yes.

• By default, this test does not report detailed diagnostics for the LOGOFF SESSIONS measure. Accordingly, LOGOFF SESSIONS DD parameter is set to No by default. However, if needed, you can configure the test to capture detailed metrics for this measure. To achieve this, set this flag to Yes.

• By default, this test does not report detailed diagnostics for the PENDING SESSIONS measure. Accordingly, PENDING SESSIONS DD parameter is set to No by default. However, if needed, you can configure the test to capture detailed metrics for this measure. To achieve this, set this flag to Yes.

• By default, this test does not report detailed diagnostics for the USER PROFILE DISK MOUNT SESSIONS measure. Accordingly, USER PROFILE DISK MOUNT SESSIONS DD parameter is set to No by default. However, if needed, you can configure the test to capture detailed metrics for this measure. To achieve this, set this flag to Yes.

• 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.

• To make diagnosis more efficient and accurate, eG 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, by default, for a particular server, choose the On option against DETAILED DIAGNOSIS. 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 bad and normal 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 button will appear in this page. Clicking on this button 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.