Struct PipelineDiagnostics 

pub struct PipelineDiagnostics {

    pub schema_version: u32,
    pub batches: u64,
    pub element_count: u64,
    pub mesh_count: u64,
    pub triangle_count: u64,
    pub backstop_count: u64,
    pub total_csg_failures: u64,
    pub products_with_failures: u64,
    pub hosts_with_openings: u64,
    pub silent_no_ops: u64,
    pub rect_fast: RectFastSummary,
    pub point_cache_hits: u64,
    pub point_cache_misses: u64,
    pub faceted_brep_ms: u64,
    pub phase_ms: PipelinePhaseTimings,
}

Aggregate structured diagnostics for one model load. Counter names are aligned with the existing GeometryDiagnostics contract (total_csg_failures, hosts_with_openings, rect_fast, …) so a consumer reading both sees one vocabulary.

Fields

schema_version: u32

Wire-shape version (PIPELINE_DIAGNOSTICS_SCHEMA_VERSION).

batches: u64

Geometry passes folded in: one per processGeometryBatch* call on wasm, exactly 1 for the native single-pass pipeline.

element_count: u64

Element jobs submitted to the per-element producer.

mesh_count: u64

Meshes emitted across all batches.

triangle_count: u64

Triangles emitted across all batches.

backstop_count: u64

Triangles removed by the f32-collapse degenerate-triangle backstop (element::build_mesh_data). Non-zero means the backstop engaged.

total_csg_failures: u64

Total CSG boolean failures (same meaning as GeometryDiagnostics::total_csg_failures).

products_with_failures: u64

Distinct products with at least one CSG failure.

hosts_with_openings: u64

Hosts that had openings processed.

silent_no_ops: u64

Hosts where rect cutters ran clean but the mesh came out unchanged.

rect_fast: RectFastSummary

rect_fast fast-path engagement, summed across batches.

point_cache_hits: u64

CartesianPoints served from the point cache while meshing faceted breps, summed across batches. Non-zero proves cross-element point memoization fired (the per-worker cache hoist). hits / (hits + misses) is the rate.

point_cache_misses: u64

CartesianPoints parsed fresh (point-cache misses) across the faceted-brep pass, summed across batches.

faceted_brep_ms: u64

Wall time (ms) attributed to faceted-brep part meshing, summed across batches. Populated only in observability native builds; 0 on wasm.

phase_ms: PipelinePhaseTimings

Phase wall-times (native: full; wasm: geometry only).

Implementations

impl PipelineDiagnostics

pub fn record_batch( &mut self, element_count: u64, mesh_count: u64, triangle_count: u64, backstop_count: u64, point_cache_hits: u64, point_cache_misses: u64, faceted_brep_ms: u64, geometry_ms: u64, diag: &GeometryDiagnostics, )

Fold one geometry batch into the accumulator (the wasm processGeometryBatch* path calls this once per batch). geometry_ms is the batch’s wall time; diag is the batch’s drained GeometryDiagnostics. Summing per-batch aggregates is exact because each batch drains its own router (no double counting).

pub fn from_processing_stats( stats: &ProcessingStats, element_count: u64, ) -> Self

Map a finished native pass into this shape. The native pipeline is single-pass, so batches is 1 and every phase timer is available.

Available API for a native consumer that wants the unified diagnostics vocabulary; not wired into a live server/CLI pipeline today (see the module docs). The wasm getter uses Self::record_batch, not this.

pub fn is_empty(&self) -> bool

Whether anything has been recorded — the wasm getter returns undefined before the first batch so consumers can gate on presence.

Trait Implementations

impl Clone for PipelineDiagnostics

fn clone(&self) -> PipelineDiagnostics

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PipelineDiagnostics

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

Formats the value using the given formatter.

impl Default for PipelineDiagnostics

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for PipelineDiagnostics

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for PipelineDiagnostics

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

where __S: Serializer,

Serialize this value into the given Serde serializer.