This is a performance framework to introspect in-network applications written in P4 programming language running on Intel Tofino powered switches. The framework has been developed and tested for the Intel Tofino architecture version 2, but it is backwards compatible to Tofino 1.
Using the PIFINA cli tool a given P416 application can be enriched with performance counters like byte & packet counter in various places of the pipeline. Only interesting packets can be introspected using traffic selector rules, which can be matched on any parsed header fields. In addition, the values of selected user defined registers can be probed and visualized. In that way, low/high watermark metrics specific to the running application can be implemented by the user itself, which will be probed by PIFINA. Furthermore, metrics from the traffic manager are visualized as well.
One of the benefits of PIFINA is that it allows users to adjust the traffic selector rules and to add user-defined registers for probing at runtime without the need to recompile the whole P416 application.
PIFINA offers following features:
- Introspect only interesting packets using traffic selector rules. Define on which header fields to match on and install the rules over a web ui.
- Monitor how any value of a register change over time
- Monitor performance counters from the traffic manager?
- Monitor performance counters from end systems with NVIDIA Connect-X NICs
See for more information and screenshots on pifina.app
- Download compiled PIFINA binaries from Github
- Untar the archive
cd /tmp
tar -xzf pifina_Linux_x86_64.tar.gz
mv pifina /usr/local/bin
mv pifina-tofino-probe /usr/local/bin
- Install prequisites
- Install the latest Golang compiler
- Install the latest Protobuf compiler
- Install protobuf plugin for golang
go install google.golang.org/protobuf/cmd/protoc-gen-go@v1.28
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@v1.2- Install the latest Node.js LTS
- Compile using makefile
cd pifina-sdk/
make buildNow you can find two binaries in the build folder.
See for more information on pifina.app
- Instrumentize your P4 application with PIFINA
# Match on P4 header fields hdr.ipv4.protocol, hdr.ipv4.dstAddr & hdr.ipv4.srcAddr
# Write the generated P4 libraries in src/myP4app/include
user@myworkstation$ pifina generate -k hdr.ipv4.protocol:exact -k hdr.ipv4.dstAddr:ternary -k hdr.ipv4.srcAddr:ternary -o src/myP4app/include
# Use command help to see the options
user@myworkstation$ pifina generate -h- Run your P4 app enriched with PIFINA on your Tofino switch
- Start the PIFINA collector on a remote server
# Quick and dirty way
# Create self signed certificate
admin@collector$ mkdir assets
admin@collector$ openssl req -x509 -newkey ec -pkeyopt ec_paramgen_curve:prime256v1 \
-keyout assets/key.pem -out assets/cert.pem -sha256 -days 3650 -nodes \
-subj "/C=CH/O=Pifina/CN=PifinaServer"
admin@collector$ pifina serve
# Start collector with a signed TLS certificate
admin@collector$ pifina serve --key privatekey.pem --cert letsencrypt_cert.pem
# Use command help to see the options
admin@collector$ pifina serve -h- Start the tofino probe on the Tofino switch
# Start the tofino probe. The P4 app name must be given with the flag p4name
sde@tofino$ pifina-tofino-probe -p4name myP4app -server pifina-collector.local:8654
# Use command help to see the options like bfrt server address or pifina
sde@tofino$ pifina-tofino-probe -h- Optional: Start the NIC collector on your sender and receiver
- This component depends on NVIDIA NEO-Host SDK and it must be already installed!
# List all available Mellanox ConnectX NICs
admin@server1$ pifina nic list
# Collect metrics from mlx5_1 NIC and send metrics to PIFINA collector
admin@server1$ pifina nic collect -d mlx5_1 -s pifina-collector.local:8654
# Use command help to see the options
admin@server1$ pifina nic -hCheck the user manual on pifina.app
- Skiplist implementation from sean-public/fast-skiplist
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.