Application Delivery Management

View audit reports

Citrix Application Delivery Management (Citrix ADM) allows you to view and download the configuration audit diff report in configuration audit section.  The configuration audit section enables you to export the summary report across all instances and per instance, and also allows you to export granular diff report for each instance-template pair.

The audit templates that appear in the Audit Templates list are run at the scheduled time against the configurations in the specified instances. The NetScaler Config Drift chart on the Configuration Audit dashboard displays high-level details about configuration changes in saved against unsaved configurations. When you click NetScaler Config Drift chart, the ensuing Audit Reports page displays a list of instances that shows both “Diff Exists” and No Diff.”  You can download the diff reports displayed by Citrix ADM.

Citrix ADM also provides an option to schedule automatic export of diff report as a mail attachment. For more information on how to schedule export of reports, see Creating Audit Templates.

To export configuration audit reports:

  1. In Citrix ADM, navigate to Networks > Configuration Audit.

  2. On the Configuration Audit page, click inside the NetScaler Config Drift chart.

  3. The Audit Reports page lists instances that have a difference. The page also displays a list of instances that does not have any difference in their running configurations.

    Audit Reports

In the image you can see that for some instances a diff is present only in Saved Vs Running Diff and for some instances, a diff is present only in Template vs Running Diff. For some instances, differences exist in both Saved Vs Running Diff and Template vs Running Diff.

Saved Vs Running Diff

You can view a report of the diff between the configuration saved on the instance and the configuration currently running on that instance. For example, click Diff Exists for an instance under Saved Vs Running Diff.

Saved Vs Running Diff

Here, you can see a report for saved configuration against running configuration diff for that instance.

Configuration Diff

Click Export diff report to download a .csv file of the diff report. You can also click Export corrective commands to export the commands to a .txt file. You can then run the commands on the associated Citrix ADM instance from configuration jobs to correct the configuration in that instance.

Template vs Running Diff

The Template vs Running Diff includes all templates other than Saved Vs Running Diff which is the default template. You can view the difference that exists between the template and running configuration. For example, click Diff Exists for one of the instances under Template vs Running Diff.

Template Vs Running Diff

Now you can see that two templates show diff and the Citrix ADM instance has a different configuration from what the template is looking for.

Templates of the instance

Click Diff Exists again. The following image shows the configuration that the template is looking for and the running configuration that is blank, because no such commands has been configured or has been removed. You can also see the correction configurations or the commands to run to correct the configuration.

Export the diff report

You can also use Template vs Running and Running vs template drift setting, to compare the configuration from both ways:

  • Compares the audit template configuration with the running configuration on the instance.

  • Compares the running configuration on the instance with the audit template.

By default, the Template vs. running drift setting is selected. To modify the drift setting, from the ADM GUI, select Settings in the Configuration Audit page.

Bidirectional config drift setting

Click Export diff report to download a .csv file of the diff report. You can also click Export corrective commands to export the commands to a .txt file. You can then run the commands in CLI to correct the configuration in that instance.

The following image shows an example .csv diff file that is downloaded to your system:

Example diff report

View the file status audit reports

Using the Citrix ADC File Status chart, you can monitor whether any files are added, modified or removed in the nsconfig folder. For example: if the license file is updated on an ADC instance, you can check when this file was last updated and take actions appropriately.

To export the file status audit reports for the Citrix ADC instances:

  1. In Citrix ADM, navigate to Networks > Configuration Audit.

  2. On the Configuration Audit page, click inside the Citrix ADC File Status chart.

    The Audit Reports page lists instances with the Diff status.

    Audit reports for ADC file status

    The Diff Status is calculated for the interval between the Previous Polled Time to the Latest Polled Time. The Diff Status can be one of the following:

    • Diff exists - This status indicates the files have changed in the nsconfig folder of an instance since the Previous Polled Time. To view what has changed on the file, click Diff Exists.

      Diff exists in `nsconfig` folder

    • No Diff - This status indicates the files in the nsconfig folder hasn’t changed since the previous polled time.

    • NA - This status indicates monitoring the file status is not applicable. This status appears when the Citrix ADM doesn’t poll the instance. For example, when an instance is added newly or instance state is inactive the polling of the instance doesn’t occur.

View audit reports