Citrix NetScaler is an all-in-one web application delivery controller (ADC) that makes applications run up to five times faster, cuts web application ownership costs with server offloading, and makes sure that applications are always available with its application load balancing capabilities.
NetScaler VPX provides the complete NetScaler web and application load balancing, secure and remote access, acceleration, security and offload feature set in a simple, easy-to-install virtual appliance.
The AppDynamics monitoring extension for NetScaler provides metrics collected by the NetScaler appliance about the usage of its features and corresponding resources using the NITRO API. These metrics can be classified under the following groups:
Core System Metrics
Service Resource metrics
Load Balancing metrics
Before the extension is installed, the prerequisites mentioned here need to be met. Please do not proceed with the extension installation if the specified prerequisites are not met.
The extension needs to be able to connect to the NetScaler NITRO API in order to be able to collect and send the metrics. To do this, you will have to either establish a remote connection in between the extension and the product, or have an agent on the same machine running the product in order for the extension to collect and send the metrics.
The NetScaler extension connects to the Citrix Netscaler appliance using the NITRO REST API.
<MachineAgent_Dir>/monitors/The metricPrefix of the extension has to be configured as specified here. Please make sure that the right metricPrefix is chosen based on your machine agent deployment, otherwise this could lead to metrics not being visible in the controller.
Here is a sample config.yml file
|Custom Metrics|Netscaler Monitor|" servers: - name: "" host: "" port: "" username: "" password: "" encryptedPassword: "" encryptionKey: numberOfThreads: 20
Configure the path to the config.yml & metrics.xml by editing the
<MACHINE_AGENT_HOME>/monitors/NetScalerMonitor/ directory. Below is the sample
<task-arguments> <!-- config file--> <argument name="config-file" is-required="true" default-value="monitors/NetScalerMonitor/config.yml" /> <argument name="metric-file" is-required="true" default-value="monitors/NetScalerMonitor/metrics.xml" /> .... </task-arguments>
Here is a summary of the metrics published by this extension. You can add/remove metrics of your choosing by modifying the provided metrics.xml file by using the correct stat names as per the Citrix documentation
Please visit this page to get detailed instructions on password encryption. The steps in this document will guide you through the whole process.
Workbench is an inbuilt feature provided with each extension in order to assist you to fine tune the extension setup before you actually deploy it on the controller. Please review the following document for how to use the Extensions WorkBench
Please look at the troubleshooting document and make sure that everything is followed correctly.
If after going through the Troubleshooting Document you have not been able to get your extension working, please file a ticket and add the following information.
Please provide the following in order for us to assist you better.
<logger name="com.singularity"> <logger name="com.appdynamics">
For any support related questions, you can also contact email@example.com.
Always feel free to fork and contribute any changes directly via GitHub.
|Product Tested On||NetScaler VPX 10.x on AWS|
|List of Changes||Change log|
v1.0.3 - Updated to work with MachineAgent 21.x