slug: amazon-xray provider: Amazon X-Ray generated_by: planning/capability-mapping/scripts/classify_capabilities.py model: claude-opus-5 frame: - Software & Technology min_confidence: 0.7 capability_model: source: https://github.com/vincentmakes/turbo-ea-capabilities license: CC-BY-4.0 attribution: Turbo EA Capabilities by Vincent Verdet — Turbo EA, https://github.com/vincentmakes/turbo-ea-capabilities, CC BY 4.0 notice: NOTICE edge_count: 18 edges: - tag: ServiceGraph spec_file: amazon-xray-service-graph-api-openapi.yml reanchored_from: amazon-xray-servicegraph-api-openapi.yml capability_id: BC-4220.20 capability_id_l1: BC-4220 capability_name: Observability Management confidence: 0.85 evidence: GetServiceGraph ... schemas ServiceStatistics, FaultStatistics, ErrorStatistics, Edge, Histogram reason: Returns the traced service topology with fault/error/latency statistics — classic logs/metrics/traces observability of the running service. - tag: Traces spec_file: amazon-xray-traces-api-openapi.yml capability_id: BC-4220.20 capability_id_l1: BC-4220 capability_name: Observability Management confidence: 0.85 evidence: POST /Traces BatchGetTraces; schemas TraceList, Segment, SegmentDocument reason: Retrieval of full traces and their segments — core distributed-tracing observability surface. - tag: CreateSamplingRule spec_file: amazon-xray-createsamplingrule-api-openapi.yml capability_id: BC-4220.20 capability_id_l1: BC-4220 capability_name: Observability Management confidence: 0.8 evidence: POST /CreateSamplingRule — Amazon X-Ray Create Sampling Rule; schemas SamplingRule, FixedRate, ReservoirSize reason: Sampling rules control how much trace telemetry is captured — distributed tracing/observability configuration. - tag: Service Graph spec_file: amazon-xray-service-graph-api-openapi.yml capability_id: BC-4220.20 capability_id_l1: BC-4220 capability_name: Observability Management confidence: 0.8 evidence: POST /ServiceGraph GetServiceGraph Amazon X-Ray Get the service graph reason: Retrieves the service map of a running distributed application derived from traces — production observability. - tag: TimeSeriesServiceStatistics spec_file: amazon-xray-timeseriesservicestatistics-api-openapi.yml capability_id: BC-4220.20 capability_id_l1: BC-4220 capability_name: Observability Management confidence: 0.8 evidence: POST /TimeSeriesServiceStatistics GetTimeSeriesServiceStatistics; schemas ServiceStatistics, FaultStatistics, ErrorStatistics, Histogram reason: Returns time-series fault/error/latency statistics from distributed traces — production service monitoring data, i.e. observability of the running service, not any business-domain statistic. - tag: TraceGraph spec_file: amazon-xray-tracegraph-api-openapi.yml capability_id: BC-4220.20 capability_id_l1: BC-4220 capability_name: Observability Management confidence: 0.8 evidence: GetTraceGraph ... 'retrieving service maps and other data created by processing those traces' reason: Service-map/trace-graph retrieval is distributed-tracing observability of production services. - tag: TraceSegments spec_file: amazon-xray-tracesegments-api-openapi.yml capability_id: BC-4220.20 capability_id_l1: BC-4220 capability_name: Observability Management confidence: 0.8 evidence: POST /TraceSegments PutTraceSegments; schema TraceSegmentDocument reason: Ingestion of trace segment documents from instrumented applications — trace telemetry collection under observability management. - tag: TraceSummaries spec_file: amazon-xray-tracesummaries-api-openapi.yml capability_id: BC-4220.20 capability_id_l1: BC-4220 capability_name: Observability Management confidence: 0.8 evidence: GetTraceSummaries; schemas FaultRootCauseEntity, ResponseTimeRootCause, TraceSummary reason: Querying trace summaries and root-cause entities for latency/fault analysis is production observability, not a business capability. - tag: CreateGroup spec_file: amazon-xray-creategroup-api-openapi.yml capability_id: BC-4220.20 capability_id_l1: BC-4220 capability_name: Observability Management confidence: 0.75 evidence: POST /CreateGroup — Amazon X-Ray Create Group; schemas InsightsConfiguration, Group; "retrieving service maps and other data created by processing those traces" reason: X-Ray groups are filter-expression groupings of traces used for monitoring/insights — observability configuration of a running service, not a business grouping. - tag: DeleteSamplingRule spec_file: amazon-xray-deletesamplingrule-api-openapi.yml capability_id: BC-4220.20 capability_id_l1: BC-4220 capability_name: Observability Management confidence: 0.75 evidence: POST /DeleteSamplingRule; schemas SamplingRule, SamplingRuleRecord reason: Manages trace sampling configuration — observability management for the running service. - tag: GetSamplingRules spec_file: amazon-xray-getsamplingrules-api-openapi.yml capability_id: BC-4220.20 capability_id_l1: BC-4220 capability_name: Observability Management confidence: 0.75 evidence: POST /GetSamplingRules; schemas SamplingRuleRecordList, FixedRate, ReservoirSize reason: Reads trace sampling configuration — observability management. - tag: Insight spec_file: amazon-xray-insight-api-openapi.yml capability_id: BC-4220.20 capability_id_l1: BC-4220 capability_name: Observability Management confidence: 0.75 evidence: POST /Insight GetInsight; schemas Insight, AnomalousService, RequestImpactStatistics reason: Anomaly insights derived from traces make the running service understandable in production — observability. Could touch incident detection but observability is the safer fit. - tag: InsightImpactGraph spec_file: amazon-xray-insightimpactgraph-api-openapi.yml capability_id: BC-4220.20 capability_id_l1: BC-4220 capability_name: Observability Management confidence: 0.75 evidence: POST /InsightImpactGraph GetInsightImpactGraph; schemas InsightImpactGraphService, InsightImpactGraphEdge reason: Service-map/impact graph derived from traces — distributed tracing observability. - tag: InsightSummaries spec_file: amazon-xray-insightsummaries-api-openapi.yml capability_id: BC-4220.20 capability_id_l1: BC-4220 capability_name: Observability Management confidence: 0.75 evidence: POST /InsightSummaries GetInsightSummaries ... schemas AnomalousService, InsightSummary, RequestImpactStatistics reason: X-Ray insights summarise anomalies/faults detected from distributed traces of a running service — production monitoring/observability of the service, not any business-domain 'insight'. - tag: TelemetryRecords spec_file: amazon-xray-telemetryrecords-api-openapi.yml capability_id: BC-4220.20 capability_id_l1: BC-4220 capability_name: Observability Management confidence: 0.75 evidence: PutTelemetryRecords ... schemas TelemetryRecord, BackendConnectionErrors reason: Agents upload telemetry records about trace collection health to the tracing backend — service observability instrumentation, not product usage telemetry. - tag: GetGroup spec_file: amazon-xray-get-group-api-openapi.yml reanchored_from: amazon-xray-getgroup-api-openapi.yml capability_id: BC-4220.20 capability_id_l1: BC-4220 capability_name: Observability Management confidence: 0.7 evidence: POST /GetGroup; schemas InsightsConfiguration, Group reason: Retrieval of trace-group monitoring configuration within the tracing service. - tag: Groups spec_file: amazon-xray-groups-api-openapi.yml capability_id: BC-4220.20 capability_id_l1: BC-4220 capability_name: Observability Management confidence: 0.7 evidence: POST /Groups GetGroups; schemas GroupSummaryList, InsightsConfiguration reason: Lists trace-filter groups with insights configuration; observability, not business grouping. - tag: InsightEvents spec_file: amazon-xray-insightevents-api-openapi.yml capability_id: BC-4220.20 capability_id_l1: BC-4220 capability_name: Observability Management confidence: 0.7 evidence: POST /InsightEvents GetInsightEvents; schemas InsightEvent, AnomalousServiceList, RequestImpactStatistics reason: Timeline of anomaly events for a service issue — production observability data.