Developer Guide

Deep Linking

You can use routes and queries to deep link into specific traces, or filtered views of traces and the service map.

Console Pages

You can generate links for timeline, raw, and map views of individual traces.

Trace timelinexray/home#/traces/trace-id

Raw trace dataxray/home#/traces/trace-id/raw

Example Raw trace data

Link to a filtered list of traces.

Filtered traces viewxray/home#/traces?filter=filter-expression

Example Filter expression"") { fault = true OR responsetime > 2.5 } AND = "bar"

Example Filter expression (URL encoded)

For more information on filter expressions, see Using Filter Expressions.

Specify a length of time or start and end time in ISO8601 format. Time ranges are in UTC and can be up to 6 hours long.

Length of timexray/home#/page?timeRange=range-in-minutes

Example Service map for the last hour

Start and end timexray/home#/page?timeRange=start~end

Example Time range accurate to seconds

Example Time range accurate to minutes

Specify a region to link to pages in that region. If you don't specify a region, the console redirects you to the last visited region.


Example Service map in Oregon (us-west-2)

When you include a region with other query parameters, the region query goes before the hash, and the X-Ray-specific queries go after the page name.

Example Service map for the last hour in Oregon (us-west-2)

Example Recent traces with duration filter


  • Page – Traces

  • Time Range – Last 15 minutes

  • Filter – duration >= 5 AND duration <= 8