Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
Guide That Contains This Content
[+] Expand All
[-] Collapse All

    Creating the Daily Directories

    Daily Directories Structure


    Using the IP/MPLSView convintftraf (“convert interface traffic”) utility, IP/MPLSView takes the traffic data as input (in the format described in Preparing the Traffic Data and converts it into a concise binary format, organized by “daily directories”, that is suitable for rapid aggregation using any of a choice of statistical computation methods. For example, it allows you to "roll-up" a week's worth of data into 24 hourly periods and display the hourly utilization based on the 95th percentile.

    The following explains the structure of the daily directories. These directories have names in date format such as:
    MAR19.01
    MAR20.01
    MAR21.01


    In each of these daily directories is a number of files- one file per device for which traffic was collected on that particular day.


    For example,


    >ls MAR19.01
    ROUTER1 ROUTER2 ROUTER3

    Thus, if interface traffic for Router1 was collected on all three days, there will be a binary file for Router1 under each of the three daily directories. These files are named by the router hostname rather than an IP address. The conversion from IP address to router hostname was done by referencing the interface map (“intfmap”) file generated during getipconf configuration extraction.


    Convintftraf (the Traffic Conversion Utility)


    The convintftraf utility takes the following arguments.

    Usage: convintftraf outtrafficdir router_interface_traffic_data1
    router_interface_traffic_data2 ... -i intfmap

    Or:


    Usage: convintftraf outtrafficdir router_interface_traffic_data1
    router_interface_traffic_data2 ... -i intfmap -t tunnel_file

    Example:


    convintftraf myOutput myData/*.dat -i intfmap.x -t tunnel.x

    Parameters

    Description

    outtrafficdir

    An output directory that will be the “repository” for the generated daily directories.

    router_interface_traffic_data1.. .n

    A list of the input files in the format described in Preparing the Traffic Data. These can be listed separately on the command line, or by using wildcards to specify all the files in a particular directory, as shown in the example.

    intfmap

    This is the interface map file (usually named “intfmap.runcode”), that is generated during configuration extraction.

    tunnel_file

    This file contains information on each tunnel in your network. It is also generated during the getipconf configuration extraction.

    Note: Creating the daily directories may take several hours for large data sets, depending on the number of days of traffic being processed and the number of interfaces/tunnels. This procedure should be executed only once on any given set of traffic data. If traffic for a large number of days or interfaces is to be processed at once, it is recommended that the task be run overnight.

    In order to check the progress of this function, the user can repeatedly check the contents of the outtrafficdir, to see what daily directories (e.g. “MAR19.01”) have been created so far.

    Modified: 2016-11-08