hub / github.com/DataDog/saluki

github.com/DataDog/saluki @1.2.2

Chat with this repo

repository ↗ · DeepWiki ↗ · release 1.2.2 ↗ · + Follow

7,931 symbols 23,289 edges 609 files 2,463 documented · 31%

What it actually does AI analysis from the code graph — generated when you open this

loading…

README

saluki

Saluki is a toolkit for building telemetry data planes in Rust.

Structure

Everything under lib/ contains reusable/common code, and everything under bin/ contains dedicated crates for building application-specific binaries.

Binaries

bin/agent-data-plane: the primary data plane binary, which provides a production-grade DogStatsD pipeline and an experimental OTLP pipeline
bin/correctness: binaries used to run correctness tests against ADP and standalone DogStatsD

Libraries

The lib/ directory contains two groups of crates:

Reusable and general-purpose — Implementations of features/capabilities that are required for Saluki or Agent Data Plane but aren't specific to Saluki. Examples include ddsketch, generated code for Protocol Buffers definitions, and so on.

Saluki (saluki-*) — Foundational crates that make up Saluki itself, covering topology construction, component traits, I/O primitives, context resolution, configuration, and more.

Contributing

If you find an issue with this package and have a fix, or simply want to report it, please review our contributing guide.

Documentation

Procedural documentation — architecture, releasing, etc — can be found here.

Security

Please refer to our Security Policy if you believe you have found a security vulnerability.

Extension points exported contracts — how you extend this code

SynchronousTransform (Interface)

A synchronous transform. Synchronous transforms are conceptually similar to transforms, designed to manipulate events. [8 …

lib/saluki-core/src/components/transforms/mod.rs

EvalContextFamily (Interface)

A "family" of evaluation context types, parameterized by lifetime. This trait uses Generic Associated Types (GATs) to s [7 …

lib/ottl/src/mod.rs

APIHandler (Interface)

An API handler. API handlers define the initial state and routes for a portion of an API. [12 implementers]

lib/saluki-api/src/lib.rs

MemoryBounds (Interface)

Memory bounds for a component. Components will naturally allocate memory in many phases, from initialization to normal [55 …

lib/resource-accounting/src/lib.rs

WorkloadProvider (Interface)

Provides information about workloads running on the process host. [6 implementers]

lib/saluki-env/src/workload/mod.rs

EndpointEncoder (Interface)

Encodes input events for a specific intake endpoint. [7 implementers]

lib/saluki-components/src/common/datadog/request_builder.rs

OriginTagsResolver (Interface)

A resolver for mapping origins to their associated tags. [5 implementers]

lib/saluki-context/src/origin.rs

ReadIoBuffer (Interface)

An I/O buffer that can be read from. [5 implementers]

lib/saluki-io/src/buf/mod.rs

Core symbols most depended-on inside this repo

iter

called by 492

lib/stringtheory/src/interning/helpers.rs

clone

called by 423

lib/saluki-components/src/common/otlp/mod.rs

clone

called by 394

lib/ottl/src/parser/ast.rs

insert

called by 341

lib/saluki-components/src/transforms/aggregate/mod.rs

as_ref

called by 286

lib/saluki-context/src/tags/mod.rs

push

called by 285

lib/saluki-common/src/strings.rs

len

called by 183

lib/saluki-components/src/transforms/apm_stats/aggregation.rs

error_context

called by 164

lib/saluki-error/src/lib.rs

Shape

Method 3,557

Function 3,072

Class 999

Enum 215

Interface 88

Languages

Rust99%

Python1%

TypeScript1%

Modules by API surface

lib/saluki-components/src/sources/dogstatsd/mod.rs129 symbols

lib/ottl/src/tests.rs103 symbols

lib/saluki-components/src/encoders/datadog/metrics/mod.rs75 symbols

lib/saluki-core/src/topology/graph.rs74 symbols

lib/saluki-core/src/data_model/event/trace_stats/mod.rs74 symbols

lib/saluki-components/src/sources/otlp/metrics/translator.rs73 symbols

lib/saluki-context/src/tags/tagset/owned.rs71 symbols

lib/saluki-components/src/common/datadog/config.rs70 symbols

lib/stringtheory/src/lib.rs67 symbols

lib/saluki-core/src/topology/interconnect/dispatcher.rs65 symbols

lib/saluki-components/src/transforms/trace_sampler/mod.rs63 symbols

lib/saluki-components/src/common/datadog/io.rs63 symbols

Datastores touched

(mongodb)Database · 1 repos

For agents

$ claude mcp add saluki \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact