openconfig-sampling

openconfig-version: 0.1.0

Description

This module defines top-level configuration and operational state data related to traffic sampling.

For modularity purposes, the top-level sampling container provides a natural attachment point for implementations such as sFlow, IPFix, NETFLOW

Imports

openconfig-extensions

Data elements

/
sampling

description:
Top-level container for sampling-related configuration and operational state data

nodetype: container (rw)

/sampling/
sflow

description:
Top-level container for sFlow data.

nodetype: container (rw)

/sampling/sflow/
config

description:
Configuration data for global sFlow.

nodetype: container (rw)

/sampling/sflow/config/
enabled

description:
Enables or disables sFlow sampling for the device.

nodetype: leaf (rw)

type: boolean

default: false

/sampling/sflow/config/
agent-id-ipv4

description:
Sets the agent identifier for IPv4 PDUs.

nodetype: leaf (rw)

type: oc-inet:ipv4-address

/sampling/sflow/config/
agent-id-ipv6

description:
Sets the agent identifier for IPv6 PDUs.

nodetype: leaf (rw)

type: oc-inet:ipv6-address

/sampling/sflow/config/
dscp

description:
DSCP marking of packets generated by the sFlow subsystem on the network device.

nodetype: leaf (rw)

type: oc-inet:dscp

/sampling/sflow/config/
sample-size

description:
Sets the maximum number of bytes to be copied from a sampled packet.

nodetype: leaf (rw)

type: uint16

default: 128

units: bytes

/sampling/sflow/config/
polling-interval

description:
Sets the traffic sampling polling interval.

nodetype: leaf (rw)

type: uint16

units: seconds

/sampling/sflow/config/
ingress-sampling-rate

description:
Sets the ingress packet sampling rate. The rate is expressed as an integer N, where the intended sampling rate is 1/N packets. An implementation may implement the sampling rate as a statistical average, rather than a strict periodic sampling. The allowable sampling rate range is generally a property of the system, e.g., determined by the capability of the hardware.

nodetype: leaf (rw)

type: uint32

/sampling/sflow/config/
egress-sampling-rate

description:
Sets the egress packet sampling rate. The rate is expressed as an integer N, where the intended sampling rate is 1/N packets. An implementation may implement the sampling rate as a statistical average, rather than a strict periodic sampling. The allowable sampling rate range is generally a property of the system, e.g., determined by the capability of the hardware.

nodetype: leaf (rw)

type: uint32

/sampling/sflow/
state

description:
Operational state data for global sFlow.

nodetype: container (ro)

/sampling/sflow/state/
enabled

description:
Enables or disables sFlow sampling for the device.

nodetype: leaf (ro)

type: boolean

default: false

/sampling/sflow/state/
agent-id-ipv4

description:
Sets the agent identifier for IPv4 PDUs.

nodetype: leaf (ro)

type: oc-inet:ipv4-address

/sampling/sflow/state/
agent-id-ipv6

description:
Sets the agent identifier for IPv6 PDUs.

nodetype: leaf (ro)

type: oc-inet:ipv6-address

/sampling/sflow/state/
dscp

description:
DSCP marking of packets generated by the sFlow subsystem on the network device.

nodetype: leaf (ro)

type: oc-inet:dscp

/sampling/sflow/state/
sample-size

description:
Sets the maximum number of bytes to be copied from a sampled packet.

nodetype: leaf (ro)

type: uint16

default: 128

units: bytes

/sampling/sflow/state/
polling-interval

description:
Sets the traffic sampling polling interval.

nodetype: leaf (ro)

type: uint16

units: seconds

/sampling/sflow/state/
ingress-sampling-rate

description:
Sets the ingress packet sampling rate. The rate is expressed as an integer N, where the intended sampling rate is 1/N packets. An implementation may implement the sampling rate as a statistical average, rather than a strict periodic sampling. The allowable sampling rate range is generally a property of the system, e.g., determined by the capability of the hardware.

nodetype: leaf (ro)

type: uint32

/sampling/sflow/state/
egress-sampling-rate

description:
Sets the egress packet sampling rate. The rate is expressed as an integer N, where the intended sampling rate is 1/N packets. An implementation may implement the sampling rate as a statistical average, rather than a strict periodic sampling. The allowable sampling rate range is generally a property of the system, e.g., determined by the capability of the hardware.

nodetype: leaf (ro)

type: uint32

/sampling/sflow/
collectors

description:
Enclosing container for list of sFlow collectors.

nodetype: container (rw)

/sampling/sflow/collectors/
collector

description:
List of sFlow collectors to send sampling data. Packet samples are sent to all collectors specified.

nodetype: list (rw)

list keys: [address] [port]

/sampling/sflow/collectors/collector/
address

description:
Reference to address list key.

nodetype: leaf (list key) (rw)

type: leafref

  • path reference: ../config/address

/sampling/sflow/collectors/collector/
port

description:
Reference to port list key.

nodetype: leaf (list key) (rw)

type: leafref

  • path reference: ../config/port

/sampling/sflow/collectors/collector/
config

description:
Configuration data for sFlow collectors.

nodetype: container (rw)

/sampling/sflow/collectors/collector/config/
address

description:
IPv4/IPv6 address of the sFlow collector.

nodetype: leaf (rw)

type: oc-inet:ip-address

/sampling/sflow/collectors/collector/config/
port

description:
UDP port number for the sFlow collector.

nodetype: leaf (rw)

type: oc-inet:port-number

default: 6343

/sampling/sflow/collectors/collector/config/
source-address

description:
Sets the source IPv4/IPv6 address for sFlow datagrams sent to sFlow collectors.

nodetype: leaf (rw)

type: oc-inet:ip-address

/sampling/sflow/collectors/collector/config/
network-instance

description:
Reference to the network instance used to reach the sFlow collector. If uspecified, the collector destination is reachable in the default network instance.

nodetype: leaf (rw)

type: oc-netinst:network-instance-ref

/sampling/sflow/collectors/collector/
state

description:
Operational state data for sFlow collectors.

nodetype: container (ro)

/sampling/sflow/collectors/collector/state/
address

description:
IPv4/IPv6 address of the sFlow collector.

nodetype: leaf (ro)

type: oc-inet:ip-address

/sampling/sflow/collectors/collector/state/
port

description:
UDP port number for the sFlow collector.

nodetype: leaf (ro)

type: oc-inet:port-number

default: 6343

/sampling/sflow/collectors/collector/state/
source-address

description:
Sets the source IPv4/IPv6 address for sFlow datagrams sent to sFlow collectors.

nodetype: leaf (ro)

type: oc-inet:ip-address

/sampling/sflow/collectors/collector/state/
network-instance

description:
Reference to the network instance used to reach the sFlow collector. If uspecified, the collector destination is reachable in the default network instance.

nodetype: leaf (ro)

type: oc-netinst:network-instance-ref

/sampling/sflow/collectors/collector/state/
packets-sent

description:
The total number of packets sampled and sent to the collector.

nodetype: leaf (ro)

type: oc-yang:counter64

/sampling/sflow/
interfaces

description:
Enclosing container for list of sFlow interfaces.

nodetype: container (rw)

/sampling/sflow/interfaces/
interface

description:
List of interfaces with sFlow data.

nodetype: list (rw)

list keys: [name]

/sampling/sflow/interfaces/interface/
name

description:
Reference to list key.

nodetype: leaf (list key) (rw)

type: leafref

  • path reference: ../config/name

/sampling/sflow/interfaces/interface/
config

description:
Configuration data for sFlow data on interfaces.

nodetype: container (rw)

/sampling/sflow/interfaces/interface/config/
name

description:
Reference to the interface for sFlow configuration and state.

nodetype: leaf (rw)

type: oc-if:base-interface-ref

/sampling/sflow/interfaces/interface/config/
enabled

description:
Enables or disables sFlow on the interface. If sFlow is globally disabled, this leaf is ignored. If sFlow is globally enabled, this leaf may be used to disable it for a specific interface.

nodetype: leaf (rw)

type: boolean

/sampling/sflow/interfaces/interface/config/
polling-interval

description:
Sets the traffic sampling polling interval.

nodetype: leaf (rw)

type: uint16

units: seconds

/sampling/sflow/interfaces/interface/config/
ingress-sampling-rate

description:
Sets the ingress packet sampling rate. The rate is expressed as an integer N, where the intended sampling rate is 1/N packets. An implementation may implement the sampling rate as a statistical average, rather than a strict periodic sampling. The allowable sampling rate range is generally a property of the system, e.g., determined by the capability of the hardware.

nodetype: leaf (rw)

type: uint32

/sampling/sflow/interfaces/interface/config/
egress-sampling-rate

description:
Sets the egress packet sampling rate. The rate is expressed as an integer N, where the intended sampling rate is 1/N packets. An implementation may implement the sampling rate as a statistical average, rather than a strict periodic sampling. The allowable sampling rate range is generally a property of the system, e.g., determined by the capability of the hardware.

nodetype: leaf (rw)

type: uint32

/sampling/sflow/interfaces/interface/
state

description:
Operational state data for sFlow data on interfaces.

nodetype: container (ro)

/sampling/sflow/interfaces/interface/state/
name

description:
Reference to the interface for sFlow configuration and state.

nodetype: leaf (ro)

type: oc-if:base-interface-ref

/sampling/sflow/interfaces/interface/state/
enabled

description:
Enables or disables sFlow on the interface. If sFlow is globally disabled, this leaf is ignored. If sFlow is globally enabled, this leaf may be used to disable it for a specific interface.

nodetype: leaf (ro)

type: boolean

/sampling/sflow/interfaces/interface/state/
polling-interval

description:
Sets the traffic sampling polling interval.

nodetype: leaf (ro)

type: uint16

units: seconds

/sampling/sflow/interfaces/interface/state/
ingress-sampling-rate

description:
Sets the ingress packet sampling rate. The rate is expressed as an integer N, where the intended sampling rate is 1/N packets. An implementation may implement the sampling rate as a statistical average, rather than a strict periodic sampling. The allowable sampling rate range is generally a property of the system, e.g., determined by the capability of the hardware.

nodetype: leaf (ro)

type: uint32

/sampling/sflow/interfaces/interface/state/
egress-sampling-rate

description:
Sets the egress packet sampling rate. The rate is expressed as an integer N, where the intended sampling rate is 1/N packets. An implementation may implement the sampling rate as a statistical average, rather than a strict periodic sampling. The allowable sampling rate range is generally a property of the system, e.g., determined by the capability of the hardware.

nodetype: leaf (ro)

type: uint32

/sampling/sflow/interfaces/interface/state/
packets-sampled

description:
Total number of packets sampled from the interface.

nodetype: leaf (ro)

type: oc-yang:counter64

openconfig-sampling-sflow

openconfig-version: 1.0.0

Description

This module defines configuration and operational state data related to data plane traffic sampling based on sFlow.

RFC 3176 - InMon Corporation's sFlow: A Method for Monitoring Traffic in Switched and Routed Networks

Imports

openconfig-extensions
openconfig-inet-types
openconfig-interfaces
openconfig-yang-types
openconfig-network-instance
openconfig-sampling

Data elements