You can have one New Relic X-ray session at a time running for a key transaction. If you want to start a different one, you must stop the one currently in progress by selecting its status icon. Once you stop an x-ray session, you cannot restart it. However, you can delete it and create a new one at any time.
Access to this feature depends on your subscription level.
Start an x-ray session
To start an X-ray session:
- Go to rpm.newrelic.com/apm or rpm.newrelic.com/browser > Key transactions > (select a key transaction) > x-ray > Start x-ray session.
- From the Start an x-ray session window, type its name.
- Select the Requested trace count and Maximum duration, or use the defaults (50 traces, one hour maximum duration).
- Select Start X-ray session.
After you start the x-ray session, New Relic automatically refreshes the x-ray sessions list (newest to oldest) and shows your session's Status as Running. It also shows the current progress, number of traces, author (email link for the person who created the x-ray session), and when the session started.
Stop or delete an x-ray session
The X-ray session automatically stops after collecting the requested number of transaction traces or one hour, whichever comes first. You can also manually stop or delete the x-ray Session anytime.
If an x-ray session's Status is Running, you can stop it at any time. To delete an x-ray session, its current Status must be Finished or Stopped.
- Go to rpm.newrelic.com/apm or rpm.newrelic.com/browser > Key transactions > (select a key transaction) > x-ray.
- From the x-ray sessions list, select the status icon to stop or delete the x-ray session, and then select the confirmation prompt.
For more help
Additional documentation resources include:
- X-ray sessions (overview of New Relic's x-ray sessions feature and comparison to standard event thread profilers)
- View an x-ray session (menu options for existing x-ray sessions)
- X-ray session Overview page (view details for the selected x-ray session's transaction traces)
- X-ray session Thread Profile page (view details for the x-ray session's thread profiler results)