Struct AnalyticsDimension 

pub struct AnalyticsDimension {
    pub name: String,
    pub source: Option<DimensionSource>,
    pub header: Option<String>,
    pub claim: Option<String>,
    pub body_path: Option<String>,
}

One custom analytics dimension (DW-043, analytics.dimensions[]).

DW-093 extends the source beyond headers: a source of claim extracts from the verified JWT’s claims, and body_path extracts from the request body via a JSON pointer (only when the body is buffered). The original header-only shape (header without source) is preserved for backward compatibility.

Fields

name: String

The dimension name: lowercase [a-z0-9_], at most 32 bytes — it becomes the rollup table’s dim key and the query field.

source: Option<DimensionSource>

The dimension source (DW-093). Absent defaults to header (the original DW-043 behavior). When header, the header field is required; when claim, the claim field is required; when body_path, the body_path field is required.

header: Option<String>

The request header whose value is captured (case-insensitive, as HTTP header names are). Required when source is header (or absent). The FIRST value of a repeated header wins; non-UTF-8 and over-128-byte values are skipped.

claim: Option<String>

The JWT claim name whose value is captured (DW-093). Required when source is claim. The claim must be a string- or number-valued top-level claim in the verified token; other types and absent claims are skipped for that request.

body_path: Option<String>

An RFC 6901 JSON pointer into the request body (DW-093). Required when source is body_path. Only works when the body is buffered (retries, hedging, request transforms, or request validation); the zero-buffering default skips body-path dimensions silently. The body must be valid JSON; non-JSON bodies and unresolved pointers are skipped.

Implementations

impl AnalyticsDimension

pub fn effective_source(&self) -> DimensionSource

The effective source (defaults to DimensionSource::Header when source is absent — the backward-compatible DW-043 behavior).

Trait Implementations

impl Clone for AnalyticsDimension

fn clone(&self) -> AnalyticsDimension

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AnalyticsDimension

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AnalyticsDimension

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for AnalyticsDimension

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for AnalyticsDimension

fn eq(&self, other: &AnalyticsDimension) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for AnalyticsDimension

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AnalyticsDimension