Product Documentation

Infrastructure Analytics

A key goal for network administrators is to monitor Citrix ADC instances. ADC instances offer interesting insights into usage and performance of applications and desktops accessed through it. Administrators must monitor the ADC instance as well as analyze the application flows processed by each ADC instance. They should also be able to remediate any probable issues in configuration, setup, connectivity, certificates, and others which might impact application usage or performance. For example, a sudden change in application traffic pattern can be due to change in SSL configuration like disabling of an SSL protocol. Administrators must be able to quickly identify the correlation between these data points to ensure the following:

  • Application availability is in an optimal state
  • There are no resource consumption, hardware, capacity, or configuration change issues
  • There are no unused inventories
  • There are no expired certificates

Infrastructure Analytics feature simplifies the process of data analysis by correlating multiple data sources and quantifying it to a measurable score that defines the health of an instance. With this feature, the administrators get a single touch point to understand if there is a problem, the origin of the problem, and probable remediations that they can perform.

Infrastructure analytics in Citrix ADM

The Citrix Application Delivery Management (ADM) Infrastructure analytics feature collates all the data gathered from the Citrix ADC instances and quantifies it into an Instance Score that defines the health of the instances. The instance score is summarized over tabular view or as circle pack visualization. The Infrastructure Analytics feature helps you to visualize the factors that resulted or might result in an issue on the instances. This visualization also helps you to determine the actions that must be performed to prevent the issue and its recurrence.


Infrastructure analytics display only those instances that have at least one licensed virtual server configured in them.

Instance score

Instance score indicates the health of an ADC instance. A score of 100 means a perfectly healthy instance without any issues. Instance score captures different levels of potential issues on the instance. It is a quantifiable measurement of instance health and multiple “health indicators” contribute to the score.

Health indicators are the building blocks of the instance score, where the score is computed periodically for a predefined “monitoring period,” based on all detected indicators in that time window. Currently, Infrastructure analytics calculates the instance score once every hour based on the data collected from the instances. An indicator can be defined as any activity (an event or an issue) that belongs to one of the following categories on the instances.

  • System resource indicators
  • Critical events indicators
  • SSL configuration indicators
  • Configuration deviation indicators

Health indicators explained

  • System resources indicators

    The following are the critical system resource issues that might occur on Citrix ADC instances and monitored by Citrix ADM.

    • High CPU usage. The CPU usage has crossed the higher threshold value in the Citrix ADC instance.

    • High memory usage. The memory usage has crossed the higher threshold value in the Citrix ADC instance.

    • High disk usage. The disk usage has crossed the higher threshold value in the Citrix ADC instance.

    • Disk errors. There are errors on hard disk 0 or hard disk 1 on the hypervisor where the ADC instance is installed.

    • Power failure. The power supply has failed or disconnected from the ADC instance.

    • SSL card failure. The SSL card installed on the instance has failed.

    • Flash errors. There are Compact Flash Errors seen on the Citrix ADC instance.

    • NIC discards. The packets discarded by the NIC card have crossed the higher threshold value in the Citrix ADC instance.

For more information on these system resources errors, see Instance dashboard.

  • Critical events indicators

    The following critical events are identified by the events under event management feature of ADM that are configured with critical severity.

    • HA sync failure. Configuration sync between the ADC instances in high availability has failed on the secondary server.

    • HA no heartbeats. The primary server in a pair of ADC instances in high availability is not receiving heart beats form the secondary server.

    • HA bad secondary state. The secondary server in a pair of ADC instances in high availability is in Down, Unknown, or Stay secondary state.

    • HA version mismatch. The version of the ADC software images installed on a pair of ADC instances in high availability does not match.

    • Cluster sync failure. Configuration sync between the ADC instances in cluster mode has failed.

    • Cluster version mismatch. The version of the ADC software images installed on the ADC instances in cluster mode does not match.

    • Cluster propagation failure. Propagation of configurations to all instances in a cluster has failed.


      You can have your list of critical SNMP events by changing the severity levels of the events. For more information on how to change the severity levels, see Modify the reported severity of events that occur on Citrix ADC instances.

    For more information on events in Citrix ADM, see Events.

  • SSL configuration indicators

    • Not recommended key strength. The key strength of the SSL certificates is not as per Citrix standards

    • Not recommended issuer. The issuer of the SSL certificate is not recommended by Citrix.

    • SSL certs expired. The SSL certificate installed in the ADC instance has expired.

    • SSL certs expiry due. The SSL certificate installed in the ADC instance is about to expire in the next one week.

    • Not recommended algorithms. The signature algorithms of SSL certificates installed in the ADC instance are not as per Citrix standards.

For more information on SSL certificates, see SSL dashboard.

  • Configuration deviation indicators

    • Config drift template. There is a drift (unsaved changes) in configuration from the audit templates that you have created with specific configurations you want to audit on certain instances.

    • Config drift default. There is a drift (unsaved changes) in configuration from the default configuration files.

For more information on configuration deviations and how to run audit reports to check configuration deviation, see View audit reports.

Value of health indicators

The indicators are classified into high priority indicators and low-priority indicators based on their values as follows:

localized image

The health indicators within the same group of indicators have different weights assigned to them. One indicator might contribute more to lowered instance score than another indicator. For example, high memory usage brings down the instance score more than high disk usage, high CPU usage, and NIC discard. If an instance has a greater number of indicators detected on it, the lesser is the instance score.

The value of an indicator is calculated based on the following rules. The indicator is said to be detected in one of the following three ways:

  1. Based on an activity. For example, a System resource indicator is triggered whenever there is a power failure on the instance, and this indicator reduces the value of the instance score. When the indicator is cleared the penalty is cleared, and the instance score increases.

  2. Based on the threshold value breach. For example, a System resource indicator is triggered when the NIC card discards packets and the threshold level is breached.

  3. Based on the low and high threshold value breach. Here, an indicator can be triggered in two ways:

    • When the value of the indicator is between low and high thresholds, in which case a partial penalty is levied on the instance score.

    • When the value crosses the high threshold, in which case a full penalty is levied on the instance score.

    • No penalty is levied on the instance score if the value falls below a low threshold.

For example, CPU usage is a system resource indicator triggered when the usage value crosses the low threshold and also when the value crosses the high threshold.

Infrastructure analytics dashboard

Navigate to Networks > Infrastructure Analytics.

The Infrastructure Analytics can be viewed in a Circle Pack format or a Tabular format. You can toggle between the two formats.

localized image

  • In the Tabular view, you can search for an instance by typing the host name or the IP address in the Search bar.
  • By default, Infrastructure Analytics page displays the Summary Panel on the right side of the page.
  • Click the Settings icon to display the Settings Panel.
  • In both the view formats, the Summary Panel displays details of all the instances in your network.

Circle pack view

Circle packing diagrams show instance groups as tightly organized circles. They often show hierarchies where smaller instance groups are either colored similarly to others in the same category, or nested within larger groups. Circle packs represent hierarchical data sets and shows different levels in the hierarchy and how they interact with each other.

localized image

Instance circles

Color. Each instance is represented in Circle Pack as a colored circle. The color of the circle indicates the health of that instance.

  • Green - instance score is between 100 and 80. The instance is healthy.
  • Yellow - instance score is between 80 and 50; some issues have been noticed and in need of review.
  • Red - instance score is below 50. The instance is in a critical stage as there are multiple issues noticed on that instance.

localized image

Size. The size of these colored circles indicates the number of virtual servers configured on that instance. A bigger circle indicates that there are a greater number of virtual servers.

You can hover the mouse pointer on each of the instance circles (coloured circles) to view a summary. The hover tool tip displays the host name of the instance, the number of active virtual servers and the number of applications configured on that instance.

localized image

Grouped instance circles

The Circle Pack at the outset, comprises instance circles that are grouped, nested, or packed inside another circle based on the following criteria:

  • the site where they are deployed
  • the type of instances deployed - VPX, MPX, SDX, and CPX
  • the virtual or physical model of the ADC instance
  • the ADC image version installed on the instances

The following image shows a Circle Pack where the instances are first grouped by the site or data center where they are deployed, and then they are further grouped based on their type, VPX, and MPX.

localized image

All these nested circles are bounded by two outermost circles. The outer two circles represent the four categories of events monitored by the Citrix ADM (system resources, critical events, SSL configuration, and configuration deviation) and the contributing health indicators.

Clustered instance circles

Citrix ADM monitors many instances. To ease the monitoring and maintenance of these instances, Infrastructure Analytics allows you to cluster them at two levels. That is, the instance groupings can be nested within another grouping.

For example, the BLR data center has two types of ADC instances - VPX and MPX, deployed in it. You can first group the ADC instances by their type and then group all instances by the site where they are grouped. You can now easily identify how many types of instances are deployed in the sites that you are managing.

localized image

localized image

A few more examples of two-level clustering are as follows:

Site and model:

localized image

Type and version:

localized image

Site and version:

localized image

How to use Circle Pack

Click on each of the colored circle to highlight that instance.

localized image

Depending on the events that have occurred in that instance, only those health indicators are highlighted on the outer circles. For example, the following two images of the Circle Pack display different sets of risk indicators, though both instances are in a critical state.

localized image

You can also click the health indicators to get more details on the number of instances that have reported that risk indicator. For example, click “Not recommended Algo” to view the summary report of that risk indicator.

localized image

Tabular view

The tabular view displays the instances and the details of those instances in a tabular format. The details that are displayed are as follows:

  • Host name of the instance
  • The IP address of the instance
  • State of the instance
  • Instance score
  • Number of virtual servers configured on that instance
  • Number of applications configured on that instance
  • Total number of risk indicators
  • The event that is contributing more to a lowered instance score

The instances that are in the critical state are at the top of the table, followed by the instances that need to be reviewed and then the healthier instances.

localized image

Click the instance IP address in the tabular view to see more details of that instance as a dashboard display. The instance dashboard presents an overview of the instance where you can see the CPU, memory, and the disk usage of the instance. You can also see details related to SSL certificate management, config audit, network functions, and a network report that shows detailed network usage of the instance. Scroll down further to see the list of the features and the modes enabled on this instance.

localized image

You can also click on the arrow at the beginning of each row to expand the row for more details.

localized image

The expanded table row displays the errors that have occurred on the instance for all the categories. In the example above, you can view that there have been errors in system resources, SSL configuration, and deviations in configuration files. But there are no critical events reported from the instance.

How to use the summary panel

The Summary panel assists you in efficiently and quickly focuses on the instances that are in need of review or critical state. The panel is divided into three tabs - overview, instance info, and traffic profile. The changes you make in this panel modifies the display in both Circle Pack and Tabular view formats. The following sections describe these tabs in more detail. The examples in the following sections assist you to use the different selection criteria efficiently to analyze the issues reported by the instances.


The Overview tab allows you to monitor the instances based on the hardware errors, usage, expired certificates and similar indicators that can occur in the instances. The indicators that you can monitor here are as follows:

  • CPU usage
  • Memory usage
  • Disk usage
  • System failures
  • Critical events
  • SSL certificates expiry

For more information on these indicators, see Health indicators in Citrix ADC instances.

The following examples illustrate how you can interact with the Overview panel to isolate those instances that are reporting errors.

Example 1: View instances that are in a review state:

Select Review check box to view only those instances that are not reporting critical errors, but still needs attention.

The Histograms in the Overview panel represent an aggregated number of instances based on high CPU usage, high memory usage, and high disk usage events. The Histograms are graded at 10%, 20%, 30%, 40%, 50%, 60%, 70%, 80%, 90%, and 100%. Hover your mouse pointer on one of the bar charts. The legend at the bottom of the chart displays the usage range and the number of instances in that range. You can also click the bar chart to display all the instances in that range.

Example 2: View instances that are consuming between 10% and 20% of the allocated memory:

In the memory usage section, click the bar chart. The legend shows that the selected range is 10–20% and there are 29 instances operating in that range.

You can also select multiple ranges in these histograms.

Example 3: View instances that are consuming memory in multiple ranges:

To view instances that have consumed memory between 10% and 30% of the allocated memory, click and drag the mouse pointer over the two ranges as shown in the following image.

localized image


Click “X” to remove the selection. You can also click Reset to remove multiple selections.

The horizontal bar charts in the Overview panel indicate the number of instances that report system errors, critical events, and expiry status of the SSL certificates. Select the check box to view those instances.

Example 4: View instances for expired SSL certificates:

In the SSL certificates expiry section, select Expired check box to view the three instances.

localized image

Instance info

The Instance Info panel allows you to view instances based on the type of deployment, instance type, model, and software version. You can select multiple check boxes to narrow down your selection.

Example 5: View ADC VPX instances deployed in high availability:

Select both VPX type and HA deployment check boxes.

localized image

Traffic profile

The Histograms in the Traffic profile panel represent an aggregated number of instances based on the licensed throughput on the instances, number of requests, connections, and transactions handled by the instances. Select the bar chart to view instances in that range.

Example 6: View instances processing HTTP requests:

To view the number of instances handling up to 200 K HTTP requests per second, hover the mouse pointer on the bar chart to read the legend and click the bar chart.

localized image

Example 7: View instances supporting TCP connections:

The following image shows the number of instances supporting TCP connections between 23 and 40, and also processing up to 100 SSL transactions per second.

localized image

How to use the settings panel

The Settings panel allows you to set the default view of the Infrastructure Analytics. It also allows you to set the low and high threshold values for high CPU usage, high disk usage, and high memory usage. The settings panel is divided into two tabs - View and Score Thresholds.


  • Default View. Select Circle Pack or Tabular format as the default view on the analytics page. The format you select is what you see whenever you access the page in Citrix ADM.
  • Circle Pack - Instance Size. Allow the size of the instance circle to by either the number of virtual servers or the number of active virtual servers.
  • Circle Pack - Cluster By. Decide the two-level clustering of the instance circles. For more information on instance clustering, see Clustered instance circles.

localized image

Score thresholds

You can modify the low and high threshold values for high CPU, memory, and disk usage depending on the traffic requirements in your organization. Drag the handles in each of the selection Histogram to set the values.

localized image


Click Apply Settings to apply these changes, or click Reset to remove all changes.

How to visualize data on the dashboard

Using Infrastructure Analytics, network admins can now identify instances needing the most attention within a few seconds. To understand this in more detail, let us consider the case of Chris, a network admin of ExampleCompany.

Chris maintains many Citrix ADC instances in his organization. A few of the instances process high traffic, and he needs to monitor them closely. He notices that a few high-traffic instances are no longer processing the full traffic passing through them. To analyze this reduction, earlier, he had to read multiple data reports coming in from various sources. Chris had to spend more time trying to correlate the data manually and ascertain which instances are not in optimal state and need attention. He uses the Infrastructure Analytics feature to see the health of all instances visually.

The following two examples illustrate how Infrastructure Analytics assists him in his maintenance activity:

Example 1 - To monitor the SSL traffic:

Chris notices on the Circle Pack that one instance has a low instance score and that instance is in “Critical” state. He clicks on that instance to see what the issue is. The instance summary displays that there is an SSL card failure on that instance and therefore that instance is unable to process SSL traffic (the SSL traffic has reduced). Chris extracts that information and sends a report to the team to look into the issue immediately.

Example 2 - To monitor configuration changes:

Chris also notices that another instance is in “Review” state and that there has been a config deviation recently. When he clicks on the config deviation risk indicator, he notices that RC4 Cipher, SSL v3, TLS 1.0, and TLS 1.1 related configuration changes have been made which might be due to security concerns. He also notices that the SSL transaction traffic profile for this instance has gone down. He exports this report and sends it to the admin to inquire further.