asg_ifconfig

This command is supported only on these:

  • ElasticXL Cluster

  • Maestro Security Group

  • Scalable Chassis Security Group

Notes:

  • You can run this command in Gaia gClish or in the Expert mode.

  • If you run this command in the context of a Traditional VSX Virtual System, you can only see the output that applies to that context.

Description

Collects traffic statistics from all or a specified range of Security Group Members.

The combined output shows the traffic distribution between Security Group Members and their interfaces (calculated during a certain period).

The "asg_ifconfig" command has these modes:

Mode

Instructions

Native

This is the default setting.

When you do not specify the "analyze" or "banalyze" option in the syntax, the command behaves almost in the same as the native Linux "ifconfig" command.

However, the output shows statistics for all interfaces on all Security Group Members, and for interfaces on the local Security Group Member.

Analyze

Shows accumulated traffic information and traffic distribution between Security Group Members.

Banalyze

Shows accumulated traffic information and traffic distribution between interfaces.

Note - The parameters "analyze" and "banalyze" are mutually exclusive.

You cannot specify them in the same command.

Syntax

asg_ifconfig -h

asg_ifconfig [-b <SGM IDs>] [<Name of Interface>] [analyze [-d <Delay>] [-a] [-v]]

asg_ifconfig [-b <SGM IDs>] [<Name of Interface>] [banalyze [-d <Delay>] [-a] [-v] [-rb] [-rd] [-rp] [-tb] [-td] [-tp]]

Note - To run this command continuously, use "asg_ifconfig_m" instead of "asg_ifconfig".

Parameters

Parameter

Description

-h

Shows the built-in help.

-b <SGM IDs>

Applies to Security Group Members as specified by the <SGM IDs>.

<SGM IDs> can be:

  • No <SGM IDs> specified, or all

    Applies to all Security Group Members and all Sites

  • One Security Group Member (for example, 1_1)

  • A comma-separated list of Security Group Members (for example, 1_1,1_4)

  • A range of Security Group Members (for example, 1_1-1_4)

  • One Site (chassis1, or chassis2)

  • The Active Site (chassis_active)

<Name of Interface>

Specifies the name of the interface.

analyze

Shows accumulated traffic information and traffic distribution between the Security Group Members.

Use the "-a", "-v", and "-d <Delay>" parameters to show traffic distribution between interfaces.

banalyze

Shows accumulated traffic information and traffic distribution between the interfaces.

Use the "-a", "-v", and "-d <Delay>" parameters to show traffic distribution between interfaces.

By default, the traffic distribution table is not sorted.

You can use these parameters to sort the traffic distribution table:

  • -rb - Sort the output by the number of received (RX) bytes

  • -rd - Sort the output by the number of received (RX) dropped packets

  • -rp - Sort the output by the number of received (RX) packets

  • -tb - Sort the output by the number of transmitted (TX) bytes

  • -td - Sort the output by the number of transmitted (TX) dropped packets

  • -tp - Sort the output by the number of transmitted (TX) packets

For example, if you sort with the "-rb" option, the higher values appear at the top of the "RX bytes" column:

SGM ID  RX packets   RX bytes   RX dropped
1_03                   70%
1_02                   20%
1_01                   10%

-d <Delay>

Delay, in seconds, between data samples.

Default: 5 seconds.

-a

Shows total traffic volume.

By default (without "-a"), the output shows the average traffic volume per second.

-v

Verbose mode.

Shows detailed information of each interface and the accumulated traffic information

Examples

This example shows the total traffic sent and received by the interface eth2-01 for all Security Group Members on the Active Site 1.

By default, the output shows the average traffic volume per second.

[Expert@SG-s01-01:0]# gclish
[Global] SG-s01-01> asg_ifconfig -b chassis1 eth2-01

as1_02:
eth2-01     Link encap:Ethernet  HWaddr 00:1C:7F:81:01:EA
            UP BROADCAST RUNNING SLAVE MULTICAST  MTU:1500  Metric:1
            RX packets:94 errors:0 dropped:0 overruns:0 frame:0
            TX packets:63447 errors:0 dropped:0 overruns:0 carrier:0
            collisions:0 txqueuelen:0
            RX bytes:5305 (5.1 KiB)  TX bytes:5688078 (5.4 MiB)

1_03:
eth2-01     Link encap:Ethernet  HWaddr 00:1C:7F:81:01:EA
            UP BROADCAST RUNNING SLAVE MULTICAST  MTU:1500  Metric:1
            RX packets:137 errors:0 dropped:0 overruns:0 frame:0
            TX packets:26336 errors:0 dropped:0 overruns:0 carrier:0
            collisions:0 txqueuelen:0
            RX bytes:7591 (7.4 KiB)  TX bytes:2355386 (2.2 MiB)

1_04:
eth2-01     Link encap:Ethernet  HWaddr 00:1C:7F:81:01:EA
            UP BROADCAST RUNNING SLAVE MULTICAST  MTU:1500  Metric:1
            RX packets:124 errors:0 dropped:0 overruns:0 frame:0
            TX packets:3098 errors:0 dropped:0 overruns:0 carrier:0
            collisions:0 txqueuelen:0
            RX bytes:6897 (6.7 KiB)  TX bytes:378990 (370.1 KiB)

1_05:
eth2-01     Link encap:Ethernet  HWaddr 00:1C:7F:81:01:EA
            UP BROADCAST RUNNING SLAVE MULTICAST  MTU:1500 Metric:1
            RX packets:79 errors:0 dropped:0 overruns:0 frame:0
            TX packets:26370 errors:0 dropped:0 overruns:0 carrier:0
            collisions:0 txqueuelen:0
            RX bytes:4507 (4.4 KiB)  TX bytes:2216546 (2.1 MiB)
[Global] SG-s01-01>

This example shows:

  • The accumulated and detailed traffic volume statistics for the interface eth2-Sync for each Security Group Member.

  • The total for all Security Group Members.

  • The traffic distribution for each Security Group Member.

  • The "-a" option shows the total traffic volume instead of the average volume per second.

[Expert@SG-s01-01:0]# gclish
[Global] SG-s01-01> asg_ifconfig eth2-Sync analyze -v -a
Command is executed on SGMs: chassis_active

1_01:
eth2-Sync   Link encap:Ethernet  HWaddr 00:1C:7F:01:04:FE
            UP BROADCAST RUNNING SLAVE MULTICAST  MTU:1500  Metric:1
            RX: packets:225018 bytes:36970520 (37.0 MiB)  dropped:0
            TX: packets:3522445 bytes:1381032583 (1.4 GiB)  dropped:0

1_02:
eth2-Sync   Link encap:Ethernet  HWaddr 00:1C:7F:02:04:FE
            UP BROADCAST RUNNING SLAVE MULTICAST  MTU:1500  Metric:1
            RX: packets:221395 bytes:35947248 (35.9 MiB)  dropped:0
            TX: packets:4674143 bytes:1850315554 (1.9 GiB)  dropped:0

1_03:
eth2-Sync   Link encap:Ethernet  HWaddr 00:1C:7F:03:04:FE
            UP BROADCAST RUNNING SLAVE MULTICAST  MTU:1500  Metric:1
            RX: packets:10 bytes:644 (644.0 b)  dropped:0
            TX: packets:67826313 bytes:7345458105 (7.3 GiB)  dropped:0

1_04:
eth2-Sync   Link encap:Ethernet  HWaddr 00:1C:7F:04:04:FE
            UP BROADCAST RUNNING SLAVE MULTICAST  MTU:1500  Metric:1
            RX: packets:13 bytes:860 (860.0 b)  dropped:0
            TX: packets:68489217 bytes:7487476060 (7.5 GiB)  dropped:0

1_05:
eth2-Sync   Link encap:Ethernet  HWaddr 00:1C:7F:05:04:FE
            UP BROADCAST RUNNING SLAVE MULTICAST  MTU:1500  Metric:1
            RX: packets:203386 bytes:19214238 (19.2 MiB)  dropped:0
            TX: packets:7164109 bytes:2740761091 (2.7 GiB)  dropped:0

=*= Accumulative =*=
eth2-Sync   Link encap:Ethernet
            UP BROADCAST RUNNING SLAVE MULTICAST  MTU:1500  Metric:1
            RX: packets:649822 bytes:92133510 (92.1 MiB)  dropped:0
            TX: packets:151676227 bytes:20805043393 (20.8 GiB)  dropped:0

=*= Traffic Distribution =*=

-----------------------------------------------------------------------------
     SGM ID RX packets   RX bytes RX dropped TX packets   TX bytes TX dropped
-----------------------------------------------------------------------------
       1_01      34.6%      40.1%       0.0%       2.3%       6.6%       0.0%
       1_02      34.1%      39.0%       0.0%       3.1%       8.9%       0.0%
       1_03       0.0%       0.0%       0.0%      44.7%      35.3%       0.0%
       1_04       0.0%       0.0%       0.0%      45.2%      36.0%       0.0%
       1_05      31.3%      20.9%       0.0%       4.7%      13.2%       0.0%
-----------------------------------------------------------------------------
[Global] SG-s01-01>

This example shows:

  • The accumulated and detailed traffic volume statistics for the interface eth2-Sync on each Security Group Member.

  • The total on each Security Group Member.

  • The traffic distribution on each Security Group Member.

  • The "-a" option shows the total traffic volume instead of the average volume per second.

[Expert@SG-s01-01:0]# gclish
[Global] SG-s01-01> asg_ifconfig eth2-Sync banalyze -v -a
Command is executed on SGMs: chassis_active

1_01:
eth2-Sync   Link encap:Ethernet  HWaddr 00:1C:7F:01:04:FE
            UP BROADCAST RUNNING SLAVE MULTICAST  MTU:1500  Metric:1
            RX: packets:225018 bytes:36970520 (37.0 MiB)  dropped:0
            TX: packets:3522445 bytes:1381032583 (1.4 GiB)  dropped:0

=*= Accumulative =*=
            RX: packets:225018 bytes:36970520 (37.0 MiB)  dropped:0
            TX: packets:3522445 bytes:1381032583 (1.4 GiB)  dropped:0

=*= Traffic Distribution =*=

-----------------------------------------------------------------------------
  Interface RX packets RX bytes RX dropped TX packets TX bytes TX dropped
-----------------------------------------------------------------------------
 eth2-Sync  100.0%     100.0%     0.0%     100.0%     100.0%   0.0%
-----------------------------------------------------------------------------

1_02:
eth2-Sync   Link encap:Ethernet  HWaddr 00:1C:7F:02:04:FE
            UP BROADCAST RUNNING SLAVE MULTICAST  MTU:1500  Metric:1
            RX: packets:221395 bytes:35947248 (35.9 MiB)  dropped:0
            TX: packets:4674143 bytes:1850315554 (1.9 GiB)  dropped:0

=*= Accumulative =*=
            RX: packets:221395 bytes:35947248 (35.9 MiB)  dropped:0
            TX: packets:4674143 bytes:1850315554 (1.9 GiB)  dropped:0

=*= Traffic Distribution =*=

-----------------------------------------------------------------------------
  Interface RX packets RX bytes RX dropped TX packets TX bytes TX dropped
-----------------------------------------------------------------------------
 eth2-Sync  100.0%     100.0%     0.0%     100.0%     100.0%   0.0%
-----------------------------------------------------------------------------

1_03:
eth2-Sync   Link encap:Ethernet  HWaddr 00:1C:7F:03:04:FE
            UP BROADCAST RUNNING SLAVE MULTICAST  MTU:1500  Metric:1
            RX: packets:10 bytes:644 (644.0 b)  dropped:0
            TX: packets:67826313 bytes:7345458105 (7.3 GiB)  dropped:0

=*= Accumulative =*=
            RX: packets:10 bytes:644 (644.0 b)  dropped:0
            TX: packets:67826313 bytes:7345458105 (7.3 GiB)  dropped:0

=*= Traffic Distribution =*=

-----------------------------------------------------------------------------
  Interface RX packets RX bytes RX dropped TX packets TX bytes TX dropped
-----------------------------------------------------------------------------
 eth2-Sync  100.0%     100.0%     0.0%     100.0%     100.0%   0.0%
-----------------------------------------------------------------------------

1_04:
eth2-Sync   Link encap:Ethernet  HWaddr 00:1C:7F:04:04:FE
            UP BROADCAST RUNNING SLAVE MULTICAST  MTU:1500  Metric:1
            RX: packets:13 bytes:860 (860.0 b)  dropped:0
            TX: packets:68489217 bytes:7487476060 (7.5 GiB)  dropped:0

=*= Accumulative =*=
            RX: packets:13 bytes:860 (860.0 b)  dropped:0
            TX: packets:68489217 bytes:7487476060 (7.5 GiB)  dropped:0

=*= Traffic Distribution =*=

-----------------------------------------------------------------------------
  Interface RX packets RX bytes RX dropped TX packets TX bytes TX dropped
-----------------------------------------------------------------------------
 eth2-Sync  100.0%     100.0%     0.0%     100.0%     100.0%   0.0%
-----------------------------------------------------------------------------

1_05:
eth2-Sync   Link encap:Ethernet  HWaddr 00:1C:7F:05:04:FE
            UP BROADCAST RUNNING SLAVE MULTICAST  MTU:1500  Metric:1
            RX: packets:203386 bytes:19214238 (19.2 MiB)  dropped:0
            TX: packets:7164109 bytes:2740761091 (2.7 GiB)  dropped:0

=*= Accumulative =*=
            RX: packets:203386 bytes:19214238 (19.2 MiB)  dropped:0
            TX: packets:7164109 bytes:2740761091 (2.7 GiB)  dropped:0

=*= Traffic Distribution =*=

-----------------------------------------------------------------------------
  Interface RX packets RX bytes RX dropped TX packets TX bytes TX dropped
-----------------------------------------------------------------------------
 eth2-Sync  100.0%     100.0%     0.0%     100.0%     100.0%   0.0%
-----------------------------------------------------------------------------

=*= All Blades =*=
      RX: packets:649822 bytes:92133510 (92.1 MiB)  dropped:0
      TX: packets:148153782 bytes:20805043393(20.8 GiB)  dropped:0

=*= Traffic Distribution =*= (all blades)

-----------------------------------------------------------------------------
  Interface RX packets RX bytes RX dropped TX packets TX bytes TX dropped
-----------------------------------------------------------------------------
 eth2-Sync  100.0%     100.0%     0.0%     100.0%     100.0%   0.0%
-----------------------------------------------------------------------------
[Global] SG-s01-01>