JaegerVFS mounts an existing Jaeger query service as read-only JSON files:
each service becomes a folder with its operations and one file per trace. Set up the connection as in Jaeger setup.
Install
Configure
host is the query service’s base URL; it needs no credentials.
defaultTraceLimit, defaultFromTimestamp and defaultToTimestamp bound
each trace listing. The class ships in @struktoai/mirage-node only. In a
YAML config or buildVfs('jaeger', ...), the same fields are snake_case
(default_trace_limit).
Fields
The most traces one service’s
traces/ listing shows, newest first. An older trace is still readable by its id.Seconds a request may wait to connect, or between two reads of its answer, before it fails; a download that keeps flowing is never cut off.
Layout
services/: one folder per service Jaeger reports, including Jaeger’s ownjaegerservice when it traces itself.operations.json: the service’s operation records, as Jaeger returns them.traces/<trace-id>.json: the trace document Jaeger returns, withtraceID,spans,processesandwarnings.
Behavior
- Read only: the mount has no write operations.
- Trace listing:
traces/shows the newestdefaultTraceLimittraces (100) of the service betweendefaultFromTimestampanddefaultToTimestamp; unset bounds search from the beginning up to now. A trace older than the listing is still readable by its id, as long as one of its spans comes from that service. - Missing paths: a service Jaeger does not know, a trace id that is not 16 or 32 hex digits, and a trace without a span from the addressed service are reported as missing.
- Sizes: every listed file has an exact size, so
ls -l,duandstatwork without reading the files.
VFS.md
The VFS.md an agent reads with Jaeger mounted at/<path>.
- Rendered
- Raw
Virtual FilesystemSupported Unix Commands for VFSUnix commands work on each path as on a local filesystem, as far as the path supports them:
VFS Layout
/<path>Limitations of Unix Commands for VFSWhere a path differs from a local filesystem:
Run
man <cmd> or <cmd> --help for one command’s usage.