Citrix Virtual Apps and Desktops service

Monitor in Quick Deploy

From the Monitor dashboard, you can view desktop usage, sessions, and machines in your Citrix Virtual Apps and Desktops deployment. You can also control sessions, power-manage machines, end running applications, and end running processes.

To access the Monitor dashboard:

  1. Sign in to Citrix Cloud, if you haven’t already. In the upper left menu, select My Services > Virtual Apps and Desktops.
  2. From the Manage > Quick Deploy dashboard, select the Monitor tab.

Monitor desktop usage

The service usage page appears by default when you select the Monitor tab. Displays on this page refresh every five minutes.

  • Machine and Sessions Overview: You can tailor the display to show information about all catalogs (default) or a selected catalog. You can also tailor the time period: the last day, week, month, or three months.

    Counts at the top of the display indicate the total number of machines, plus the number of machines that are powered-on and powered-off. Hover over a value to display how many are single-session and multi-session.

    The graph below the counts shows the number of powered-on machines and peak concurrent sessions at regular points during the time period you selected. Hover on a point the graph to display the counts at that point.

    Machines and Sessions Overview display

  • Top 10s: To tailor a top 10 display, select a time period: the past week (default), month, or three months. You can also tailor the display to show only information about activity involving single-session machines, multi-session machines, or applications.

    • Top 10 Active Users: Lists the users who started desktops most frequently during the time period. Hovering on a line displays the total launches.
    • Top 10 Active Catalogs: Lists the catalogs with the longest duration during the selected time period. Duration is the sum of all user sessions from that catalog.

Desktop usage report

To download a report containing information about machine launches during the last month, select Launch Activity. A message indicates that the request is being processed. The report downloads automatically to the default download location on the local machine.

Filter and search to monitor machines and sessions

When you’re monitoring session and machine information, all machines or sessions are displayed by default. You can:

  • Filter the display by machines, sessions, connections, or applications.
  • Refine the display of sessions or machines by choosing the criteria you want, building a filter by using expressions.
  • Save the filters that you build, for reuse.

Control a user’s applications

You can display and manage applications and processes for a user that has a running session or an assigned desktop.

  1. From the Monitor dashboard in the service, select Search and enter the user name (or the beginning characters of the user name), machine, or endpoint. From the search results, select the item you’re looking for. (To collapse the search box without searching, select Search again.)
  2. Select a session.

    Find a user's session in Monitor dashboard

    The Activity Manager lists the applications and processes for the user’s session.

  3. To end an application, on the Applications tab in Activity Manager, select in the application’s row to select that application, and then select End Application.

    End a user's application in Monitor dashboard

  4. To end a process, on the Processes tab in Activity Manager, select in the process’s row to select that process, and then select End Process.
  5. To display session details, select Details in the upper right. To return to the applications and processes display, select Activity Manager in the upper right.
  6. To control the session, select Session Control > Log Off or Session Control > Disconnect.

Shadow users

Use the shadow feature to view or work directly on a user’s virtual machine or session. You can shadow Windows and Linux VDAs. The user must be connected to the machine that you want to shadow. Verify this by checking the machine name listed in the User title bar.

Shadowing launches in a new browser tab. Ensure that your browser allows pop-ups from the Citrix Cloud URL.

Shadowing is supported only for users on domain-joined machines. To shadow a non-domain-joined machine, you must set up a bastion machine. For details, see Bastion access.

Shadowing must be initiated from a machine on the same virtual network as the domain-joined machines, and also meet any port requirements.

Enable shadowing

  1. From Manage > Quick Deploy > Monitor, go to the User Details view.
  2. Select the user session, and then select Shadow in the Activity Manager view or the Session Details panel.

Shadow Linux VDAs

Shadowing is available for Linux VDAs Version 7.16 or and later running the RHEL7.3 or Ubuntu Version 16.04 Linux distributions.

Monitor uses the FQDN to connect to the target Linux VDA. Ensure that the Monitor client can resolve the FQDN of the Linux VDA.

  • The VDA must have the python-websockify and x11vnc packages installed.
  • noVNC connection to the VDA uses the WebSocket protocol. By default, ws:// WebSocket protocol is used. For security reasons, Citrix recommends that you use the secure wss:// protocol. Install SSL certificates on each Monitor client and Linux VDA.

Follow the instructions in Session Shadowing to configure your Linux VDA for shadowing.

  1. After you enable shadowing, the shadowing connection initializes and a confirmation prompt appears on the user device.
  2. Instruct the user to select Yes to start the machine or session sharing.
  3. The administrator can view only the shadowed session.

Shadow Windows VDAs

Windows VDA sessions are shadowed using Windows Remote Assistance. Enable the Use Windows Remote Assistance feature when installing the VDA.

  1. After you enable shadowing, the shadowing connection initializes and a dialog box prompts you to open or save the .msrc incident file.
  2. Open the incident file with the Remote Assistance Viewer, if it’s not already selected by default. A confirmation prompt appears on the user device.
  3. Instruct the user to select Yes to start the machine or session sharing.
  4. For more control, ask the user to share keyboard and mouse control.

Monitor and control sessions

Session displays are updated every minute.

In addition to viewing sessions, you can disconnect one or more sessions or log off users from sessions.

  1. From Manage > Quick Deploy > Monitor, select Filters.

    Filter Monitor displays

  2. Select the Sessions view. Sessions display on Monitor dashboard

  3. To tailor the display, select Choose Columns and select the check boxes of items you want to appear. When you’re done, select OK. The sessions display refreshes automatically.

    Columns you can display in the Monitor dashboard sessions view

  4. Select the check box to the left of each session you want to control.
  5. To log off or disconnect the session, elect either Session Control > Log Off or Session Control > Disconnect.

Remember that the power management schedule for the catalog can also control disconnecting sessions and logging off users from disconnected sessions.

As an alternative to the above procedure you can also Search for a user, select the session you want to control, and then display session details. The log off and disconnect options are available there, too.

Session information report

To download session information, select Export on the sessions display. A message indicates that the request is being processed. The report downloads automatically to the default download location on the local machine.

Monitor and power control machines

Machine displays are updated every minute.

  1. From Manage > Quick Deploy > Monitor, select Filters.
  2. Select the Machines view.

    Machines display in Monitor dashboard

    By default, the display lists single-session OS machines. Alternatively, you can display multi-session machines.

  3. To tailor the display, select Choose Columns and select the check boxes of items you want to appear. When you’re done, select OK. The machines display refreshes automatically.

    Columns you can display in the Monitor dashboard machines view

  4. To power-control machines or place them in or out of maintenance mode, select the check box to the left of each machine you want to control.
  5. To power-control the selected machines, select Power Control and select an action.

    Power manage machines from the Monitor dashboard

  6. To place the selected machines in or out of maintenance mode, select Maintenance Mode > ON or Maintenance Mode > OFF.

When you use the search feature to find and select a machine, you see machine details, utilization, historical utilization (from the last seven days), and average IOPS.

Machine information report

To download session information, select Export on the machines display. A message indicates that the request is being processed. The report downloads automatically to the default download location on the local machine.

Checking app and desktop health

Probing automates the process of checking the health of published apps and desktops. The health check results are available through the Monitor dashboard. For details, see:

Monitor in Quick Deploy