sFlow.org                                                    Peter Phaal
http://www.sFlow.org/                                        InMon Corp.
info@sflow.org
                                                          Anoop Ghanwani
                                                                    Dell



                                                           December 2011


                      sFlow LAG Counters Structure



Copyright Notice

Copyright (C) sFlow.org (2011). All Rights Reserved.

Abstract

This memo describes an sFlow version 5 structure for exporting Link
Aggregation (LAG) counters.

Table of Contents

1. Overview ......................................................  1
2. sFlow Datagram Extension ......................................  1
3. References ....................................................  2
4. Author's Addresses ............................................  2

1. Overview

   This document describes additional structures that allow an sFlow
   agent to export information relating to IEEE 802.1AX Link Aggregation
   Control Protocol (LACP) [1].  sFlow version 5 is an extensible
   protocol that allows the addition of new data structures without
   impacting existing collectors. This document does not change the
   sFlow version 5 protocol [2], it simply defines an additional,
   optional, data structure that a network device can use to report LAG
   metrics.

2. sFlow Datagram Extension

   An sFlow agent exporting a counter_sample for a port that is part of
   a LAG must include an if_counters structure and a lag_port_stats
   structure.  The lag_port_stats structure combines values from the
   dot3adAggPortTable and dot3adAggPortStatsTable. Both tables share



DRAFT                           sFlow.org                       [Page 1]

Version 0.3           sFlow LAG Counters Structure         December 2011


   dot3adAggPortIndex as the key and the values included in the
   lag_port_stats structure must correspond to the ifIndex reported in
   the if_counters structure.

/* LAG Port Statistics - see IEEE8023-LAG-MIB */
/* opaque = counter_data; enterprise = 0; format = 7 */

struct lag_port_stats {
  mac dot3adAggPortActorSystemID;
  mac dot3adAggPortPartnerOperSystemID;
  unsigned int dot3adAggPortAttachedAggID;
  opaque dot3adAggPortState[4]; /*
                             Bytes are assigned in following order:
                             index 0, value dot3adAggPortActorAdminState
                             index 1, value dot3adAggPortActorOperState
                             index 2, value dot3adAggPortPartnerAdminState
                             index 3, value dot3adAggPortPartnerOperState
                                 */
  unsigned int dot3adAggPortStatsLACPDUsRx;
  unsigned int dot3adAggPortStatsMarkerPDUsRx;
  unsigned int dot3adAggPortStatsMarkerResponsePDUsRx;
  unsigned int dot3adAggPortStatsUnknownRx;
  unsigned int dot3adAggPortStatsIllegalRx;
  unsigned int dot3adAggPortStatsLACPDUsTx;
  unsigned int dot3adAggPortStatsMarkerPDUsTx;
  unsigned int dot3adAggPortStatsMarkerResponsePDUsTx;
}

3. References

[1]  "IEEE Std 802.1AX-2008 IEEE Standard for Local and Metropolitan
     Area Networks - Link Aggregation", September 2008

[2]  Phaal, P. and Lavine, M., "sFlow Version 5",
     http://www.sflow.org/sflow_version_5.txt, July 2006

4. Author's Address

   Peter Phaal
   InMon Corp.
   580 California Street, 5th Floor
   San Francisco, CA 94104

   Phone: (415) 283-3263
   EMail: peter.phaal@inmon.com

   Anoop Ghanwani
   Dell



DRAFT                           sFlow.org                       [Page 2]

Version 0.3           sFlow LAG Counters Structure         December 2011


   350 Holger Way
   San Jose, CA 95134

   Phone: (408) 571-3228
   EMail: anoop@alumni.duke.edu














































DRAFT                           sFlow.org                       [Page 3]