FindMyFiles

FindMyFiles.Engine

QueryTraceData Class

Stage breakdown of one query (mirrors fmf-core metrics.rs).

public sealed class QueryTraceData

Inheritance System.Object → QueryTraceData

Properties

QueryTraceData.Cache Property

Per-volume query-cache outcome: "miss", "refine" (all volumes narrowed the previous result) or "partial" (mixed).

public string Cache { get; set; }

Property Value

System.String

QueryTraceData.CompileUs Property

µs spent compiling the AST into the matcher.

public ulong CompileUs { get; set; }

Property Value

System.UInt64

QueryTraceData.Driver Property

Which execution strategy generated the candidates (shown in the perf panel): e.g. "full-scan", "pool-scan", "suffix", "perm-walk".

public string Driver { get; set; }

Property Value

System.String

QueryTraceData.EntriesScanned Property

Entries examined by the scan (the denominator of the match rate; far larger than Hits for a full scan).

public ulong EntriesScanned { get; set; }

Property Value

System.UInt64

QueryTraceData.ExcludedSkipped Property

Entries skipped by exclusion rules (hidden/system filtering, excluded paths) before matching.

public ulong ExcludedSkipped { get; set; }

Property Value

System.UInt64

QueryTraceData.Hits Property

Rows that matched — the resulting Count.

public ulong Hits { get; set; }

Property Value

System.UInt64

QueryTraceData.MaterializeUs Property

µs spent materializing matched rows into the result.

public ulong MaterializeUs { get; set; }

Property Value

System.UInt64

QueryTraceData.MemoUs Property

µs spent on the dir-path memo (path queries only; 0 when warm or not a path query).

public ulong MemoUs { get; set; }

Property Value

System.UInt64

QueryTraceData.MergeUs Property

µs spent on the multi-volume k-way merge (0 for one volume).

public ulong MergeUs { get; set; }

Property Value

System.UInt64

QueryTraceData.ParseUs Property

µs spent parsing the query text into its AST.

public ulong ParseUs { get; set; }

Property Value

System.UInt64

QueryTraceData.Query Property

The query text exactly as the engine parsed it.

public string Query { get; set; }

Property Value

System.String

QueryTraceData.ScanUs Property

µs spent scanning candidates across all volumes.

public ulong ScanUs { get; set; }

Property Value

System.UInt64

QueryTraceData.TotalUs Property

End-to-end µs for the whole query; the value fed into the p50/p99 histogram.

public ulong TotalUs { get; set; }

Property Value

System.UInt64

QueryTraceData.Unchanged Property

Engine-verified: same query as last time with identical id lists on every volume — the screen has nothing to change.

public bool Unchanged { get; set; }

Property Value

System.Boolean

QueryTraceData.Volumes Property

How many volume indexes participated in this query.

public uint Volumes { get; set; }

Property Value

System.UInt32