Administering Statistical Data Collection
This chapter describes how to administer Statistical Data Collection in the Cisco Data Center Network Manager (DCNM).
This chapter includes the following sections:
•Information About Statistical Data Collection
•Licensing Requirements for Statistical Data Collection
•Prerequisites for Statistical Data Collection
•Guidelines and Limitations for Statistical Data Collection
•Configuring Statistical Data Collection
•Viewing the Status of Statistical Data Collectors
•Field Descriptions for Statistical Data Collection
•Additional References
•Feature History for Statistical Data Collection
Information About Statistical Data Collection
You can use the Statistical Data Collection feature to control the statistics monitoring processes that you have created for one of the many device configuration features that support statistics.
When you choose Statistical Data Collection on the Feature Selector pane, the content pane shows information about each statistical collection and allows you to control them. You can also use this feature to purge old data from the statistical database.
You can configure the length of time that Cisco Data Center Network Manager (DCNM) waits before retrieving statistical data from devices that it is monitoring. By default, DCNM retrieves statistical data from monitored devices every 30 seconds. You can increase the length of time to a maximum of 4 minutes. For more information, see the "Configuring the Default Frequency of Statistical Data Retrieval" section on page 4-14.
This section includes the following topics:
•Automatic and Manual Purging of Statistical Data
•Virtualization Support
Automatic and Manual Purging of Statistical Data
You can use the Statistical Data Collection feature to delete unwanted statistical data. DCNM supports automatic purging of statistical data. You can configure the following aspects of automatic statistical data purging:
•Days of the week and time of day that automatic purging occurs.
•Whether DCNM determines which statistical data to purge by the age of the data or by a maximum number of database entries.
•Whether DCNM deletes the statistical data entries that it purges or consolidates them into one entry.
You can also manually purge statistical data.
Virtualization Support
DCNM treats each virtual device context (VDC) on a Cisco NX-OS device as a separate device. Statistical data collections contain statistics from objects within devices.
Licensing Requirements for Statistical Data Collection
The following table shows the licensing requirements for this feature:
|
|
DCNM |
Real-time monitoring requires no license. DCNM requires a LAN Enterprise license for the following features: •Maintaining a history of statistical data •Using overview charts For information about obtaining and installing a DCNM LAN Enterprise license, see the "Installing Licenses" section on page 2-7. |
Prerequisites for Statistical Data Collection
Statistical data collection has the following prerequisites:
•The DCNM server must be able to connect to the devices.
•The Cisco NX-OS device must be running a supported version of Cisco NX-OS.
•The Cisco NX-OS device must have the minimal configuration that is required to enable device discovery to succeed. For more information, see the "Cisco NX-OS Device Preparation" section on page 6-2.
Guidelines and Limitations for Statistical Data Collection
The Statistical Data Collection feature has the following configuration guidelines and limitations:
•Collections are created by starting monitoring for a new chart. For more information, see the "Starting Statistical Monitoring for a Chart" section on page 4-10.
•For the Statistical Data Collection feature, the DCNM client does not automatically update the information shown in the Summary pane. To ensure that you are viewing current information, from the menu bar, choose View > Refresh.
•When you start statistical monitoring for one or more charts and then close the DCNM client, a dialog box prompts you to decide whether to stop the collections or let them run. We recommend that you stop any unnecessary collections when you log out of the DCNM client. This practice conserves database space and decreases server load.
•We recommend that you configure automatic purging of statistical data to ensure that the DCNM database size does not grow too large.
Configuring Statistical Data Collection
Figure 16-1 shows the Statistical Data Collection content pane.
Figure 16-1 Statistical Data Collection Content Pane
This section includes the following topics:
•Starting and Stopping Statistical Data Collection
•Deleting Statistical Data from a Collection
•Deleting a Collection
•Deleting Data from the Statistics Database
•Enabling and Disabling Automatic Statistical Data Purging
•Configuring Automatic Statistical Data Purge Settings
•Purging Statistical Data Now
Starting and Stopping Statistical Data Collection
You can use the Statistical Data Collection feature to start and stop a statistical data collection process. Each collection process represents a statistical monitoring process that you created by starting monitoring for a device configuration feature.
DETAILED STEPS
To start or stop a collection process, follow these steps:
Step 1 From the Feature Selector pane, choose DCNM Server Administration > Statistical Data Collection.
A table of statistical data collectors appears in the Contents pane. Each row corresponds to a collector for a particular device. The Status field displays whether the collector is running or is stopped.
Step 2 Click the collector that you want to start or stop.
Step 3 Do one of the following:
•To start a collector, from the menu bar, choose Actions > Start Collection. The Status field changes to Running.
•To stop a collector, from the menu bar, choose Actions > Stop Collection. The Status field changes to Stopped.
You do not need to save your changes.
Deleting Statistical Data from a Collection
You can delete statistical data from a collection. This feature allows you to delete all the data from a collection without affecting data from other collections and without deleting the collection itself. Each collection process represents a statistical monitoring process that you created by starting monitoring for a device configuration feature.
DETAILED STEPS
To delete statistical data from a collection, follow these steps:
Step 1 From the Feature Selector pane, choose DCNM Server Administration > Statistical Data Collection.
A table of statistical data collectors appears in the Contents pane. Each row corresponds to a collector for a particular device. Devices are listed alphabetically. The Status field displays whether the collector is running or is stopped.
Step 2 Right-click the collection.
Step 3 From the menu bar, choose Actions > Delete Statistical Data.
DCNM deletes all statistical data from the collection.
Deleting a Collection
You can delete a collection of statistical data from a specific device. Each collection process represents a statistical monitoring process that you created by starting monitoring for a device configuration feature.
Note If you want to delete all data from a collections rather than deleting the collection itself, perform the steps in the "Deleting Statistical Data from a Collection" section.
BEFORE YOU BEGIN
Determine which collection of data you want to delete.
DETAILED STEPS
To delete a collection of statistical data from a device, follow these steps:
Step 1 From the Feature Selector pane, choose DCNM Server Administration > Statistical Data Collection.
A table of statistical data collectors appears in the Contents pane. Devices are listed alphabetically. Each row corresponds to a collection of statistical data for a particular device.
Step 2 Click the collection of data that you want to delete.
Step 3 From the menu bar, choose Actions > Delete Collection.
The collection is deleted.
You do not need to save your changes.
Deleting Data from the Statistics Database
You can delete statistical data from the statistics database.
Note If you want to delete all data from a specific collection rather than deleting old data from all collections, perform the steps in the "Deleting a Collection" section.
BEFORE YOU BEGIN
Determine the date and time of the newest statistical data that you want to delete. When you follow the steps in this procedure, DCNM deletes all statistics that are older than the date and time that you select.
DETAILED STEPS
To delete data from the statistics database, follow these steps:
Step 1 From the Feature Selector pane, choose DCNM Server Administration > Statistical Data Collection.
The Statistics Database area appears in the Contents pane, below the table of statistical data collectors.
Step 2 From the Delete statistical data older than drop-down list, select the date and time of the newest statistics that you want to delete and click OK.
Step 3 Click Delete.
DCNM deletes all statistics older than the date and time that you specified.
Enabling and Disabling Automatic Statistical Data Purging
You can enable or disable the automatic purging of statistical data from the DCNM statistics database.
DETAILED STEPS
To enable or disable automatic statistical data purging, follow these steps:
Step 1 From the Feature Selector pane, choose DCNM Server Administration > Statistical Data Collection.
The Statistical Database Administration tab appears in the Details pane, below the table of statistical data collectors.
Step 2 Under Purge Settings, do one of the following:
•To enable automatic statistical data purging, check Enable Auto Purge.
•To disable automatic statistical data purging, uncheck Enable Auto Purge.
Step 3 From the menu bar, choose File > Deploy to save your changes to the DCNM server.
Configuring Automatic Statistical Data Purge Settings
You can configure when automatic statistical data purging occurs and the criteria that DCNM uses to determine which statistical data to purge.
BEFORE YOU BEGIN
Determine when you want automatic statistical data purging to occur. We recommend that automatic statistical data purging occur when DCNM usage is low.
If you perform backups of your DCNM databases, consider scheduling automatic statistical data purging after database backups have occurred, to ensure that you retain a record of all statistical data.
Determine what criteria you want DCNM to use to determine which statistical data to purge. The two criteria available are as follows:
•Age of statistical data—DCNM can purge all statistical data entries that are older than a specific number of days, weeks, or months.
•Number of statistical data entries in the database—When the number of statistical data entries in the database exceeds the maximum number that you specify, DCNM can purge the oldest statistical data entries first until the maximum number is not exceeded.
If you enable both criteria, DCNM applies them independently of each other.
DETAILED STEPS
To configure automatic statistical data purge settings, follow these steps:
Step 1 From the Feature Selector pane, choose DCNM Server Administration > Statistical Data Collection.
The Statistical Database Administration tab appears in the Details pane, below the table of statistical data collectors.
Step 2 Under Purge Threshold, configure the criteria that DCNM uses to determine which statistical data to purge. You can configure either or both of the criteria in the following table:
|
|
Age of statistical data |
1. Check Data older than. 2. From the first drop-down list, choose the number of days, weeks, or months. 3. From the second drop-down list, choose Days, Weeks, or Months, as needed. |
Number of statistical data entries in the database |
1. Check Total Entries Exceed(0-2147483647). 2. In the box, enter the maximum number of entries that you want to allow in the statistical database. |
Step 3 Configure the action that you want DCNM to take on statistical database entries that meet the purge criteria. You can choose one of the following:
•Delete—DCNM deletes the database entries that meet the purge criteria.
•Consolidate—DCNM merges all statistical data entries that meet the purge criteria into one entry
Step 4 Under Purge Settings, follow these steps to configure when you want automatic purging to occur:
a. Check the days-of-the-week check boxes to specify which days of the week that you want automatic purging to occur.
b. Use the Run at box to configure the exact time on the specified days that you want automatic statistical data purging to occur.
Step 5 (Optional) If you want to enable automatic statistical data purging, check Enable Auto Purge.
Step 6 From the menu bar, choose File > Deploy to save your changes to the DCNM server.
Purging Statistical Data Now
You can purge statistical data on demand, using the automatic statistical data purge settings to determine which statistical data are purged.
Tip If you want to delete statistical data on demand, based on the exact age of the statistical data entries, see the "Deleting Data from the Statistics Database" section.
BEFORE YOU BEGIN
Ensure that the automatic statistical data purge settings are configured as needed. For more information, see the "Configuring Automatic Statistical Data Purge Settings" section.
DETAILED STEPS
To purge statistical data from the statistical database now, follow these steps:
Step 1 From the Feature Selector pane, choose DCNM Server Administration > Statistical Data Collection.
The Statistical Database Administration tab appears in the Details pane, below the table of statistical data collectors.
Step 2 Under Purge Settings, click Purge Now.
DCNM deletes statistical data, using the automatic statistical data purge settings to determine which statistical data entries to purge.
Viewing the Status of Statistical Data Collectors
To view the status of statistical data collectors, from the Feature Selector pane, choose DCNM Server Administration > Statistical Data Collection.
Collector status and other information appear in the Statistical Data Collectors area in the Contents pane. For information about the fields that appear, see the "Field Descriptions for Statistical Data Collection" section.
Field Descriptions for Statistical Data Collection
This section includes the following field descriptions for the Statistical Data Collection feature:
•Summary Pane
•Statistical Database Administration Tab
Summary Pane
Table 16-1 Summary Pane
|
|
Statistical Data Collectors
|
Last Refresh Time |
Display only. Date and time that the DCNM client updated information shown on the Content pane. |
Collector ID |
Display only. Name and IP address of the device for the corresponding poller. |
Owner |
Display only. Username of the DCNM user who started monitoring for the chart that corresponds to the collection. |
Device |
Display only. Name and IP address of the device that is providing the statistical data in the collection. |
Objects |
Display only. Description of the entity on the device that is providing the statistical data in the collection. For example, if the collection has statistical data for a rule that is assigned the sequence number 10 and is in an IPv4 ACL named acl-01, this field displays acl-01,seqNo=10. If the collection has data for the Ethernet 1/5 port, this field displays Ethernet1/5. |
Collected Statistics |
Display only. Type of statistical data in the collection. For example, if the collection has statistical data for a rule in an IPv4 ACL, this field displays IpAclAceMatchStatistics. |
Status |
Display only. Whether the collector is started or stopped. |
|
Delete statistical data older than |
Date and time of the newest statistical data to be deleted from the statistics database. There is no default value for this field. |
Statistical Database Administration Tab
Table 16-2 Statistical Database Administration Tab
|
|
Delete statistical data older than |
Date and time of the newest statistical data to be deleted from the statistics database. There is no default value for this field. |
|
Action |
Whether automatic statistical data purging deletes or consolidates statistical data entries that trigger the purge threshold. Consolidation merges all statistical data entries that trigger the purge threshold into one entry. |
|
Data older than |
Whether, during automatic statistical data purging, DCNM deletes statistics entries that are older than the age specified in the drop-down lists located to the right of this check box. By default, this check box is unchecked. If you check the check box, the default age is 1 day. |
Total Entries Exceed |
Whether, during automatic statistical data purging, DCNM deletes the oldest statistics entries until the number of entries equals the number in the box located to the right of this check box. By default, this check box is unchecked. If you check the check box, the default number of event is 25,000. |
|
Enable Auto Purge |
Whether automatic purging of statistical data is enabled. By default, this check box is disabled. |
Run on |
Days of the week that automatic purging of statistical data occurs. By default, none of the check boxes are checked. If you check the Daily check box, the check boxes for the individual days of the week become unavailable. |
Run at |
Time of day that automatic purging of statistical data occurs, on the days of the week that automatic purging is enabled. |
Additional References
For additional information related to administering statistical data collection, see the following sections:
•Related Documents
•Standards
Related Documents
Standards
|
|
No new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature. |
— |
Feature History for Statistical Data Collection
Table 16-3 lists the release history for this feature.
Table 16-3 Feature History for Statistical Data Collection
|
|
|
Automatic purging of statistical data |
4.1(2) |
This feature was introduced. |
Statistical Data Collection |
4.1(2) |
This feature was preexisting. |