fabric-perfsonar

Instructions

When invoked, generate code to set up perfSONAR network monitoring on FABRIC nodes. perfSONAR measures network performance metrics including throughput, latency, RTT, MTU, and traceroute between endpoints.

Deployment options:

1. Docker Testpoint — Lightweight container-based deployment
2. Native Install with perfsonar-extensions — Full stack with pSConfig, Grafana, and archive (recommended)
3. Ad-Hoc Tests — Quick one-off measurements with pScheduler

Guide the user on which deployment model to use and what tests to configure.

API Reference

perfSONAR Test Types

Test Type	Tool	Measures
throughput	iperf3	Bandwidth between endpoints
latency / latencybg	owamp	One-way delay
rtt	ping	Round-trip time
trace	traceroute/tracepath	Network path
disk-to-disk	nuttcp	Disk-to-disk transfer rate

pSConfig Mesh Configuration

perfSONAR tests are coordinated via pSConfig (perfSONAR Configuration) mesh files that define which nodes test to which others and what tests to run. The psconfig_builder.py tool from perfsonar-extensions generates these configurations.

Patterns

Full Stack perfSONAR with perfsonar-extensions (Recommended)

from fabrictestbed_extensions.fablib.fablib import FablibManager

fablib = FablibManager()

TOTAL_NODES = 2
slice_name = "perfsonar-monitoring"

sites = fablib.get_random_sites(TOTAL_NODES)

slice = fablib.new_slice(name=slice_name)

for i, s in enumerate(sites):
    prefix = "central" if i == 0 else "remote"

    net = slice.add_l3network(name=f"{s}-l3", type="IPv4")

    node = slice.add_node(
        name=f"{prefix}-{s}",
        site=s,
        image="default_ubuntu_24",
        cores=16,
        ram=32,
        disk=100,
    )

    iface = node.add_component(model="NIC_Basic", name="nic1").get_interfaces()[0]
    iface.set_mode('auto')
    net.add_interface(iface)
    node.add_route(subnet=fablib.FABNETV4_SUBNET, next_hop=net.get_gateway())

slice.submit()