-
Getting Started with Citrix ADC
-
Deploy a Citrix ADC VPX instance
-
Install a Citrix ADC VPX instance on Microsoft Hyper-V servers
-
Install a Citrix ADC VPX instance on Linux-KVM platform
-
Prerequisites for Installing Citrix ADC VPX Virtual Appliances on Linux-KVM Platform
-
Provisioning the Citrix ADC Virtual Appliance by using OpenStack
-
Provisioning the Citrix ADC Virtual Appliance by using the Virtual Machine Manager
-
Configuring Citrix ADC Virtual Appliances to Use SR-IOV Network Interface
-
Configuring Citrix ADC Virtual Appliances to use PCI Passthrough Network Interface
-
Provisioning the Citrix ADC Virtual Appliance by using the virsh Program
-
Provisioning the Citrix ADC Virtual Appliance with SR-IOV, on OpenStack
-
Configuring a Citrix ADC VPX Instance on KVM to Use OVS DPDK-Based Host Interfaces
-
-
Deploy a Citrix ADC VPX instance on Microsoft Azure
-
Network architecture for Citrix ADC VPX instances on Microsoft Azure
-
Configure multiple IP addresses for a Citrix ADC VPX standalone instance
-
Configure a high-availability setup with multiple IP addresses and NICs
-
Configure a high-availability setup with multiple IP addresses and NICs by using PowerShell commands
-
Configure HA-INC nodes by using the Citrix high availability template with Azure ILB
-
Configure address pools (IIP) for a Citrix Gateway appliance
-
-
Upgrade and downgrade a Citrix ADC appliance
-
Solutions for Telecom Service Providers
-
Load Balance Control-Plane Traffic that is based on Diameter, SIP, and SMPP Protocols
-
Provide Subscriber Load Distribution Using GSLB Across Core-Networks of a Telecom Service Provider
-
Authentication, authorization, and auditing application traffic
-
Configuring authentication, authorization, and auditing policies
-
Configuring Authentication, authorization, and auditing with commonly used protocols
-
Use an on-premises Citrix Gateway as the identity provider for Citrix Cloud
-
Troubleshoot authentication issues in Citrix ADC and Citrix Gateway with aaad.debug module
-
-
-
-
-
-
Persistence and persistent connections
-
Advanced load balancing settings
-
Gradually stepping up the load on a new service with virtual server–level slow start
-
Protect applications on protected servers against traffic surges
-
Retrieve location details from user IP address using geolocation database
-
Use source IP address of the client when connecting to the server
-
Use client source IP address for backend communication in a v4-v6 load balancing configuration
-
Set a limit on number of requests per connection to the server
-
Configure automatic state transition based on percentage health of bound services
-
-
Use case 2: Configure rule based persistence based on a name-value pair in a TCP byte stream
-
Use case 3: Configure load balancing in direct server return mode
-
Use case 6: Configure load balancing in DSR mode for IPv6 networks by using the TOS field
-
Use case 7: Configure load balancing in DSR mode by using IP Over IP
-
Use case 10: Load balancing of intrusion detection system servers
-
Use case 11: Isolating network traffic using listen policies
-
Use case 12: Configure Citrix Virtual Desktops for load balancing
-
Use case 13: Configure Citrix Virtual Apps for load balancing
-
Use case 14: ShareFile wizard for load balancing Citrix ShareFile
-
-
-
-
-
Authentication and authorization
-
Reporting Tool
-
-
Configuring a CloudBridge Connector Tunnel between two Datacenters
-
Configuring CloudBridge Connector between Datacenter and AWS Cloud
-
Configuring a CloudBridge Connector Tunnel Between a Datacenter and Azure Cloud
-
Configuring CloudBridge Connector Tunnel between Datacenter and SoftLayer Enterprise Cloud
-
Configuring a CloudBridge Connector Tunnel Between a Citrix ADC Appliance and Cisco IOS Device
-
CloudBridge Connector Tunnel Diagnostics and Troubleshooting
This content has been machine translated dynamically.
Dieser Inhalt ist eine maschinelle Übersetzung, die dynamisch erstellt wurde. (Haftungsausschluss)
Cet article a été traduit automatiquement de manière dynamique. (Clause de non responsabilité)
Este artículo lo ha traducido una máquina de forma dinámica. (Aviso legal)
此内容已经过机器动态翻译。 放弃
このコンテンツは動的に機械翻訳されています。免責事項
이 콘텐츠는 동적으로 기계 번역되었습니다. 책임 부인
Este texto foi traduzido automaticamente. (Aviso legal)
Questo contenuto è stato tradotto dinamicamente con traduzione automatica.(Esclusione di responsabilità))
This article has been machine translated.
Dieser Artikel wurde maschinell übersetzt. (Haftungsausschluss)
Ce article a été traduit automatiquement. (Clause de non responsabilité)
Este artículo ha sido traducido automáticamente. (Aviso legal)
この記事は機械翻訳されています.免責事項
이 기사는 기계 번역되었습니다.책임 부인
Este artigo foi traduzido automaticamente.(Aviso legal)
这篇文章已经过机器翻译.放弃
Questo articolo è stato tradotto automaticamente.(Esclusione di responsabilità))
Translation failed!
Reporting tool
Use the Citrix® Citrix ADC® Reporting tool to view Citrix ADC performance statistics data as reports. Statistics data are collected by the nscollect
utility and are stored in a database. When you want to view certain performance data over a period, the Reporting tool pulls out specified data from the database and displays them in charts.
Reports are a collection of charts. The Reporting tool provides built-in reports in addition to the option to create custom reports. In a report, you can modify the charts and add new charts. You can also modify the operation of the data collection utility, nscollect
, and stop or start its operation.
Using the reporting tool
The Reporting tool is a web-based interface accessed from the Citrix® Citrix ADC® appliance. Use the Reporting tool to display the performance statistics data as reports containing graphs. In addition to using the built-in reports, you can create custom reports, which you can modify at any time. Reports can have between one and four charts. You can create up to 256 custom reports. You can create a custom report for any number of entities.
To invoke the reporting tool
- Use the Web browser of your choice to connect to the IP address of the Citrix ADC (for example,
http://10.102.29.170/
). The Web Logon screen appears. - In the User Name text box, type the user name assigned to the Citrix ADC.
- In the Password text box, type the password.
- In the Start in drop-down list box, select Reporting.Click Login.
The following screenshots show the report toolbar and the chart toolbar, which are frequently referenced in this documentation.
Figure 1. Report Toolbar
Figure 2. Chart Toolbar
Working with reports
You can plot and monitor statistics for the various functional groups configured on the Citrix ADC over a specified time interval. Reports enable you to troubleshoot or analyze the behavior of your appliance. There are two types of reports: built-in reports and custom reports. Report content for built-in or custom reports can be viewed in a graphical format or a tabular format. The graphical view consists of line, area, and bar charts that can display up to 32 sets of data (counters). The tabular view displays the data in columns and rows. This view is useful for debugging error counters.
The default report that is displayed in the Reporting tool is CPU vs. Memory Usage and HTTP Requests Rate. You can change the default report view by displaying the report you want as your default view, and then clicking Default Report.
Reports can be generated for the last hour, last day, last week, last month, last year, or you can customize the duration.
You can do the following with reports:
- Toggle between a tabular view of data and a graphical view of data.
- Change the graphical display type, such as bar chart or line chart.
- Customize charts in a report.
- Export the chart as an Excel comma-separated value (CSV) file.
- View the charts in detail by zooming in, zooming out, or using a drag operation (scrolling).
- Set a report as the default report for viewing whenever you log on.
- Add or remove counters.
- Print reports.
- Refresh reports to view the latest performance data.
Using built-in reports
The Reporting tool provides built-in reports for frequently viewed data. Built-in reports are available for the following functional groups: System, Network, SSL, Compression, Integrated Cache, Citrix ADC Gateway, and Citrix ADC Application Firewall. By default, the built-in reports are displayed for the last day. However, you can view the reports for the last hour, last week, last month, or last year.
Note:
You cannot save changes to built-in reports, but you can save a modified built-in report as a custom report.
To display a built-in report
- In the left pane of the Reporting tool, under Built-in Reports, expand a group (for example, SSL).
- Click a report (for example, SSL > All back-end Ciphers).
Creating and deleting reports
You can create your own custom reports and save them with user-defined names for reuse. You can plot different counters for different groups based on your requirements. You can create up to 256 custom reports.
You can either create a new report or save a built-in report as a custom report. By default, a newly created custom report contains one chart named System Overview, which displays the CPU Usage counter plotted for the last day. You can customize the interval and set the data source and time zone from the report toolbar.
To create a custom report
- In the Reporting tool, on the report toolbar, click Create, or if you want to create a new custom report based on an existing report, open the existing report, and then click Save As.
- In Report Name box, type a name for the custom report.
- Do one of the following:
- To add the report to an existing folder, in Create in or Save in, click the down arrow to choose an existing folder, and then click OK.
- To create a new folder to store the report, click the Click to add folder icon, in Folder Name, type the name of the folder, and in Create in, specify where you want the new folder to reside in the hierarchy, and then click OK.
Note: You can create up to 128 folders.
To delete a custom report
- In the left pane of the Reporting tool, next to Custom Reports, click the Click to manage the custom reports icon.
- Select the check box that corresponds with the report you want to delete, and then click Delete.
Note:
When you delete a folder, all the contents of that folder are deleted.
Modifying the time interval
By default, built-in reports display data for the last day. However, if you want to change the time interval for a built-in report, you can save the report as a custom report. The new interval applies to all charts in the report. The following table describes the time-interval options.
To modify the time interval
- In the left pane of the Reporting tool, click a report.
- On the report toolbar, click Duration, and then click a time interval.
Setting the data Source and time zone
You can retrieve data from different data sources to display them in the reports. You can also define the time zone for the reports and apply the currently displayed report’s time selection to all the reports, including the built-in reports.
To set the data source and time zone
- In the Reporting tool, on the report toolbar, click Settings.
- In the Settings dialog box, in Data Source, select the data source from which you want to retrieve the counter information.
- Do one or both of the following:
- If you want the tool to remember the time period for which a chart is plotted, select the Remember time selection for charts check box.
- If you want the reports to use the time settings of your Citrix ADC appliance, select the Use Appliance’s time zone check box.
Exporting and importing custom reports
You can share reports with other Citrix ADC administrators by exporting reports. You can also import reports.
To export or import custom reports
- In the left pane of the Reporting tool, next to Custom Reports, click the Click to manage custom reports icon.
- Select the check box that corresponds with the report you want to export or import, and then click Export or Import.
Note:
When you export the file, it is exported in a .gz file format.
Working with charts
Use charts to plot and monitor counters or groups of counters. You can include up to four charts in one report. In each chart, you can plot up to 32 counters. The charts can use different graphical formats (for example, area and bar). You can move the charts up or down within the report, customize the colors and visual display for each counter in a chart, and delete a chart when you do not want to monitor it.
In all report charts, the horizontal axis represents time and the vertical axis represents the value of the counter.
Adding a chart
When you add a chart to a report, the System Overview chart appears with the CPU Usage counter plotted for the last one day.
Note:
If you add charts to a built-in report, and you want to retain the report, you must save the report as a custom report.
Use the following procedure to add a chart to a report.
To add a chart to a report
- In the left pane of the Reporting tool, click a report.
- Under the chart where you want to add the new chart, click the Add icon.
Modifying a chart
You can modify a chart by changing the functional group for which the statistics are displayed and by selecting different counters.
To modify a chart
- In the left pane of the Reporting tool, click a report.
- Under the chart that you want to modify, click Counters.
- In the dialog box that appears, in the Title box, type a name for the chart.
- Next to the Plot chart for, do one of the following:
- To plot counters for global counters, such as Integrated Cache and Compression, click System global statistics.
- To plot entity counters for entity types, such as Load Balancing and GSLB, click System entities statistics.
- In the Select group, click the desired entity.
- Under Counters, in Available, click the counter name(s) that you want to plot, and then click the > button.
- If you selected System entities statistics in step 4, on the Entities tab, under Available, click the entity instance name(s) you want to plot, and then click the > button.
- Click OK.
Viewing a chart
You can specify the graphical formats of the plotted counters in a chart. Charts can be viewed as line charts, spline charts, step-line charts, scatter charts, area charts, bar charts, stacked area charts, and stacked bar charts. You can also zoom in, zoom out, or scroll inside the plot area of a chart. You can zoom in or out for all data sources for 1 hour, 1 day, 1 week, 1 month, 1 year, and 3 years.
Other options for customizing the view of a chart include customizing the axes of the charts, changing the background and edge color of the plot area, customizing the color and size of the grids, and customizing the display of each data set (counter) in a chart.
Data set numbers, such as Data Set 1, correspond to the order in which the counters in your graph are displayed at the bottom of the chart. For example, if CPU usage and Memory usage are displayed in first and second order at the bottom of the chart, CPU usage is equal to Data Set 1 and Memory usage is equal to Data Set 2.
Whenever you modify a built-in report, you need to save the report as a custom report to retain your changes.
To change the graph type of a chart
- In the left pane of the Reporting tool, select a report.
- In the right pane, under the chart you want to view, on the chart toolbar, click Customize.
- On the Chart tab, under Category, click Plot type, and then click the graph type you want to display for the chart. If you want to display the graph is 3D, select the Use 3D check box.
To refocus a chart with detailed data
- In the left pane of the Reporting tool, select a report.
- In the right pane, on the report toolbar, click Zoom In, and do one or both of the following:
- To refocus the chart to display data for a specific time window, drag the cursor from the start time to the end time. For example, you can view data for a one-hour period on a certain day.
- To refocus the chart to display data for a data point, simply click once on the chart where you want to zoom in and get more detailed information.
- Once you have the desired range of time for which you want to view detailed data, on the report toolbar, click Tabular View. Tabular view displays the data in numeric form in rows and columns.
To view numeric data for a graph
- In the left pane of the Reporting tool, select a report.
- In the right pane, on the report toolbar, click Tabular View. To return to the graphical view, click Graphical View.
Note: You can also view the numeric data in the graphical view by hovering your cursor over the notches in the gridlines.
To scroll through time in a chart
- In the left pane of the Reporting tool, select a report.
- In the right pane, on the report toolbar, click Scroll, and then click inside the chart and drag the cursor in the direction for which you want to see data for a new time period. For example, if you want to view data in the past, drag to the left.
To change the background color and text color of a chart
- In the left pane of the Reporting tool, select a report.
- In the right pane, under the chart for which you want to customize the axes, click Customize.
- On the Chart tab, under Category, click one or more of the following:
- To change the background color, click Background Color, and then select the options for color, transparency, and effects.
- To change the text color, click Text Color, and then select the options for color, transparency, and effects.
To customize the axes of a chart
- In the left pane of the Reporting tool, select a report.
- In the right pane, under the chart for which you want to customize the axes, click Customize.
- On the Chart tab, under Category, click one or more of the following:
- To change the scale of the left y-axis, click Left Y-Axis, and then select the scale you want.
- To change the scale of the right y-axis, click Right Y-Axis, in a data set to plot, select the date set, and then select the scale you want.
Note: The data set numbers, such as Data Set 1, correspond to the order in which the counters in your graph are displayed at the bottom of the chart. For example, if CPU usage and Memory usage are displayed in first and second order at the bottom of the chart, CPU usage is equal to Data Set 1 and Memory usage is equal to Data Set 2.
- To plot each data set in its own hidden y-axis, click Multiple Axes, and then click Enable.
To change the background color, edge color, and gridlines for a plot area of a chart
- In the left pane of the Reporting tool, select a report.
- In the right pane, under the chart for which you want to customize the plot area, click Customize.
- On the Plot Area tab, under Category, click one or more of the following:
- To change the background color and edge color of the chart, click Background Color and Edge Color, and then select the options for color, transparency, and effects.
- To change the horizontal or vertical grids of the chart, click Horizontal Grids or Vertical Grids, and then select the options for displaying the grids, grid width, grid color, transparency, and effects.
To change the color and graph type of a data set
- In the left pane of the Reporting tool, select a report.
- In the right pane, under the chart for which you want to customize the display of the data set (counters), click Customize.
- On the Data Set tab, in Select Data Set, select the data set (counter) for which you want to customize the graphical display. Note: The data set numbers, such as Data Set 1, correspond to the order in which the counters in your graph are displayed at the bottom of the chart. For example, if CPU usage and Memory usage are displayed in first and second order at the bottom of the chart, CPU usage is equal to Data Set 1 and Memory usage is equal to Data Set 2.
- Under Category, do one of more of the following:
- To change the background color, click Color, and then select the options for color, transparency, and effects.
- To change the graph type, click Plot type, and then select the graph type you want to display for the data set. If you want to display the graph as 3D, select the Use 3D check box.
Exporting chart data to excel
For further data analysis, you can export charts to Excel in a comma-separated value (CSV) format.
To export chart data to excel
- In the left pane of the Reporting tool, select a report.
- In the right pane, under the chart with the data you want to export to Excel, click Export.
Deleting a chart
If you do not want to use a chart, you can remove it from the report. You can permanently remove charts from custom reports only. If you delete a chart from a built-in report and want to retain the changes, you need to save the report as a custom report.
To delete a chart
- In the left pane of the Reporting tool, select a report.
- In the right pane, under the chart that you want to delete, click the Delete icon.
Examples
To display the trend report for CPU usage and memory usage for the last week
- In the left pane of the Reporting tool, under Built-in Reports, expand System.
- Click the report CPU vs. Memory Usage and HTTP Requests Rate.
- In the right pane, on the report toolbar, click Duration, and then click Last Week.
To compare the bytes received rate and the bytes transmitted rate between the two interfaces for the last week
- In the right pane, on the report toolbar, click Create.
- In the Report Name box, type a name for the custom report (for example, Custom_Interfaces), and then click OK. The report is created with the default System Overview chart, which displays the CPU Usage counter plotted for the last hour.
- Under System Overview, on the chart toolbar, click Counters.
- In the counter selection pane, in Title, type a name for the chart (for example, Interfaces bytes data).
- In Plot chart for, click System entities statistics, and then in Select Group, select Interface.
- On the Entities tab, click the interface names you want to plot (for example, 1/1 and 1/2), and then click the > button.
- On the Counters tab, click Bytes received (Rate) and Bytes transmitted (Rate) and then click the > button.
- Click OK.
- On the report toolbar, click Duration, and then click Last Week.
Stopping and starting the data collection utility
The data collection utility, nscollect
, runs automatically when you start the Citrix ADC. This utility retrieves the application performance data and stores it in the form of data sources on the ADC. You can create up to 32 data sources. The default data source is /var/log/db/default
.
The data collection utility creates databases for global counters and entity-specific counters, and uses this data to generate reports. Global-counter databases are created at /var/log/db/<DataSourceName>
. The entity-specific databases are created based on the entities configured on the Citrix ADC, and a separate folder is created for each entity type in /var/log/db/<DataSourceName/EntityNameDB>
.
The nscollect
retrieves data once every 5 minutes. It retains data in 5-minute granularity for one day, hourly for the last 30 days, and daily for three years.
You might have to stop and restart the data collection utility if data is not updated accurately or the reports display corrupted data.
To stop nscollect
At the command prompt, type:
/netscaler/nscollect stop
To start nscollect on the current SSH session to the Citrix ADC:
At the command prompt, type:
/netscaler/nscollect start
To start nscollect on the local system:
At the command prompt, type:
/netscaler/nscollect start &
Share
Share
This Preview product documentation is Cloud Software Group Confidential.
You agree to hold this documentation confidential pursuant to the terms of your Cloud Software Group Beta/Tech Preview Agreement.
The development, release and timing of any features or functionality described in the Preview documentation remains at our sole discretion and are subject to change without notice or consultation.
The documentation is for informational purposes only and is not a commitment, promise or legal obligation to deliver any material, code or functionality and should not be relied upon in making Cloud Software Group product purchase decisions.
If you do not agree, select I DO NOT AGREE to exit.