Network Working Group                                        N. Brownlee
Request for Comments: 2721                    The University of Auckland
Category: Informational                                     October 1999


                     RTFM: Applicability Statement

Status of this Memo

   This memo provides information for the Internet community.  It does
   not specify an Internet standard of any kind.  Distribution of this
   memo is unlimited.

Copyright Notice

   Copyright (C) The Internet Society (1999).  All Rights Reserved.

Abstract

   This document provides an overview covering all aspects of Realtime
   Traffic Flow Measurement, including its area of applicability and its
   limitations.

Table of Contents

   1  The RTFM Documents . . . . . . . . . . . . . . . . . . . . . .  2
   2  Brief Technical Specification (TS) . . . . . . . . . . . . . .  3
   3  Applicability Statement (AS) . . . . . . . . . . . . . . . . .  3
   4  Limitations  . . . . . . . . . . . . . . . . . . . . . . . . .  4
   5  Security Considerations  . . . . . . . . . . . . . . . . . . .  5
   6  Policy Considerations  . . . . . . . . . . . . . . . . . . . .  6
   7  Soundness  . . . . . . . . . . . . . . . . . . . . . . . . . .  6
   8  Appendix A: WG Report on the Meter MIB . . . . . . . . . . . .  8
   9  References . . . . . . . . . . . . . . . . . . . . . . . . . .  9
   10 Author's Address . . . . . . . . . . . . . . . . . . . . . . .  9
   11 Full Copyright Statement . . . . . . . . . . . . . . . . . . . 10















Brownlee                     Informational                      [Page 1]

RFC 2721             RTFM: Applicability Statement          October 1999


1  The RTFM Documents

   The RTFM Traffic Measurement System has been developed by the
   Realtime Traffic Flow Measurement Working Group.  It is described in
   six other documents, as follows:

   [ACT-BKG] Internet Accounting: Background             (Informational)

      Sets out the requirements for a usage reporting system for network
      traffic.  Sketches out the RTFM Architecture (meters, meter
      readers and managers) allowing for multiple meters and meter
      readers, with asynchronous reading from the meters.  Proposes
      methods of classifying traffic flows, the need for flows to be
      bi-directional (with separate sets of counters for each direction)
      and the need for each packet to be counted in a single flow (the '
      count in one bucket' principle).

   [RTFM-ARC] RTFM Architecture                          (Informational)

      Defines the RTFM Architecture, giving descriptions of each
      component.  Explains how traffic flows are viewed as logical
      entities described in terms of their address-attribute values, so
      that each is defined by the attributes of its end-points.  Gives a
      detailed description of the RTFM traffic meter, with full details
      of how flows are stored in the meter's flow table, and how packets
      are matched in accordance with rules stored in a ruleset.

   [RTFM-MIB] RTFM Meter MIB                         (Proposed Standard)

      Describes the SNMP Management Information Base for an RTFM meter,
      including its flow table, rule table (storing the meter's
      rulesets) and the control tables used for managing a meter and
      reading flow data from it.

   [RTFM-SRL] SRL: A Language for Describing Traffic     (Informational)
              Flows and Specifying Actions for Flow Groups

      An RTFM ruleset is an array of rules, used by the meter to decide
      which flows are of interest, which end-point is the flow source,
      and how much detail (i.e. what attribute values) must be saved for
      each flow.  SRL is a high-level language providing a clear,
      logical way to write rulesets.  It should also be useful for other
      applications which select flows and perform actions upon them,
      e.g. packet-marking gateways, RSVP policy agents, etc.







Brownlee                     Informational                      [Page 2]

RFC 2721             RTFM: Applicability Statement          October 1999


   [RTFM-NEW] RTFM New Attributes                         (Experimental)

      There has been considerable interest from users in extending the
      RTFM Architecture so as to allow a meter to report on an increased
      number of flow-related measures.  This RFC documents work on
      specifying such measures (the 'new' attributes) and reports on
      experience of implementing them.

   [RTFM-NTM] RTFM: Experiences with NeTraMet            (Informational)

      NeTraMet is a free software implementation of the RTFM
      Architecture which has been available since 1993.  This RFC
      records RTFM implementation experience gained with NeTraMet up to
      late 1996.  One particularly important result is the realisation
      that groups of rules which test the same attribute using the same
      mask can be implemented as a single hashed comparison, allowing
      the meter to rapidly determine whether a packet belongs to one of
      a large number of networks.

2  Brief Technical Specification (TS)

   RTFM provides for the measurement of network traffic 'flows', i.e.

   - a method of specifying traffic flows within a network
   - a hierarchy of devices (meters, meter readers, managers) for
     measuring the specified flows
   - a mechanism for configuring meters and meter readers, and for
     collecting the flow data from remote meters

   RTFM provides high time resolution for flow first- and last-packet
   times.  Counters for long-duration flows may be read at intervals
   determined by a manager.  The RTFM Meter is designed so as to do as
   much data reduction work as possible, which minimizes the amount of
   data to be read and the amount of processing needed to produce useful
   reports from it.

   RTFM flow data can be used for a wide range of purposes, such as
   usage accounting, long-term recording of network usage (classified by
   IP address attributes) and real-time analysis of traffic flows at
   remote metering points.

3  Applicability Statement (AS)

   To use RTFM for collecting network traffic information one must first
   consider where in the network traffic flows are to be measured.  Once
   that is decided, an RTFM Meter must be installed at each chosen
   measurement point.




Brownlee                     Informational                      [Page 3]

RFC 2721             RTFM: Applicability Statement          October 1999


   At least one Meter Reader is needed to collect the measured data from
   the meters, and a single Manager is needed to control the meters and
   meter readers.

   RTFM Meters may be single- or multi-user hosts running a meter
   program (one such program is available as free software, a second is
   under development at IBM Research).  Alternatively, meters could be
   run as firmware in switches or routers.  A hybrid approach in which
   an RTFM meter takes raw traffic data from a router provides another
   useful implementation path.

   RTFM Managers are programs running on a host, communicating with
   meters and meter readers via the network.  For this purpose meters
   are SNMP agents implementing the RTFM Meter MIB, and managers are
   SNMP clients using the Meter MIB to store and access the flow data.

4  Limitations

   RTFM is designed to measure traffic flows for traffic passing a point
   in a network.  If packets for a flow pass the metering point in both
   directions the meter will match them up, providing counters for each
   direction.  If packets only pass in one direction the meter can only
   provide counts for that direction.

   Users of RTFM should note that installing meters, meter readers and
   managers merely provides one with the capability to collect flow
   data.  Further installation work will be needed to develop
   configuration files (RTFM rulesets) for each meter, data processing
   applications to analyse the flow data, and various scripts, cron
   jobs, etc.  so as to create a useful production-quality measurement
   system which suits a user's particular needs.

   One of the strengths of RTFM is its ability to collect flow data at
   whatever level of detail (or 'granularity') is required.  It can be
   tempting to simply collect 'all possible data', but there are severe
   resource constraints.  If one tries to save the complete address-
   attribute value for all attributes of every possible flow a very
   large amount of data may be produced rapidly, but the meter has only
   a finite amount of memory for its flow table.  A better approach is
   to save the minimum amount of data required to achieve the
   measurement system goals.

   For example, to collect usage data so as to bill subscribers
   identified by their IP address one could just save the full IP
   address, nothing more.  The RTFM meter would produce flow data for
   each subscriber IP address, with PDU and Octet counts for data sent
   and received, which would be the minimum needed to produce bills.  In
   practice one would probably want to save at least part of the



Brownlee                     Informational                      [Page 4]

RFC 2721             RTFM: Applicability Statement          October 1999


   Destination IP address, which would allow the production of usage
   logs showing subscriber activity over time.

   The simplest way to determine how much detail can be collected is to
   create an initial ruleset which collects the minimum amount, then to
   modify it step by step, gradually increasing the amount of
   information saved for each flow.  An RTFM meter ought to provide some
   measures of its own performance (e.g. number of active flows,
   percentage idle processor time, packets metered, packets not
   metered).  Such measures will be implementation-specific, but should
   allow a user to assess the impact of each change to the ruleset.

   If the network data rate is too high, i.e. the meter reports that it
   cannot meter all the packets even with the initial ruleset above, one
   may be able to use other strategies.  For example one could

   - run the meter on a faster computer, e.g. move from a DOS PC to a
     workstation, or perhaps use a meter implemented in firmware within
     a switch or router.

   - use sampling.  The details of such sampling are not defined within
     the RTFM Architecture, but the Meter MIB provides one simple method
     by allowing one to specify that only every nth packet on an
     interface will be metered.   This would probably not be acceptable
     for producing billing data, but might well be acceptable for
     traffic engineering purposes.

5  Security Considerations

   These are discussed in detail in the Architecture and Meter MIB
   documents.  In brief, an RTFM Meter is an SNMP agent which observes a
   network and collects flow data from it.  Since it doesn't control the
   network directly, it has no direct effect on network security.

   On the other hand, the flow data itself may well be valuable - to the
   network operator (as billing data) or to an attacker (who may wish to
   modify that data, or the meter's ruleset(s)).  It is therefore
   important to take proper precautions to ensure that access to the
   meter and its data is sufficiently secure.

   For example, a meter port attached to a network should be passive, so
   that it cannot respond to login attempts of any kind.  Control and
   data connections to a meter should be via a secure management
   network.  Finally, suitable security should be established for the
   meter, as it would be for any other SNMP agent.






Brownlee                     Informational                      [Page 5]

RFC 2721             RTFM: Applicability Statement          October 1999


   Meters may, like any other network component, be subjected to Denial
   of Service and other attacks.  These are outside the RTFM
   Architecture - countermeasures for them are available, but are also
   outside RTFM.

6  Policy Considerations

   When collecting traffic data, one must have well-defined operations
   policies covering points such as:

   - Exactly what data is to be collected, at what level of detail?
   - How long will the data be kept?
   - What may the data be used for?
   - Who will be allowed to see the raw data?
   - May summaries of the data be shown to other people?

   Policy issues such as these should normally be considered as part of
   an organisation's Network Security Policy.

   Other policy issues relating more directly to the traffic data are
   essentially part of the measurement system design, such as:

   - How much time resolution is required for the data?
     (Less resolution implies longer collection intervals, but that may
     require more memory in the meters to hold flow data between
     collections).

   - What level of hardware redundancy is needed?
     (A single meter and meter reader is generally enough.  For greater
     reliability, meters and meter readers can be duplicated).

   - Who is allowed to use the system?
     (Approved users will need permissions to download rulesets to the
     meters, and to collect their data, possibly via their own meter
     readers).

7  Soundness

   NeTraMet, the first implementation of the RTFM Architecture, has been
   in use worldwide since 1994.  Currently there are many organisations,
   large and small, using it to collect traffic data for billing
   purposes.

   One example of these is Kawaihiko, the New Zealand Universities'
   Network, which has seven RTFM meters located at sites throughout New
   Zealand.  One of the sites is NZIX, the New Zealand Internet eXchange
   at the University of Waikato, where Kawaihiko has a meter (attached
   to a 100baseT network) observing traffic flows across the exchange to



Brownlee                     Informational                      [Page 6]

RFC 2721             RTFM: Applicability Statement          October 1999


   each of Kawaihiko's three international Internet Service Providers.
   5-minute Octet counts are collected from all the Kawaihiko meters by
   a single meter reader at Auckland.  Traffic data from the meters is
   used to determine the cost per month for each of the Kawaihiko sites.

   It is difficult to estimate how many organisations are using RTFM
   traffic measurement.  There are about 250 people on the NeTraMet
   mailing list, which often carries questions like 'why doesn't this
   ruleset do what I meant'?  Once new users have the system running,
   however, they tend to simply use it without further comment.

   From time to time the list provides useful feedback.  For example,
   early in 1998 there were two very significant user contributions:

   - Jacek Kowalski (Telstra, Melbourne) described an improved hash
     algorithm for NeTraMet's flow table, which provided almost an order
     of magnitude improvement in packet-handling performance.

   - Kevin Hoadley (JANET, U.K.) reported having problems with very
     large rulesets.  These were resolved, and better methods of
     downloading rules developed, allowing NeTraMet to work well for
     rulesets with more than 32,000 rules.

   Perhaps one reason why there is little discussion of NeTraMet's use
   in collecting billing data is that users may consider that the way
   collect their data is a commercially sensitive matter.

























Brownlee                     Informational                      [Page 7]

RFC 2721             RTFM: Applicability Statement          October 1999


8  Appendix A: WG Report on the Meter MIB

   The Meter MIB (in its current form) was developed early in 1996.  It
   was produced as an SNMPv2 MIB, following a number of detailed (and
   continuing) discussions with David Perkins beginning at the Dallas
   IETF meeting in December 1995.

   There are two current implementations:

   - NeTraMet (Nevil Brownlee, The University of Auckland)

   - IBM Meter (Sig Handelman & Stephen Stibler, IBM Research, N.Y, Bert
     Wijnen provided further help with SNMP)

   The NeTraMet meter is a stand-alone SNMP agent using an SNMPv2C
   implementation derived from CMU SNMPv2.

   The IBM meter runs as a sub-agent on an AIX system.  All the meter
   code has been written by Stephen Stibler - it was not derived from
   the NeTraMet code.  Stephen has found it useful to use nifty, one of
   NeTraMet's manager/reader programs, to test the IBM meter.

   As indicated above, there have only been two implementors to date,
   and the Working Group consensus has been very strong.

   The MIB has one unusual aspect:  the method used to read large
   amounts of data from its Flow Table.  An earlier SNMPv1 version of
   the MIB was in use from 1992 to 1997; it used opaque objects to read
   column slices from the flow table for flows which had been active
   since a specified time.  This was very non-standard (or at least very
   application-specific).

   With the change to SNMPv2 we were able to use 64-bit counters for
   PDUs and Octets, RowStatus variables for control tables and GETBULK
   requests to read rows from the flow table.  We also use the
   TimeFilter convention from the RMON2 MIB to select flows to be read;
   this gives the meter MIB a strong resemblance to RMON2.

   The current MIB introduces a better way of reading large amounts of
   data from the flow table.  This is the 'DataPackage' convention,
   which specifies the attribute values to be read from a flow table
   row.  The meter returns the values for each required attribute within
   a BER-encoded sequence.  This means there is only one object
   identifier for the whole sequence, greatly reducing the number of
   bytes required to retrieve the data.  The combination of






Brownlee                     Informational                      [Page 8]

RFC 2721             RTFM: Applicability Statement          October 1999


   TimeFilter:  to select the flows to be read
   DataPackage: to select the attributes required for each flow
   GetBulk:     to read many flows with a single SNMP PDU

   provides a very effective way to read flow data from a traffic meter.

9  References

   [ACT-BKG]  Mills, C., Hirsch, G. and G. Ruth, "Internet Accounting
              Background", RFC 1272, November 1991.

   [RTFM-ARC] Brownlee, N., Mills, C. and G. Ruth, "Traffic Flow
              Measurement: Architecture", RFC 2722, October 1999.

   [RTFM-MIB] Brownlee, N., "Traffic Flow Measurement: Meter MIB", RFC
              2720, October 1999.

   [RTFM-NEW] Handelman, S., Stibler, S., Brownlee, N. and G. Ruth,
              "RTFM: New Attributes for Traffic Flow Measurement", RFC
              2724, October 1999.

   [RTFM-NTM] Brownlee, N., "Traffic Flow Measurement: Experiences with
              NeTraMet", RFC 2123, March 1997.

   [RTFM-SRL] Brownlee, N., "SRL: A Language for Describing Traffic
              Flows and Specifying Actions for Flow Groups", RFC 2723,
              October 1999.

10  Author's Address

   Nevil Brownlee
   Information Technology Systems & Services
   The University of Auckland
   Private Bag 92-019
   Auckland, New Zealand

   Phone: +64 9 373 7599 x8941
   EMail: n.brownlee@auckland.ac.nz













Brownlee                     Informational                      [Page 9]

RFC 2721             RTFM: Applicability Statement          October 1999


11  Full Copyright Statement

   Copyright (C) The Internet Society (1999).  All Rights Reserved.

   This document and translations of it may be copied and furnished to
   others, and derivative works that comment on or otherwise explain it
   or assist in its implementation may be prepared, copied, published
   and distributed, in whole or in part, without restriction of any
   kind, provided that the above copyright notice and this paragraph are
   included on all such copies and derivative works.  However, this
   document itself may not be modified in any way, such as by removing
   the copyright notice or references to the Internet Society or other
   Internet organizations, except as needed for the purpose of
   developing Internet standards in which case the procedures for
   copyrights defined in the Internet Standards process must be
   followed, or as required to translate it into languages other than
   English.

   The limited permissions granted above are perpetual and will not be
   revoked by the Internet Society or its successors or assigns.

   This document and the information contained herein is provided on an
   "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
   TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
   BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
   HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
   MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

Acknowledgement

   Funding for the RFC Editor function is currently provided by the
   Internet Society.



















Brownlee                     Informational                     [Page 10]