How Citrix ADM communicates with managed instances

Citrix Application Delivery Management (ADM) polls managed instances to collect information. The following list describes the various kinds of polling that occur between ADM and the managed instances. The section also describes the protocols used to collect this information and whether the polling intervals can be configured on the ADM server.

  • Instance polling. By default, every minute, ADM polls managed ADC instances to collect statistical information such as state, HTTP requests per second, CPU usage, memory usage, and throughput. This data collection uses NITRO calls. An instance is pinged if the NITRO call fails. This polling interval is not configurable.
  • Inventory polling. Every 30 minutes, inventory such as build version, system information, licensed features, and modes is collected from managed instances and updated in the ADM database. This communication between Citrix ADM and managed instances uses NITRO calls (nsconfig, version, route, stat, nsversion, nsnode and so on) and the Secure Shell (SSH) protocol. You can also rediscover instances if you want to collect inventory on a need basis. This polling interval is not configurable.
  • Performance data collection. By default, every 5 minutes, performance data collection for network reporting is done by using NITRO calls. This retrieves instance statistics such as counter information and aggregates them on the basis of per minute, per hour, per day, or per week. You can view this aggregated data in pre-defined reports. This polling interval is not configurable.
  • Instance backup polling. Every 12 hours, Citrix ADM backs up the current state of your managed ADC instances. This backup is done by using NITRO calls, Secure Shell (SSH) and Secure Copy (SCP) protocols. You can configure this polling interval by navigating to System > System Administration > Backup Settings > Instance Backup Settings.
  • Configuration audits polling. Every 10 hours, auditing is performed to look for configuration changes that occur on ADC instances (for example, running vs. saved configuration). This enables you to see the difference between various revisions of ADC configuration files (ns.conf) and across various ADC version changes. Citrix ADM collects configuration audits by using the Secure Shell (SSH) and Secure Copy (SCP) protocols. Running and saved configuration for auditing can be collected on demand by using NITRO calls. You can configure this polling interval for configuration audits by navigating to Networks > Configuration Audit. On the Configuration Audit page, in the Select Action drop-down list, select Configure Polling Interval.

Citrix ADM also allows you to poll configuration audits manually and adds all the configuration audits of the instances immediately to the Citrix ADM. To do so, navigate to Networks > Configuration Audit and click Poll Now. The Poll Now page provides you an option to poll all ADC instances in the network or only the selected instances.

  • SSL certificates polling. Every 24 hours, Citrix ADM polls SSL certificates by using NITRO calls and the Secure Copy (SCP) protocol. You can configure this polling interval for SSL certificates by navigating to Networks > SSL Dashboard. On the SSL Dashboard page, in the Select Action drop-down list, click Configure Polling Interval.

Citrix ADM allows you to poll SSL Certificates and add all the SSL certificates of the instances immediately to Citrix ADM. To do so, navigate to Networks > SSL Dashboard and click Poll Now. The Poll Now page provides you an option to poll all ADC instances in the network or only the selected instances.

  • Entity polling. Every 30 minutes, entities are polled by Citrix ADM by using NITRO calls. An entity is either a policy, virtual server, service, or action attached to a ADC instance. While this poling interval is configurable, you cannot set it to less than 10 minutes. To configure it, navigate to Networks > Network Functions and click Configure Polling Interval from the Select Action list.

You can also poll the entities configuration when required by navigating to Networks > Network Functions. On the Network Functions page, click Poll Now.  The Poll Now page provides you an option to poll all ADC instances in the network or only the selected instances.

  • Analytics. By default, every minute, the decoder collects and decodes the data received from all managed ADC instances and writes it to the internal database. This polling interval is not configurable.

In addition to polling, events generated by managed ADC instances are received by Citrix ADM through SNMP traps sent the instances. For example, an event is generated when there is a system failure or change in configuration.

During instance backup, SSL files, CA certificate files, ADC templates, database information, and so on are downloaded to Citrix ADM. During a configuration audit, ns.conf files are downloaded and stored in the file system. All information collected from managed Citrix ADC instances are stored internally within the database.

How Citrix ADM communicates with managed instances

In this article