display nat statistics

Function

The display nat statistics command displays address pool statistics.

Format

display nat statistics address-group { name group-name | id group-id } [ global-ip ip-address | { inside-ip | session } | verbose ] ^*

display nat statistics vsys vsys-name address-group group-name [ global-ip ip-address | { inside-ip | session } | verbose ] ^*

display nat statistics [ information | all-system | vsys vsys-name ]

display nat statistics global-pool global-pool-id [ global-ip ip-address | { inside-ip | session } | verbose ] ^*

Parameters

Parameter	Description	Value
vsys vsys-name	Specifies the name of a virtual system.	The value must be the name of an existing virtual system.
group-name	Specifies the name of the address pool.	The address pool must exist.
group-id	Specifies the id of the address pool.	The value range of the parameter is subject to the specific device model. Please refer to the actual data in practice.
global-ip ip-address	Specifies an IP address in the NAT address pool.	The value is in dotted decimal notation.
inside-ip	Indicates the number of private IP addresses to which each public IP address corresponds.	-
session	Indicates the number of sessions to which each public IP address corresponds.	-
verbose	Displays detailed NAT address pool statistics. Only the USG6635E/6655E, USG6680E and USG6712E/6716E support this parameter.	-
information	Displays NAT address pool information.	-
all-system	Displays address pool statistics of the root public and all virtual systems.	-
global-pool global-pool-id	Specifies the public address pool ID.	The value is an integer ranging from 1 to 2000.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The command displays the statistics only about the common NAT address pool and public address pool for static mapping, but not about DS-Lite or NAT64 address pool.

Before viewing statistics on a specific NAT address pool, enable the address pool statistics function globally or in the address pool view.

The display nat statistics command displays historical data within a specific period. If the configuration changes or data is updated, you cannot use this command to view the latest statistics until the next measurement period starts. You can run the display nat statistics information command to view the start time of the next measurement period or run the nat statistics interval command to set the interval for collecting NAT address pool statistics.

Example

# Display NAT address pool statistics.

<sysname> system-view
[sysname] nat statistics enable
 Info: This operation will cause the cpu busy, Continue? [Y/N] y
[sysname] nat address-group test 3
[sysname-address-group-test] statistics enable
[sysname] display nat statistics address-group name test
NAT statistics for address group "test" (0) 2015/9/24 17:51:14
 total global ip: 1, total section: 1
 total inside ip: 10, average inside ip: 10
 max inside ip: 10, global ip: 1.1.1.1, section: 0, session: 20
 total session: 20, average session: 20
 max session: 20, global ip: 1.1.1.1, section: 0, inside ip: 20
smart-ip session number: 0
Nat statistics for the device:
------------------------------------------------------------------
Global IP Address      Session Count          Inside IP Address Count
1.1.1.1                         20                               10

**Table 1** Description of the **display nat statistics** command output
Item	Description
total global ip	Total number of IP addresses involved in address pool statistics.
total section	Total number of IP address segments involved in address pool statistics.
total inside ip	Total number of private IP addresses.
average inside ip	Average number of intranet IP addresses.
max inside ip	Maximum number of private IP addresses to which a single public IP address in the address pool corresponds.
global ip	Public IP address that corresponds to the most private IP addresses.
section	Address segment where the public IP address resides.
session	Total number of sessions to which the public IP address corresponds.
total session	Total number of sessions to which the address pool corresponds.
average session	Average number of sessions per IP address in the address pool.
max session	Maximum number of sessions to which a single IP address in the address pool corresponds.
global ip	Public IP address that corresponds to the most sessions.
section	Address segment where the public IP address resides.
inside ip	Total number of private IP addresses to which the public IP address corresponds.
smart-ip session number	Number of sessions to which each address in the smart NAT address pool corresponds (this item is displayed only when the smart NAT address pool is configured).
Global IP Address	Public IP address.
Session Count	Total number of sessions to which the public IP address corresponds.
Inside IP Address Count	Total number of private IP addresses to which the public IP address corresponds. If the device has multiple CPUs (multiple fpaths) and the hash mode is source address + destination address, the Inside IP Address Count field displays the maximum number of private addresses counted by fpaths. In other conditions, the Inside IP Address Count field displays the total number of private IP addresses counted by fpaths.