EUC Platform Monitoring Tool

Project Desription

This is a EUC monitoring platform that is based on Powershell and FREE! It will check all the key components of your End User Compute Estate and give you a visual dashboard as to the current state. It is currently focussed on Citrix but will eventually be branched out to cover VMware and Microsoft Technologies.

Motivation

The reason I started writing this is because I wanted a platform that will give you a high level, birds eye view of whats happening on your End User Compute Estate. More importantly I wanted it to be free! There are a number of products out there that can give you a lot of detail about whats happening but none that give you an overview of everything. Thats what this is intended to resolve. It will automate and take away the steps that you normally do day to day on your estate and give you all of that information in a nice visual dashboard.

Installation

To install and run this software follow these steps

Pre-requisites

(On-Premises)

The Server that you want to run this script from must have the XenServer and XenDesktop PowerShell SDK Installed. Install Citrix Studio on the monitoring server and also install the XenServer SDK from the XenServer 7.2 Standard Edition download page.

(Cloud) The Server that you want to run this script from must have the Remote PowerShell SDK for Applications and Desktops Service from: http://download.apps.cloud.com/CitrixPoshSdk.exe

Obtain a Citrix Cloud automation credential as follows:

• Login to https://citrix.cloud.com/
• Navigate to "Identity and Access Management".
• Click "API Access".
• Enter a name for Secure Client and click Create Client.
• Once Secure Client is created, download Secure Client Credentials file (ie. downloaded to C:\Monitoring)

Note the Customer ID located in this same page, this is case senstitive. Set-XDCredentials -CustomerId "%Customer ID%" -SecureClientFile "C:\Monitoring\secureclient.csv" -ProfileType CloudApi -StoreAs "CloudAdmin"

Installation steps

1. Open up PowerShell on the machine you want to use for monitoring.
2. Run the following to locate on PSGallery

Find-Module EUCMonitoring

3. Run the following command to install the EUC Monitoring Module.

   • Install for Allusers (Need to be run as Administrator)

     Install-Module EUCMonitoring
     

   • Install for Currentuser

     Install-Module EUCMonitoring -Scope CurrentUser
     

4. Next run the following command pointing to a directory that you want the EUC Monitoring setting files and output HTML to reside.

   • Run this for manual configuration.

     Set-EUCMonitoring C:\Monitoring -verbose
     

   • Or, for new users, or those who prefer the defaults. This will ask you a few questions about your environment.

     Set-EUCMonitoring C:\Monitoring -QuickConfig -verbose
     

5. If manually configuring, go to that directory and rename the euc-monitoring.json.template file to euc-monitoring.json

6. Edit the json file to reflect your environment. You can always regenerate a new json file with

New-EUCMonitoringConfig C:\Monitoring 

7. Finally run the following command pointing to the directory that holds the needed files

cd C:\Monitoring
Start-XDMonitor

OR

Start-XDMonitor -JsonFile ".\mysettings.json" -LogFile ".\mylog.txt" -CSSFile ".\euc-monitor.css" -Verbose 

8. Open up your new dashboard HTML file from the location you specified in your json for web data output

Active Contributors

Dave Brett @dbretty | James Kindon @james_kindon | Ryan Butler @ryan_c_butler | David Wilkinson @WilkyIT | Adam Yarborough @littletoyrobots