Product Documentation

Diagnostics

May 20, 2015

If you have problems with your NetScaler Insight Center deployment, see Troubleshooting Tips. If you do not find a solution there, check the audit logs and task logs for a possible reason for the problem. These logs are also useful for monitoring NetScaler Insight Center operations. You can supplement them by designating a syslog server to which to redirect system log messages.

Using Audit Logs

Audit logs provide detailed information about user-initiated operations that are performed on the NetScaler Insight Center.

To view audit logs

  1. On the Configuration tab, navigate to System > Audit.
  2. View the following details of operations performed:
    • User name—Name of the user who performed the operation.
    • IP Address—IP address of the NetScaler ADCs on which the operation was performed.
    • Port—Port at which the system was sending and receiving data when the operation was performed.
    • Resource Type —Type of resource on which the operation was performed.
    • Resource Name—Name of the resource used to perform the operation, and the user name used to log in.
    • Audit Time—Time when the audit log was generated.
    • Operation—Task that was performed, such as add, delete, or log out.
    • Status—Status of the audit, such as success or failure.
    • Message—Message describing the status of a task and the cause of failure (if the operation failed).

Using Task Logs

Tasks logs provide detailed information about the operations that NetScaler Insight Center performs on NetScaler appliances. The Task Logs category includes subcategories for devices and commands. The three types of logs can be described as follows:

  • Task Logs—The operations that were performed.
  • Device Logs—The NetScaler ADCs on which the operations were performed.
  • Command Logs—The NetScaler or CloudBridge commands that were executed.

To view the task logs

  1. On the Configuration tab, navigate to Diagnostics > Task Log.
  2. View the following details of tasks that were performed on the NetScaler ADCs.
    • Name—Name of the task that is being executed or has already been executed.
    • Status—Status of the task, such as In progress, Completed, or Failed.
    • Executed byNetScaler Insight Center user who performed the operation.
    • Start time—Time at which the task started.
    • End time—Time at which the task ended.
  3. Click a task to view the device logs. This is a list of the devices on which the operation was executed.
    • Status—Status of the operation, such as In progress, Completed, or Failed.
    • IP address—IP address of the NetScaler ADC.
    • Start Time—Time at which the operation started.
    • End Time.—Time at which the operation ended.
  4. Click a device to view the command logs. This is a list of the commands that were executed on that device.
    • Status—Status of the operation, such as In progress, Completed, or Failed.
    • Message—Message describing the status of operation.
    • Command—The command that was executed.
    • Start Time—Time at which the command started.
    • End Time—Time at which the command ended.

Monitoring Syslog Events

You can monitor the syslog events generated by the NetScaler ADCs in the NetScaler Insight Center inventory if you have configured the NetScaler Insight Center virtual appliance to redirect all syslog messages to the syslog servers. To monitor syslog events, you have to designate a syslog server. A syslog server is an external server that displays the log events generated by NetScaler Insight Center. After you configure the syslog server, you can view the details of the events generated by the NetScaler ADCs.

Designating a Syslog Server

  1. On the Configuration tab, navigate to System > Syslog Servers.
  2. In the Syslogs Servers pane, click Add.
  3. Enter the following details in the Add SysLog Server dialog box:
    • Name—Name of the syslog server.
    • IP Address—IP address of the syslog server.
    • Port—Port at which the system sends and receives data when the operation is performed.

      By default, the port value is 514.

    • Log Levels—Select any of the log levels displayed.
  4. Click Add. The syslog server is displayed on the Syslogs Servers pane.
Note: You can also select the date and time format to be displayed in the logs by selecting System Logs Parameters from the Action drop-down list.

Viewing Syslogs

  1. On the Configuration tab, navigate to System > System logs.
  2. The following details are displayed on System Logs pane:
    • Severity—Severity of the issue
    • Source—IP address of the virtual server
    • Date—Time and date when the issue was logged
    • Category—Category of the issue
    • Message—Details of the issue

Contacting Technical Support

Citrix recommends that before contacting technical support for debugging an issue, you generate an archive of the NetScaler Insight Center data and statistics. The archive is a TAR file that you send to the technical support team.

To create and send an archive file

  1. On the Configuration tab, navigate to Diagnostics > Technical Support.
  2. Generate the file, on the appliance as follows:
    1. In the Technical Support pane, from the Action drop-down list, select Generate Technical Support File.
      Note: Be sure to clear the selection of any downloaded file.
    2. In the Generate Technical Support File dialog box, from the Mode drop-down list, select the mode and click OK.
    The archive file is created as a TAR file.
  3. Download the file.
    1. In the Technical Support pane, select the file to be downloaded.
    2. From the Action drop-down list, select the Download option.
    3. In the File Download message box, click Save.
    4. In the Save As message box, browse to the location where you want to save the file, and then click Save.
  4. Email the file to the Citrix technical support team.