saimiris

Crates.iosaimiris
lib.rssaimiris
version0.1.1
created_at2025-03-24 22:07:15.616416+00
updated_at2025-04-23 17:07:08.673235+00
descriptionInternet Measurements Probing Pipeline
homepagehttps://nxthdr.dev
repositoryhttps://github.com/nxthdr/saimiris
max_upload_size
id1604467
size163,100
Matthieu Gouel (matthieugouel)

documentation

README

Project Logo

Saimiris

[!WARNING] Currently in early-stage development.

Architecture

The probing system is composed of two main components: the client and the agent. Those components send and receive messages from Kafka topics, respectively. The measurements results can be handled in any way, such as storing them in a ClickHouse database.

Check the integration tests for a local quick setup of the system.

Agent

The agent performs the measurements. It is always listening for results. It consumes probes to send from Kafka topic, performs the measurements, and then produces the results to another Kafka topic.

samiris agent --config=saimiris.yml

Client

The client is the agent that sends the measurements to the agent. It sends messages to a Kafka topic, which represents a set of probes to be sent consecutively. A measurement can be composed of multiple messages.

cat probes.txt | samiris client --config=saimiris.yml <comma-separated-agent-ids>

The probes to send are in the caracal format.

Commit count: 133

cargo fmt