Struct SalukiAnnotation 

pub struct SalukiAnnotation {
    pub schema: &'static SchemaEntry,
    pub support_level: SupportLevel,
    pub additional_yaml_paths: &'static [&'static str],
    pub env_var_override: Option<&'static [&'static str]>,
    pub used_by: &'static [&'static str],
    pub value_type_override: Option<ValueType>,
    pub test_json: Option<&'static str>,
}

Saluki-specific annotation for a single configuration key.

Pairs a SchemaEntry (generated from the vendored schema) with the metadata that only saluki knows: which internal config structs consume the key, and any corrections to the schema’s env var list.

These are hand-written constants, one per key saluki cares about, and live in config_registry::datadog::* submodules. They are never overwritten by codegen.

Fields

schema: &'static SchemaEntry

The schema entry this annotation enriches.

support_level: SupportLevel

How well saluki supports this key.

Must not be SupportLevel::Ignored — that level is reserved for unannotated schema keys.

additional_yaml_paths: &'static [&'static str]

Additional YAML paths beyond the canonical one in the schema (aliases).

Most keys have no aliases; leave this as &[] unless the config system recognises the key under more than one dot-separated path.

env_var_override: Option<&'static [&'static str]>

Overrides the schema’s env_vars list entirely when Some.

Use when the schema marks a key no-env but env vars are actually supported, or when the schema’s list is incorrect or incomplete (e.g. the proxy sub-keys).

used_by: &'static [&'static str]

Config structs that incorporate this key, as structs constants.

Must be non-empty for SupportLevel::Full and SupportLevel::Partial. Must be empty for SupportLevel::Incompatible.

value_type_override: Option<ValueType>

Overrides the schema’s value_type when Some.

Use when the schema declares a key as Float but the consuming Rust field is i32 (or similarly mismatched), so that smoke tests inject a value the struct can actually parse.

test_json: Option<&'static str>

Overrides the smoke-test injected value entirely when Some.

Must be a valid JSON literal (e.g. Some("[{\"name\":\"test\"}]")). Use when the field requires a structured value that the generic ValueType-derived test values cannot satisfy (e.g. JSON-encoded arrays or objects).

Implementations

impl SalukiAnnotation

pub fn yaml_path(&self) -> &'static str

The canonical YAML path for this key (from the schema).

pub fn all_yaml_paths(&self) -> impl Iterator<Item = &'static str>

All YAML paths for this key: canonical first, then any aliases.

pub fn effective_env_vars(&self) -> &'static [&'static str]

Effective env vars: the override list if set, otherwise the schema’s list.

pub fn value_type(&self) -> ValueType

Shape of the value: override if set, otherwise from the schema.

Trait Implementations

impl Debug for SalukiAnnotation

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<&SalukiAnnotation> for ConfigKey

fn from(a: &SalukiAnnotation) -> Self

Converts to this type from the input type.