sFlow

sFlow is capable of transporting both telemetry data and flow information. Meridian can use both data types and extract and persist accordingly.

See Flow Support for details on flow support in Meridian.

sFlow UDP Parser

The sFlow UDP parser accepts packets received by a UDP listener and must forward them to a sFlow Adapter.

The sFlow UDP parser supports protocol detection.

Facts

Class Name

org.opennms.netmgt.telemetry.protocols.sflow.parser.SFlowUdpParser

Parameters

Table 1. Parameters for the Netflow v5 UDP Parser
Parameter Description Required Default value

dnsLookupsEnabled

Enable or disable DNS resolution for flows.

no

true

sFlow Adapter

The sFlow Adapter handles sFlow data received and parsed by the sFlow parser. Flows are decoded from the messages into the canonical flow format and published to the flow repository.

Facts

Class Name

org.opennms.netmgt.telemetry.protocols.sflow.adapter.SFlowAdapter

Parameters

This adapter does not currently have any configurable parameters.

sFlow Telemetry Adapter

The sFlow telemetry adapter handles sFlow telemetry data received and parsed by the sFlow UDP parser. The telemetry data is forwarded to a JSR-223 compatible script (i.e., Beanshell or Groovy) for further processing. Using the script extension, you can extract the desired metrics from the sFlow messages and persist the results as time series data.

Facts

Class Name

org.opennms.netmgt.telemetry.protocols.sflow.adapter.SFlowTelemetryAdapter

Parameters

Table 2. Adapter specific parameters
Parameter Description Required Default value

script

Full path to the script used to handle the sFlow messages.

required

(none)

Scripting

The script will be invoked for every sFlow (extended) counter sample that is received.

The following globals will be passed to the script:

Table 3. Globals passed to the script
Parameter Description Type

agent

The agent (node) against which the metrics will be associated

org.opennms.netmgt.collection.api.CollectionAgent

builder

Builder in which the resources and metrics should be added

org.opennms.netmgt.collection.support.builder.CollectionSetBuilder

msg

sFlow (extended) counter sample

dynamic Map

See sFlow Specification for the contained fields and their meaning.