Skip to main content

Configuration

Instalation

Copy the plugin in the plugin directory of agent or distributing by file collections. Same with the config files. The execution from the agent will be similar to this, but using the paths where the plugin and confs are installed. 

module_plugin "<powershell-path>\powershell.exe" -file C:\'<plugin-path>\pandora_citrix.ps1' -perf C:\'<conf-path>\counters_data.txt' -serv C:\'<conf-path>\services.txt’ -inc C:\'<conf-path>\counters_inc.txt' 2> error.log

If we want no monitor any perf counter or only a specific type, would have to carry out these executions:

  • Only with generic_data counters: 
module_plugin "<powershell-path>\powershell.exe" -file C:\'<plugin-path>\pandora_citrix.ps1' -perf C:\'<conf-path>\counters_data.txt' -serv C:\'<conf-path>\services.txt' 2> error.log
  • Only with generic_inc counters: 
module_plugin "<powershell-path>\powershell.exe" -file C:\'<plugin-path>\pandora_ citrix.ps1' -perf none -serv C:\'<conf-path>\services.txt'   -inc C:\'<conf-path>\counters_inc.txt'' 2> error.log
  • Without counters: 
module_plugin "<powershell-path>\powershell.exe" -file C:\'<plugin-path>\pandora_ citrix.ps1' -perf none -serv C:\'<conf-path>\services.txt' 2> error.log
  • With counters and without services: 
module_plugin "<powershell-path>\powershell.exe" -file C:\'<plugin-path>\pandora_ citrix.ps1' -perf C:\'<conf-path5>\counters_data.txt' -inc C:\'<conf-path>\counters_inc.txt' 2> error.log

Configuration

First of all we have enabled the plugin execution from powershell For this, we must run this command in a powershell terminal: 

set-executionPolicy -Scope Process -ExecutionPolicy Bypass

or

set-executionPolicy RemoteSigned

If we run the plugin from the terminal and returns the information correctly, but if you execute it in from Pandora agent and returns no results, and in debug mode tells us that remote_signed not enabled, we should add the next module to be activated within the execution of the agent. This, you have to add only the first time, then stay enabled and we won´t have problems. 

module_begin 
module_name Remote_signed 
module_type generic_data_string 
module_exec powershell.exe –command set-executionPolicy -Scope Process -ExecutionPolicy bypass 
module_end

or

module_begin 
module_name Remote_signed 
module_type generic_data_string
module_exec powershell.exe -command set-executionPolicy RemoteSigned 
module_end

As we noted in the plugin implementation, it is accompanied by two or three configuration files, one with the name of the services and another two as the name of the performance counters to be monitored. At one we indicate the counters that we can see as generic_data type and in the second we will use the incremental type (generic_data_inc). In the event that the incremental type is not used should not be added at runtime. Each service, each performance counter should be on one line and if If you do not want monitor any counter or service, delete it from the list.

Configuration files examples 

Services.txt 

Citrix Independent Management Architecture
Citrix XML
Citrix XTE Server
Citrix CPU Utilization Management/Resource Management
Citrix CPU Utilization Management/User Session sync
Citrix CPU Utilization Management/CPU Rebalancer Services states
Citrix Print Manager
Citrix Virtual Memory Optimization
Citrix MF COM Remote Desktop Services/Terminal Services
Citrix WMI
Citrix Client Network
Citrix Streaming/Citrix Streaming Helper
Server
Netlogon
Remote Procedure Call (RPC)
Workstation
Print Spooler

Counters_data.txt 

\Processor(*)\% Processor Time
\System\Processor Queue Length
\Memory\Available Bytes
\Memory\Pages /sec
\Paging File\% Usage
\PhysicalDisk(_Total)\% Free Space
\LogicalDisk(_Total)\% Free Space
\LogicalDisk(_Total)\% Disk Time
\PhysicalDisk(_Total)\Current Disk Queue Length
\LogicalDisk(_Total)\Current Disk Queue Length
\LogicalDisk(_Total)\ Avg. Disk Sec/Read
\LogicalDisk(_Total)\ Avg. Disk Sec/Write
\LogicalDisk(_Total)\ Avg. Disk Sec/Transfer
\PhysicalDisk(_Total)\ Avg. Disk Sec/Read
\PhysicalDisk(_Total)\ Avg. Disk Sec/Write
\PhysicalDisk(_Total)\ Avg. Disk Sec/Transfer
\Citrix MetaFrame Presentation Server\Application Resolution Time (ms)
\Citrix MetaFrame Presentation Server\DataStore Connection Failure
\Citrix MetaFrame Presentation Server\Number of busy XML threads
\Citrix MetaFrame Presentation Server\Resolution WorkItem Queue Ready Count
\Citrix MetaFrame Presentation Server\WorkItem Queue Ready Count
\Citrix Licensing\Citrix Licensing - License Server Connection Failure
\Citrix Licensing\Citrix Licensing - Last Recorded License Check - Out Response Time
\Process(ImaSrv)\Private Bytes

Back to top