display ip userlog

Function

The display ip userlog command displays the configurations of the function to generate and send user login and logout logs, as well as the statistics about user login and logout logs.

This command is supported only on the NetEngine 8000 F1A.

Format

display ip userlog [ access | call-status ] { config | statistic }

Parameters

Parameter	Description	Value
access	Displays information about user login and logout logs.	-
call-status	Displays information about user online result logs.	-
config	Displays configurations of the function to generate and send user login, logout, and online result logs.	-
statistic	Displays statistics about user login, logout, and online result logs.	-

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
bras-control	read

Usage Guidelines

Usage Scenario

Scenario	Command	Information
The function to generate and send user login and logout logs is enabled on the device.	To view configurations about the function to generate and send user login and logout logs, run the display ip userlog access config command.	Whether the function to generate and send user login and logout logs is enabled Version number of the packets used to send user login and logout logs IP address of the log server used to receive user login and logout logs UDP port number of the log server used to receive user login and logout logs Whether user login and logout logs are encapsulated and sent in syslog format
The function to generate and send user online result logs is enabled.	To view configurations about the function to generate and send user online result logs, run the display ip userlog call-status config command.	Whether the function to generate and send user online result logs is enabled IP address of the log server used to receive user online result logs UDP port number of the log server used to receive user online result logs
The function to generate and send user login, logout, and online result logs is enabled on the device.	To view configurations of the function to generate and send user login, logout, and online result logs, run the display ip userlog config command.	Whether the function to generate and send user login, logout, and online result logs is enabled Version number of the packets used to send user login and logout logs IP address of the log server used to receive user login and logout logs UDP port number of the log server used to receive user login, logout, and online result logs Whether user login and logout logs are encapsulated and sent in syslog format
The function to generate and send user login, logout, and online result logs is enabled.	To view statistics about user login, logout, and online result logs, run the display ip userlog [ access \| call-status ] statistic command.	Total number of received user login, logout, and online result logs. Total number of sent user login, logout, and online result logs. Total number of received packets carrying user login, logout, and online result logs. Total number of sent packets carrying user login, logout, and online result logs. Total number of lost user login, logout, and online result logs. Total number of lost packets carrying user login, logout, and online result logs.

Precautions

In VS mode, this command is supported only by the admin VS.

Example

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

# Display statistics about user login and logout logs.

<HUAWEI> display ip userlog access statistic
  ------------------ Access Log Statistic Information ------------------
 Received access logs                                   : 9
 Sent access logs                                       : 9
 Received access log packets                            : 1
 Sent access log packets successfully                   : 1
 Lost access logs                                       : 0
 Times of sending access packets failed                 : 0
 -----------------------------------------------------------------------
 Total print : 6

# Display statistics about user online result logs.

<HUAWEI> display ip userlog call-status statistic
 ----------------- Call-status Statistic Information -------------------
  Received call-status logs                             : 1068
  Sent call-status logs                                 : 1068
  Received call-status log packets                      : 163
  Sent call-status log packets successfully             : 163
  Lost call-status logs                                 : 0
  Times of sending call-status packets failed           : 0
 -----------------------------------------------------------------------
 Total print : 6

# Display configurations of user login and logout logs and user login result logs with the transport mode set to UDP.

<HUAWEI> display ip userlog config
  ---------------- Access Log Configuration Information ----------------
 Enable access log                                      : Yes
 Version of access log packet                           : 1
 IP address of export server of access log packet       : 192.168.0.2
 UDP port of export server of access log packet         : 514
 Enable access syslog format                            : Yes
 -----------------------------------------------------------------------
 Total print : 5
 ---------------- Call-status Configuration Information ----------------
  Enable call-status log                                :  Yes
  IP address of export server of call-status log packet : 192.168.100.43
  UDP port of export server of call-status log packet   : 514
 -----------------------------------------------------------------------

# Display configurations of user login result logs with the transport mode set to UDP.

<HUAWEI> display ip userlog call-status config
 ---------------- Call-status Configuration Information ----------------
  Enable call-status log                                :  Yes
  IP address of export server of call-status log packet : 192.168.100.43
  UDP port of export server of call-status log packet   : 514
 -----------------------------------------------------------------------
 Total print : 5

# Display configurations of user login and logout logs with the transport mode set to UDP.

<HUAWEI> display ip userlog access config
------------------ Access Log Configuration Information ----------------
 Enable access log                                      : Yes
 Version of access log packet                           : 1
 IP address of export server of access log packet       : 192.168.0.2
 UDP port of export server of access log packet         : 514
 Enable access syslog format                            : Yes
 -----------------------------------------------------------------------
 Total print : 5

# Display configurations of user login and logout logs and user login result logs with the transport mode set to TCP.

<HUAWEI> display ip userlog config
  ---------------- Access Log Configuration Information ----------------
 Enable access log                                      : Yes
 Version of access log packet                           : 1
 IP address of export server of access log packet       : 192.168.0.2
 UDP port of export server of access log packet         : 0
 Enable access syslog format                            : Yes
 TCP port of the server for exporting access log        : 601
 SSL policy of the server for exporting access log      : test
 SSL state                                              : connected
 -----------------------------------------------------------------------
 Total print : 8
 ---------------- Call-status Configuration Information ----------------
  Enable call-status log                                :  Yes
  IP address of export server of call-status log packet : 192.168.100.43
  UDP port of export server of call-status log packet   : 0
  TCP port of the server for exporting call-status log  : 601
  SSL policy of the server for exporting call-status log: test
  SSL state                                             : connected
 -----------------------------------------------------------------------

# Display configurations of user login result logs with the transport mode set to TCP.

<HUAWEI> display ip userlog call-status config
 ---------------- Call-status Configuration Information ----------------
  Enable call-status log                                :  Yes
  IP address of export server of call-status log packet : 192.168.100.43
  UDP port of export server of call-status log packet   : 0
  TCP port of the server for exporting call-status log  : 601
  SSL policy of the server for exporting call-status log: test
  SSL state                                             : connected
 -----------------------------------------------------------------------

# Display configurations of user login and logout logs with the transport mode set to TCP.

<HUAWEI> display ip userlog access config
------------------ Access Log Configuration Information ----------------
 Enable access log                                      : Yes
 Version of access log packet                           : 1
 IP address of export server of access log packet       : 192.168.0.2
 UDP port of export server of access log packet         : 0
 Enable access syslog format                            : Yes
 TCP port of the server for exporting access log        : 601
 SSL policy of the server for exporting access log      : test
 SSL state                                              : connected
 -----------------------------------------------------------------------
 Total print : 8

**Table 1** Description of the **display ip userlog** command output
Item	Description
Received access logs	Number of user login and logout logs received by the device.
Received access log packets	Number of packets carrying user login and logout logs received by the device.
Sent access logs	Number of user login and logout logs sent to the log server by the device.
Sent access log packets successfully	Number of packets carrying user login and logout records sent to the log server by the device.
Lost access logs	Number of user login and logout logs lost on the device.
Times of sending access packets failed	Number of times that the device fails to send packets carrying user login and logout logs to the log server.
Total print	Total number of records to be printed.
Enable access log	Whether the function to generate and send user login and logout logs is enabled. Yes. No.
Enable access syslog format	Whether user login and logout logs are sent in the syslog format. Yes: User login and logout logs are sent in the syslog format. In this format, one packet carries one user login or logout log. You can view the logs after the log server parses the packets. No: User login and logout logs are sent in the default format. The original logs are sent through packets to a log server. To parse the received packets, the log server must support the packet parsing mode specified by the By default, the devices uses packets to send original user login and logout logs to a log server..
Version of access log packet	Version of packets used to send user login and logout logs. Currently, there are four versions of log packets: version 1, version 2, version 3 and version 4. They differ in the VLAN/PVC format and the IPv6 information contained in packets. For details, see the ip userlog access export version command.
IP address of export server of access log packet	IP address of a log server used to receive user login and logout logs.
UDP port of export server of access log packet	ID of the UDP port through which a log server receives user login and logout logs.
TCP port of the server for exporting access log	TCP port number of the host that receives user login and logout log packets.
TCP port of the server for exporting call-status log	TCP port number of the host that receives user login and logout result information.
SSL policy of the server for exporting access log	SSL policy of the host that receives user login and logout log packets.
SSL state	SSL status of the host that receives log packets.
SSL policy of the server for exporting call-status log	SSL policy of the host that receives user login and logout result information.