display nat statistics address-pool-usage

Function

The display nat statistics address-pool-usage command displays the usage of address pools.

This command is supported only on the NetEngine 8000 F1A.

Format

display nat statistics address-pool-usage [ time-interval time-interval-value ]

Parameters

Parameter	Description	Value
time-interval time-interval-value	Specifies the interval at which statistics are collected and displayed. If the time-interval parameter is configured, the display nat statistics command calculates the average and maximum values within a specified interval. For example, if the time-interval value is set to 3 hours, the device uses the sampled data to calculate the average and maximum values every 3 hours. If the time-interval parameter is not configured, the display nat statistics command displays the current, average, and maximum values based on the data that is sampled once every 10 minutes.	The value is an integer ranging from 1 to 24, in hours.

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
nat	read

Usage Guidelines

Usage Scenario

To view NAT statistics on a service board, run the display nat statistics command. The command output contains the following information: Usage of address pools.

Precautions

The display nat statistics address-pool-usage command to display the IP address usage of no-PAT and PAT address pools. IP address usage of a PAT address pool is 0%. This is because the PAT mode supports the port reuse mode, and the address pool usage is meaningless.

You can query the address pool usage of a NAT instance only after the nat statistics address-pool-usage enable command is run in the instance.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display address usage statistics collected every 1 hour on an existing service board.

<HUAWEI> display nat statistics address-pool-usage time-interval 1
This operation will take a few minutes. Press 'Ctrl+C' to break ...
Slot: 1
******************************************************
  Nat Instance cpe1
******************************************************
Address Group: group1
StartTime             EndTime              Avarage-usage           Max-usage
2014-07-07 15:25   2014-07-07 16:25          0%                    0%
2014-07-07 14:25    2014-07-07 15:25          0%                    0%
2014-07-07 13:25    2014-07-07 14:25          0%                    0%
------------------------------------------------------

**Table 1** Description of the **display nat statistics address-pool-usage** command output
Item	Description
Nat Instance	Name of a NAT instance.
Address Group	Address translation group name in the NAT instance.
StartTime	Start time.
EndTime	End time.
Avarage-usage	Average address pool usage.
Max-usage	Maximum address/port/session usage.
Slot	Slot ID.