Console deep linking - Amazon X-Ray
TracesFilter expressionsTime rangeRegionCombined
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 (PDF).

Console deep linking

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

Console pages

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

Trace timeline – xray/home#/traces/trace-id

Raw trace data – xray/home#/traces/trace-id/raw

Example – raw trace data
https://console.amazonaws.cn/xray/home#/traces/1-57f5498f-d91047849216d0f2ea3b6442/raw

Link to a filtered list of traces.

Filtered traces view – xray/home#/traces?filter=filter-expression

Example – filter expression
https://console.amazonaws.cn/xray/home#/traces?filter=service("api.amazon.com") { fault = true OR responsetime > 2.5 } AND annotation.foo = "bar"
Example – filter expression (URL encoded)
https://console.amazonaws.cn/xray/home#/traces?filter=service(%22api.amazon.com%22)%20%7B%20fault%20%3D%20true%20OR%20responsetime%20%3E%202.5%20%7D%20AND%20annotation.foo%20%3D%20%22bar%22

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 time – xray/home#/page?timeRange=range-in-minutes

Example – trace map for the last hour
https://console.amazonaws.cn/xray/home#/service-map?timeRange=PT1H

Start and end time – xray/home#/page?timeRange=start~end

Example – time range accurate to seconds
https://console.amazonaws.cn/xray/home#/traces?timeRange=2023-7-01T16:00:00~2023-7-01T22:00:00
Example – time range accurate to minutes
https://console.amazonaws.cn/xray/home#/traces?timeRange=2023-7-01T16:00~2023-7-01T22:00

Specify an Amazon Web Services Region to link to pages in that Region. If you don't specify a Region, the console redirects you to the last visited Region.

Region – xray/home?region=region#/page

Example – trace map in US West (Oregon) (us-west-2)
https://console.amazonaws.cn/xray/home?region=us-west-2#/service-map

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 – trace map for the last hour in US West (Oregon) (us-west-2)
https://console.amazonaws.cn/xray/home?region=us-west-2#/service-map?timeRange=PT1H
Example – recent traces with a duration filter
https://console.amazonaws.cn/xray/home#/traces?timeRange=PT15M&filter=duration%20%3E%3D%205%20AND%20duration%20%3C%3D%208
Output

  • Page – Traces

  • Time Range – Last 15 minutes

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