Console deep linking - Amazon X-Ray
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

Console 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 about 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 an Amazon 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 US West (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 US West (Oregon) (us-west-2)

Example – recent traces with a duration filter


  • Page – Traces

  • Time Range – Last 15 minutes

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