Contents

Session-based NetStream commands· 1

display session-based netstream aggregation-cache· 1

session-based netstream aggregation· 2

session-based netstream enable· 3

session-based netstream export host 4

session-based netstream export source ip· 4

session-based netstream timeout 5

 

Session-based NetStream commands

display session-based netstream aggregation-cache

Use display session-based netstream aggregation-cache to display session-based NetStream statistics.

Syntax

display session-based netstream aggregation-cache { app | app-profile | app-user } *

Views

Any view

Predefined user roles

network-admin

network-operator

context-admin

context-operator

Parameters

app: Specifies the app aggregation mode.

app-profile: Specifies the app-profile aggregation mode.

app-user: Specifies the app-user aggregation mode.

Usage guidelines

To display session-based NetStream statistics in an aggregation mode, you must enable the aggregation mode by using the session-based netstream aggregation command.

Examples

# Display statistics about session-based NetStream in app aggregation mode.

<Sysname> display session-based netstream aggregation-cache app

Active entries                                   :1

Timeout time for session-based NetStream entries :10

------------------------------------------------------------------------------

AppID      InPkts     InBytes    OutPkts    OutBytes

------------------------------------------------------------------------------

22742      4          240        4          240

Total   Sessions : 1

Current Sessions : 1

SubsCribers      : 1

# Display statistics about session-based NetStream in app-profile aggregation mode.

<Sysname> display session-based netstream aggregation-cache app-profile

Active entries                                   :1

Timeout time for session-based NetStream entries :10

------------------------------------------------------------------------------

AppID      ProfileID  InPkts     InBytes    OutPkts    OutBytes

------------------------------------------------------------------------------

22742      0          4          240        4          240

Current Sessions : 1

New     Sessions : 0

# Display statistics about session-based NetStream in app-user aggregation mode.

<Sysname> display session-based netstream aggregation-cache app-user

Active entries                                   :1

Timeout time for session-based NetStream entries :10

------------------------------------------------------------------------------

AppID      UserIp           InPkts     InBytes    OutPkts    OutBytes

------------------------------------------------------------------------------

22742      8.8.8.8          4          240        4          240

Total   Sessions : 1

Current Sessions : 1

Table 1 Command output

Field	Description
Active entries	Number of active session-based NetStream entries.
Timeout time for session-based NetStream entries	Maximum period of time in minutes a session-based NetStream entry can be cached before being exported to NetStream servers.
App ID	Application layer protocol ID.
UserIP	User IP address.
ProfileID	Traffic rule ID in bandwidth management.
InPkts	Number of upstream packets.
InBytes	Number of upstream bytes.
OutPkts	Number of downstream packets.
OutBytes	Number of downstream bytes.
Total sessions	Total number of sessions.
New sessions	Number of new sessions established in the current statistics collection interval.
Current sessions	Number of concurrent sessions at the time the display session-based netstream aggregation-cache command was executed.
SubsCribers	Total number of users in the current statistics collection interval.

 

Related commands

session-based netstream aggregation

session-based netstream aggregation

Use session-based netstream aggregation to enable session-based NetStream aggregation modes.

Use undo session-based netstream aggregation to disable session-based NetStream aggregation modes.

Syntax

session-based netstream aggregation { app | app-profile | app-user } *

undo session-based netstream aggregation { app | app-profile | app-user } *

Default

All session-based NetStream aggregation modes are disabled.

Views

System view

Predefined user roles

network-admin

context-admin

Parameters

app: Specifies the app aggregation mode, which aggregates traffic by application layer protocol ID.

app-profile: Specifies the app-profile aggregation mode, which aggregates traffic by application layer protocol ID and profile ID.

app-user: Specifies the app-user aggregation mode, which aggregates traffic by application layer protocol ID and user IP address.

Examples

# Enable the app aggregation mode for session-based NetStream aggregation.

<Sysname> system-view

[Sysname] session-based netstream aggregation app

Related commands

display session-based netstream aggregation-cache

session-based netstream enable

Use session-based netstream enable to enable session-based NetStream.

Use undo session-based netstream enable to disable session-based NetStream.

Syntax

session-based netstream enable

undo session-based netstream enable

Views

System view

Default

Session-based NetStream is disabled.

Predefined user roles

network-admin

context-admin

Examples

# Enable session-based NetStream.

<Sysname> system-view

[Sysname] session-based netstream enable

session-based netstream export host

Use session-based netstream export host to specify a destination host for session-based NetStream data export.

Use undo session-based netstream export host to restore the default.

Syntax

session-based netstream export host ip-address udp-port [ vpn-instance vpn-instance-name ]

undo session-based netstream export host

Default

No destination host is specified for session-based NetStream data export.

Views

System view

Predefined user roles

network-admin

context-admin

Parameters

ip-address: Specifies the IP address of the destination host.

udp-port: Specifies the destination UDP port number in the range of 0 to 65535.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance to which the destination host belongs. The vpn-instance-name argument is a case-sensitive string of 1 to 31 characters. If the destination host is on the public network, do not specify this option.

Examples

# Export session-based NetStream data to UDP port 9020 on host 172.16.1.1.

<Sysname> system-view

[Sysname] session-based netstream export host 172.16.1.1 9020

session-based netstream export source ip

Use session-based netstream export source ip to specify a source IP address for session-based NetStream packets.

Use undo session-based netstream export source ip to restore the default.

Syntax

session-based netstream export source ip ip-address

undo session-based netstream export source ip

Default

The source IP address of session-based NetStream packets is the primary IP address of the output interface.

Views

System view

Predefined user roles

network-admin

context-admin

Parameters

ip-address: Specifies an IP address.

Examples

# Specify 172.16.1.1 as the source IP address for session-based NetStream packets.

<Sysname> system-view

[Sysname] session-based netstream export source ip 172.16.1.1

session-based netstream timeout

Use session-based netstream timeout to set the aging timer for session-based NetStream entries.

Use undo session-based netstream timeout to restore the default.

Syntax

session-based netstream timeout minutes

undo session-based netstream timeout

Default

A session-based NetStream entry is automatically aged out and exported after being cached for 5 minutes.

Views

System view

Predefined user roles

network-admin

context-admin

Parameters

minutes: Sets the aging timer in minutes. The value range is 1 to 10.

Usage guidelines

When the aging timer for a session-based NetStream entry expires, statistics about the entry is cleared from the cache and exported to the NetStream servers.

Examples

# Set the aging timer for session-based NetStream entries to 5 minutes.

<Sysname> system-view

[Sysname] session-based netstream timeout 10