Skip to content

X-Ray

X-ray is the feature which helps CHAI™ to better understand the behavior of a process by attaching a probe. Linux processes must perform X-ray before moving forward to transform.

You can perform X-ray in three steps:

1. Start X-Ray (Attach)

  • You can attach the X-ray probe to a process
  • It is also possible to attach multiple processes in one go. There is a limit of 5 processes per host which can be attached simultaneously
  • X-ray probe will restart the process and the new PID will be updated on the UI

2. Functional Testing

  • While X-ray probes are attached, we recommend testing the application which is being attached
  • This way, in the background, the X-ray probe captures the interaction of the application with the underlying operating system
  • This in turn helps to generate the container image
  • It is recommended to perform a round of smoke tests
  • Not in all scenarios, but if the tests are not performed after the X-ray probe is attached, the probe may not be able to detect the interaction of the process with the underlying operating system
  • Once the functionality testing is complete, you can stop the X-ray

Tip:
Please clear the cache of the browser before starting the functional tests. It is very much possible that the browser caches the earlier CSS and HTML files and does not request them from the application code during application testing.

3. Stop X-Ray (Detach)

  • You can detach the X-ray probe after feature testing the application
  • It is also possible to detach multiple processes in one go. There is a limit of 5 processes per host which can be detached simultaneously
  • X-ray probe detach will stop the X-ray probe and the process which is being probed
  • It will resume the process once the probe is stopped
  • In case of init system and systemd, the process gets restarted and the new PID will be updated in the UI
  • In case of standalone process, PID will not change. It will be the same as the PID after attach and will be updated in the UI
  • After successful detach, the analysis phase gets automatically started
  • After successful analysis, process network info gets populated in the More Info tab
  • Once X-ray stop is complete, you can move to transform the hosts

X-Ray Process in Detail

Click here to learn about X-ray steps.