IOAM Agent for C++

C++ implementation of ioam-agent-python for Cross-Layer Telemetry.

1. Dependencies:

• gRPC library for C++
• protobuf library for C++
• pkg-config
• g++

2. Generate Protocol Buffers files and compile:

wget https://raw.githubusercontent.com/Advanced-Observability/ioam-api/clt/ioam_api.proto
protoc -I . --cpp_out=. --grpc_out=. --plugin=protoc-gen-grpc=`which grpc_cpp_plugin` ioam_api.proto

g++ ioam-agent.cpp ioam_api.grpc.pb.cc ioam_api.pb.cc `pkg-config --cflags --libs protobuf grpc++` -o ioam-agent -Wall

(Alternative) Use the build script

./build

3. Run:

sudo ./ioam-agent -i <interface> [-o]

Output Mode

Use -o.

This mode will print IOAM traces in the console.

Report Mode

Default mode.

This mode will report IOAM traces to a collector via grpc. The collector must be defined as an environment variable:

IOAM_COLLECTOR=address:port