Free 30 Day Trial
Find the root-cause of your cloud, hybrid-cloudor on-prem performance issues
How Does eG Enterprise Monitor the Citrix Cloud Site?
eG Enterprise monitors the Citrix Cloud Site in an agentless manner. The eG agent should be deployed on the Citrix Cloud Connector host to monitor the Citrix Cloud Site.
The eG agent makes Cloud API calls to connect to the delivery controller on the Citrix Cloud and pull a wide variety of useful metrics pertaining to the controller. To enable the eG agent to connect to and monitor the controller, you need to configure the eG agent with the following details:
A valid customer ID: When configuring the Citrix Cloud service, you should have created an API client on the cloud, so that any external program can communicate with the cloud. This API client is tied to a customer ID. The Citrix Cloud API requires this customer ID, when making the API calls. To get the customer ID for the API client that you have created in your environment, do the following:
Select “Identity and Access Management” from the drop-down menu. An API Access page (see Figure 1 ) will open in the right panel. Look for the phrase , "use <customerID> as the customer parameter" in the right panel. The <customerID> displayed within that phrase (as highlighted in Figure 1) is the customer ID you need to configure the eG tests with.
The path to the secure client file: When creating the API client on the cloud, you will be provided with an ID and a Secret for your client. Downloading this information saves a file named secureclient.csv. The eG agent uses the ID and Secret stored in this file to connect to the Citrix Cloud API. This is why, you will have to configure every test mapped to the Citrix Cloud Site component with the full path to the secureclient.csv.
A valid Citrix cloud user with rights to access the cloud and pull metrics on critical cloud components: The secureclient.csv file mentioned above should be downloaded by a Citrix cloud user, with permissions to connect to the cloud and gather performance metrics on critical parts of the cloud (e.g., domains, secure clients, virtual apps/desktops etc.). The API client automatically inherits the 'access rights' defined for the user who downloads the secureclient.csv file. Since the eG agent communicates with the Citrix cloud via this API client, the agent naturally, will be allowed the same level of access as the client. This enables the eG agent to access and monitor the cloud seamlessly.
To create such a user on the Citrix cloud, follow the steps below:
Select “Identity and Access Management” from the drop-down menu. Click on the Administrators tab page in the page that appears (see Figure 2). Then, in the text box that is highlighted in Figure 2, specify the email ID of the new user who needs to be allowed cloud access. To invite that user, click on the Invite button next to the text box.
Figure 3 will then appear. Using Figure 3, you can define the access rights of the new user. For this, first select the Custom access option from Figure 3. Then, click on the General check box in Figure 3, so that the user is granted access to all the basic configurations on the cloud such as domains, libraries, licenses, secure clients etc. These General settings are displayed in Figure 4.
Next, allow the user Read-only Administrator access to all virtual apps and desktops. For that, scroll down Figure 4, so that the Virtual Apps and Desktops group becomes visible. Expand the group and select the check box alongside Read Only Administrator, All (see Figure 5).
Finally, click the Send Invite button in Figure 3, so that the invite is emailed to the new user. Once the invite is received, the user should follow the link in the invite to setup their login credentials. Then, using those credentials, the user should login to the cloud, and download the secureclient.csv file.
First, specify the proxy details that the user uses in the Internet Explorer settings. To achieve this, click on the icon provided at the right corner of the Internet Explorer window.
Clicking the icon will invoke a menu in which choose Internet Options. Then, select the Connections tab in the Internet Options window that appears (see Figure 2).
Figure 6 : The Connections tab in the Internet Options window
Now, click the LAN Settings button in Figure 2. This will open the Local Area Network (LAN) Settings window (see Figure 3). In the Proxy Server section of this window, enable the Use a proxy server for your LAN check box and specify the IP address and port of the proxy server that the current user uses to communicate with the cloud connector in the Address and Port text boxes. Finally, click the OK button to register the changes.
Figure 7 : Specifying proxy server details
Next, run the following command from the command prompt to import the assigned settings to the eG agent.
C:\Windows\System32\bitsadmin.exe /util /setieproxy LOCALSYSTEM MANUAL_PROXY <PROXY_IPADDRESS/PROXY_HOSTNAME:PROXY_PORT> "<local>"
C:\Windows\System32\bitsadmin.exe /util /setieproxy LOCALSYSTEM MANUAL_PROXY 192.168.10.1:8080 " <local>"
C:\Windows\System32\bitsadmin.exe /util /setieproxy LOCALSYSTEM MANUAL_PROXY xyz.proxy.com:8080 " <local>"
You can remove the proxy settings that you provided in the Internet Explorer settings after the proxy settings are imported to the eG agent.