With Argent you can monitor all Citrix performance counters, Citrix services, Citrix log files, and the Citrix TCP ports usage.
Here are some specific Rules you can use.
Logon Test
The Argent Guardian performs logon tests against Citrix servers. This verifies users can properly connect and logon to Citrix servers.
Logon tests are performed using the citrix_connect_test.exe utility located in:
drive:\ARGENT\ArgentManagementConsole\ArgentGuardian.
To use this utility, the Citrix client must be installed on the Argent Guardian monitoring engine server.
Create a file in drive:\ARGENT\ArgentManagementConsole\ArgentGuardian. named CITRIX_LOGON.TXT.
This file is used by citrix_connect_test.exe, and contains the server name, domain name, username, password, and timeout (in seconds) for each Citrix server being tested.
A sample CITRIX_LOGON.TXT file looks like this:
SERVER: SERVER1 DOMAIN: YOURDOMAIN USER: username1 PASSWORD: password1 TIMEOUT: 30 SERVER: SERVER2 DOMAIN: YOURDOMAIN USER: username2 PASSWORD: password2 TIMEOUT: 30 SERVER: SERVER3 DOMAIN: YOURDOMAIN USER: username3 PASSWORD: password3 TIMEOUT: 30
The syntax of citrix_connect_test.exe is:
citrix_connect_test.exe SERVERNAME
The utility reads necessary information for the specified server from CITRIX_LOGON.TXT and performs the logon test.
The utility will return 1 of 8 possible return codes:
1 – Connected Successfully
2 – Connection Failed
3 – Timeout
4 – Exception Error
5 – Logon Information For Server Not Found
6 – Initialization Error
7 – Citrix Client Ocx Not Found
8 – Invalid Argument
The utility is used in the Argent Guardian within a System Command Rule. The Command File contains the UNC path to citrix_connect_test.exe, followed by the %AGNodeName% variable:
\\ENGINE\ArgentGuardian\citrix_connect_test.exe %AGNodeName%
The rule should be configured to NOT break if the Exit Code of the process is equal to 1 (a successful connection to the Citrix server).
Configure the rest of the System Command Rule as desired. Argent recommends the Post Event Only After Rule Is Broken x Times option selected to avoid false alarms.
Use the new System Command Rule in a Relator — the Monitoring Group should contain all Citrix servers to monitor.