Cflowd Configuration Command Reference

Command Hierarchies

config
[no] cflowd
active-timeout minutes
cache-size num-entries
— no cache-size
collector ip-address[:port] [version {5 | 8 | 9 | 10}]
— no collector ip-address[:port]
[no] aggregation
[no] as-matrix
[no] protocol-port
[no] raw
[no] source-prefix
autonomous-system-type {origin | peer}
description description-string
[no] shutdown
template-set {basic | mpls-ip | l2-ip | mpls-transport}
export-mode [automatic | manual]
inactive-timeout seconds
overflow percent
— no overflow
rate sample-rate
— no rate
[no] shutdown

Command Descriptions

Global Commands

cflowd

Syntax 
[no] cflowd
Context 
config>cflowd
Description 

This command creates the context to configure cflowd.

The no form of this command removes all configuration under cflowd including the deletion of all configured collectors. This can only be executed if cflowd is in a shutdown state.

Default 

no cflowd

active-timeout

Syntax 
active-timeout minutes
no active-timeout
Context 
config>cflowd
Description 

This command configures the maximum amount of time before an active flow is aged out of the active cache. If an individual flow is active for this amount of time, the flow is aged out and a new flow will be created on the next packet sampled for that flow.

Existing flows do not inherit the new active-timeout value if this parameter is changed while cflowd is active. The active-timeout value for a flow is set when the flow is first created in the active cache table and does not change dynamically.

The no form of this command resets the inactive timeout back to the default value.

Default 

active-timeout 30

Parameters 
minutes—
the value expressed in minutes before an active flow is exported
Values—
1 — 600

cache-size

Syntax 
cache-size num-entries
no cache-size
Context 
config>cflowd
Description 

This command specifies the maximum number of active flows to maintain in the flow cache table.

The no form of this command resets the number of active entries back to the default value.

Default 

cache-size 65536

Parameters 
num-entries—
the maximum number of entries maintained in the cflowd cache. It depends on the CPM version.
Values—

For the 7450 ESS and 7750 SR:

1000 to 128 k (SF/CPM1, SF/CPM2) 1000 to 250000 (cfm-xp, SF/CPM3 or higher)

For the 7950 XRS:

1000 to 1500000

Values—

For the 7450 ESS and 7750 SR:

65536 (64K)

For the 7950 XRS:

500000

collector

Syntax 
collector ip-address[:port] {version [5 | 8 | 9 | 10]}
no collector
Context 
config>cflowd
Description 

This command defines a flow data collector for cflowd data. The IP address of the flow collector must be specified. The UDP port number is an optional parameter. If it is not set, the default of 2055 is used for all collector versions. To connect to a IPFIX (version 10) collector using the IPFIX default port, specify port 4739 when configuring the collector. The version must be specified. A maximum of 5 collectors can be configured.

The no form of this command removes the flow collector definition from the config and stops the export of data to the collector. The collector needs to be shutdown to be deleted.

Default 

n/a

Parameters 
ip-address—
specifies the address of a remote Cflowd collector host to receive the exported Cflowd data
Values—

<ip-address[:port]>: ip-address - a.b.c.d[:port] (IPv4)

x:x:x:x:x:x:x:x (IPv6)

[x:x:x:x:x:x:x:x]:port (IPv6)

x - [0..FFFF]H

port—
Specifies the UDP port number on the remote Cflowd collector host to receive the exported Cflowd data.
Values—
1 to 65535
Values—
2055
version—
Specifies the version of the flow data collector.
Values—
Netflow v5, v8, v9, v10 (IPFIX) format
Values—
5

aggregation

Syntax 
[no] aggregation
Context 
config>cflowd>collector
Description 

This command configures the type of aggregation scheme to be exported.

Specifies the type of data to be aggregated and to the collector.

To configure aggregation, you must decide which type of aggregation scheme to configure: autonomous system, destination prefix, protocol port, raw, source destination, or source prefix.

This can only be configured if the collector version is configured as V8.

The no form of this command removes all aggregation types from the collector configuration.

Default 

no aggregation

as-matrix

Syntax 
[no] as-matrix
Context 
config>cflowd>collector>aggregation
Description 

This command specifies that the aggregation data should be based on autonomous system (AS) information. An AS matrix contains packet and byte counters for traffic from either source-destination autonomous systems or last-peer to next-peer autonomous systems.

The no form of this command removes this type of aggregation from the collector configuration.

Default 

no as-matrix

destination-prefix

Syntax 
[no] destination-prefix
Context 
config>cflowd>collector>aggregation
Description 

This command specifies that the aggregation data is based on destination prefix information.

The no form removes this type of aggregation from the collector configuration.

Default 

none

protocol-port

Syntax 
[no] protocol-port
Context 
config>cflowd>collector>aggregation
Description 

This command specifies that flows be aggregated based on the IP protocol, source port number, and destination port number.

The no form of this command removes this type of aggregation from the collector configuration.

Default 

n/a

raw

Syntax 
[no] raw
Context 
config>cflowd>collector>aggregation
Description 

This command configures raw (unaggregated) flow data to be sent in Version 5.

The no form of this command removes this type of aggregation from the collector configuration.

Default 

n/a

source-destination-prefix

Syntax 
[no] source-destination-prefix
Context 
config>cflowd>collector>aggregation
Description 

This command configures cflowd aggregation based on source and destination prefixes.

The no form of this command removes this type of aggregation from the collector configuration.

Default 

n/a

source-prefix

Syntax 
[no] source-prefix
Context 
config>cflowd>collector>aggregation
Description 

This command configures cflowd aggregation based on source prefix information.

The no form of this command removes this type of aggregation from the collector configuration.

Default 

n/a

autonomous-system-type

Syntax 
autonomous-system-type {origin | peer}
no autonomous-system-type
Context 
config>cflowd>collector
Description 

This command defines whether the autonomous system (AS) information included in the flow data is based on the originating AS or external peer AS of the routes.

This option is only allowed if the collector is configured as Version 5 or Version 8.

The no form of this command resets the AS type to the default value.

Default 

autonomous-system-type origin

Parameters 
origin—
specifies that the AS information included in the flow data is based on the originating AS
peer—
specifies that the AS information included in the flow data is based on the peer AS

description

Syntax 
description description-string
no description
Context 
config>cflowd>collector
Description 

This command creates a text description stored in the configuration file for a configuration context.

The no form of this command removes the description string from the context.

Default 

No description is associated with the configuration context.

Parameters 
description-string—
The description character string. Allowed values are any string up to 80 characters long composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes.

shutdown

Syntax 
[no] shutdown
Context 
config>cflowd
config>cflowd>collector
Description 

This command administratively disables an entity. When disabled, an entity does not change, reset, or remove any configuration settings or statistics.

The operational state of the entity is disabled as well as the operational state of any entities contained within. Many objects must be shut down before they may be deleted.

The no form of this command administratively enables an entity.

Unlike other commands and parameters where the default state is not indicated in the configuration file. The shutdown and no shutdown states are always indicated in system generated configuration files.

Default 

no shutdown

template-set

Syntax 
template-set {basic | mpls-ip | l2-ip | mpls-transport}
Context 
config>cflowd>collector
Description 

This command specifies the set of templates sent to the collector when using cflowd Version 9 or Version 10.

Default 

template-set basic

Parameters 
basic—
basic flow data is sent
mpls-ip—
extended flow data is sent that includes IP and MPLS flow information
l2-ip—
extended flow data is sent that includes Layer 2 (Ethernet) and IP flow information.This template is only applicable for v10(IPFIX) collectors.
mpls-transport—
Allows cflowd to collect flow statistics for MPLS traffic using only the outer transport label, EXP bit value and ingress interface as the flow identifier. This template enables the collection of flows statistics on a core router to develop LSP usage statistics.

export-mode

Syntax 
export-type [automatic | manual]
Context 
config>cflowd
Description 

This command can be used to control how exports are generated by the cflowd process. The default behavior is for flow data to be exported automatically based on the active and inactive time-out values. The alternative mode is manual in which case flow data is only exported when the command “tools perform cflowd manual-export” is issued. The only exception is if the cflowd cache overflows, in which case the normal automatic export process is used.

Default 

export-mode automatic

Parameters 
automatic—
Cflowd flow data is automatically generated.
manual—
Cflowd flow data is exported only when manual triggered.

inactive-timeout

Syntax 
inactive-timeout seconds
no inactive-timeout
Context 
config>cflowd
Description 

This command specifies the amount of time, in seconds, that must elapse without a packet matching a flow in order for the flow to be considered inactive.

The no form of this command resets the inactive timeout back to the default of 15 seconds.

Existing flows will not inherit the new inactive-timeout value if this parameter is changed while cflowd is active. The inactive-timeout value for a flow is set when the flow is first created in the active cache table and does not change dynamically.

Default 

inactive-timeout 15

Parameters 
seconds—
specifies the amount of time, in seconds, that must elapse without a packet matching a flow in order for the flow to be considered inactive
Values—
10 to 600

overflow

Syntax 
overflow percent
no overflow
Context 
config>cflowd
Description 

This command specifies the percentage of the flow cache entries removed when the maximum number of entries is exceeded. The entries removed are the entries that have not been updated for the longest amount of time.

The no form of this command resets the number of entries cleared from the flow cache on overflow to the default value.

Default 

overflow 1%

Parameters 
percent—
specifies the percentage of the flow cache entries removed when the maximum number of entries is exceeded
Values—
1 to 50 percent

rate

Syntax 
rate sample-rate
no rate
Context 
config>cflowd
Description 

This command specifies the rate (N) at which traffic is sampled and sent for flow analysis. A packet is sampled every N packets; for example, when sample-rate is configured as 1, then all packets are sent to the cache. When sample-rate is configured as 100, then every 100th packet is sent to the cache.

The no form of this command resets the sample rate to the default value.

Default 

rate 1000

Parameters 
sample-rate—
specifies the rate at which traffic is sampled
Values—
1 to 10000

template-retransmit

Syntax 
template-retransmit seconds
no template-retransmit
Context 
config>cflowd
Description 

This command specifies the interval for sending template definitions.

Default 

template-retransmit 600

Parameters 
seconds—
the value expressed in seconds before sending template definitions
Values—
10 to 600

use-vrtr-if-index

Syntax 
[no] use-vrtr-if-index
Context 
config>cflowd
Description 

This command is used to export flow data using interface indexes (ifIndex values), which can be used directly as the index into the IF-MIB tables for retrieving interface statistics. Specifically, if the this command is enabled, then the ingressInterface (ID=10) and egressInterface (ID= 14) fields in IP flow templates used to export the flow data to Cflowd version 9 and version 10 collectors will be populated with the IF-MIB ifIndex of that interface. In addition, for version 10 templates, two fields are available in the IP flow templates to present the Virtual Router ID associated with the ingress and egress interfaces.

The no form of this command removes the command from the active configuration and causes cflowd to return to the default behavior of populating the ingress and egress interface ID with the global IF index IDs.

Default 

no use-vrtr-if-index