Workspace Environment Management

Troubleshoot VDA registration and session launch issues using scripted tasks

As an administrator, you might want to proactively discover issues related to Virtual Delivery Agents (VDAs) in your deployment. This insight can help you resolve issues in time before your users are affected.

Workspace Environment Management (WEM) provides a built-in scripted task, Cloud Health Check, that lets you run checks to gauge the health of VDAs. Using the task, you can identify possible causes for VDA registration and session launch issues. Each time the task runs, a detailed health check report is generated. Based on the report, you can analyze and resolve issues accordingly.

A general workflow to configure the task is as follows:

  1. Create a scheduled trigger.

  2. Associate the trigger with the Cloud Health Check task.

  3. View the health check report.

Create a scheduled trigger

The following information is supplemental to the guidance in Create a trigger. To add a scheduled trigger, follow the general guidance in that article, minding the details below.

Go to the relevant configuration set, navigate to Triggers, and create a trigger as follows:

Trigger type - scheduled

In this example:

  • Name the trigger DailyRunTrigger.

  • For Trigger type, select Scheduled.

  • For Date and time, configure the task to run at 02:00, April 4, 2023.

  • For Repeat, configure the task to run every day.

Associate the trigger with the Cloud Health Check task

The following information is supplemental to the guidance in Configure a scripted task. To configure the Cloud Health Check task, follow the general guidance in that article, minding the details below.

Go to the relevant configuration set, navigate to Scripted Task Settings, and configure the Cloud Health Check task as follows:

Trigger for Cloud Health Check

In this example, select the scheduled trigger DailyRunTrigger to associate it with the Cloud Health Check task.

View the health check report

The Cloud Health Check task runs at the scheduled time. After it completes, you can view the health check results by checking the reports. For more information, see Reports.

Health check report

In Web Console > Home > Overview, you can get an overview of VDA health status. To view VDA health status in detail:

  • Click View under Normal to see reports about VDAs in normal state.

  • Click View under Unusual to see reports about VDAs in unusual state.

VDA health status

The reports about VDAs in unusual state include issues found and fix recommendations. You can resolve the issues accordingly.

Run the Cloud Health Check task on demand

WEM also provides a method to run the task on an agent machine on demand. To do that, perform the following steps:

  1. Go to Monitoring > Administration > Agents, select the agent, and select More > Run scripted task.

    Run scripted task

  2. In the wizard that appears, select Cloud Health Check as the task and then click Run.

    Run scripted task

  3. After the task completes, you can view the health check results by checking the reports. For more information, see Reports.

Troubleshoot VDA registration and session launch issues using scripted tasks