Expand description
AWS X-Ray (xray) restJson1 control plane + in-memory trace data plane for
fakecloud.
The full 38-operation AWS X-Ray Smithy model. X-Ray signs SigV4 with the
xray scope and speaks restJson1; every operation is a POST /<UriPath>
(e.g. POST /TraceSegments, POST /Traces, POST /ServiceGraph), so
requests are routed by their @http URI path.
This is real, persisted, account-partitioned state, not a set of stubs:
- Data plane.
PutTraceSegmentsingests X-Ray trace segment documents (JSON), parsing each document’strace_id/id/name/start_time/end_time/http/error/fault/throttleflags and its nestedsubsegments(includingnamespace: "remote"downstream calls). Segments are stored keyed by trace id.BatchGetTracesreassembles stored traces,GetTraceSummariesfilters them by time range (plus a documented filter-expression subset), andGetServiceGraph/GetTraceGraph/GetTimeSeriesServiceStatisticsderive a service graph (nodes + edges with Ok/Error/Fault statistics and response time) computed deterministically from the ingested segments. Seegraphandsegment. - Control plane. Sampling rules (with the built-in, undeletable
Defaultrule seeded per account), groups, the account encryption config, resource policies, the indexing rule, the trace-segment destination, and ARN-keyed resource tagging are straightforward CRUD, persisted via snapshot/restore.
Model-driven validation rejects contract violations with the error codes each
operation declares (InvalidRequestException universally,
ResourceNotFoundException on the ops that declare it, plus
RuleLimitExceededException / TooManyTagsException).
Re-exports§
pub use service::XrayService;pub use service::XRAY_ACTIONS;pub use state::XrayData;pub use state::XraySnapshot;pub use state::XRAY_SNAPSHOT_SCHEMA_VERSION;
Modules§
- graph
- Deterministic X-Ray service-graph derivation from stored trace segments.
- persistence
- Snapshot save/load for AWS X-Ray state.
- segment
- X-Ray trace segment document parsing.
- service
- AWS X-Ray (
xray) restJson1 dispatch + operation handlers. - state
- Account-partitioned, serializable state for AWS X-Ray (
xray).