Saluki is an experimental toolkit for building telemetry data planes in Rust.
This repository contains experimental code that is UNSUPPORTED and may cease to receive further updates at ANY TIME. In the event that we cease further development, the repository will be put into a read-only archive state.
Everything under lib contains reusable/common code, and everything under bin contains dedicated crates for building
application-specific binaries.
bin/agent-data-plane: data plane used for testing Saluki, which emulates the standalone DogStatsD server in the Datadog Agent
lib/datadog-protos: Rust bindings generated from Protocol Buffers definitions for metrics/trace intake APIslib/ddsketch-agent: Rust implementation of the DDSketch algorithm matched to the implementation used in the Datadog Agentlib/memory-accounting: foundational traits and helpers for declaring memory bounds on components, and partitioning memory grants based on those components
All remaining crates are part of Saluki itself, and all have a name with the prefix saluki-:
lib/saluki-app: generic helpers for application bring up (initialization of logging, metrics, etc)lib/saluki-components: feature-complete implementations of various common components (DogStatsD source, Datadog Metrics destination, and so on)lib/saluki-config: lightweight helpers for both typed and untyped configuration file loadinglib/saluki-core: core primitives for building data planes, such as the topology builder, foundational traits for components, buffers, and morelib/saluki-env: helpers for interacting with the process's environment, such as querying time, hostname, host environment (e.g. cloud provider), and so onlib/saluki-event: the core event model used by Salukilib/saluki-io: core I/O primitives for networking (TCP/UDP/UDS), serialization (codecs and framers), compression, I/O-specific buffers, as well as some common codec implementations (e.g. DogStatsD)
If you find an issue with this package and have a fix, or simply want to report it, please review our contributing guide.
Please refer to our Security Policy if you believe you have found a security vulnerability.