Estimated Reading time: 2 minutes | Last modified: 2024-10-29, 12:24:01 pm

Upload Packages for OpenResty XRay™

Upload Packages for OpenResty XRay

To enable OpenResty XRay to accurately analyze program runtime states, you need to upload the corresponding binary package files:

  • For systems with self-compiled Linux kernels, please upload kernel-related package files
  • For self-compiled software, if debug symbol packages are not installed on the target machine, you need to upload the corresponding debug symbol packages. If debug symbol packages are already installed on the target machine, the agent will collect them automatically

Note: Source code packages do not need to be uploaded.

Select Upload in the left navigation bar of the OpenResty XRay console to enter the upload page. Here, you can upload kernel-related packages and debug symbol packages for applications.

upload-1

First, select the operating system type and corresponding system architecture, and then upload relevant packages according to the page instructions.

upload-2

After the packages are uploaded, you can switch to the right tab to view the processing results.

upload-3

For RPM Package Systems (like Rocky Linux), you need to upload:

Required packages:

  • kernel (e.g., kernel-4.18.0-372.9.1.el8.x86_64): Base kernel package containing kernel image and basic modules
  • kernel-devel (e.g., kernel-devel-4.18.0-372.9.1.el8.x86_64): Kernel headers and files needed for compilation
  • kernel-debuginfo (e.g., kernel-debuginfo-4.18.0-372.9.1.el8.x86_64): Kernel debug information

Optional packages:

  • kernel-core (e.g., kernel-core-4.18.0-372.9.1.el8.x86_64): Core kernel components
  • kernel-debuginfo-common (e.g., kernel-debuginfo-common-4.18.0-372.el8.x86_64): Common debug information
  • kernel-modules-core (e.g., kernel-modules-core-4.18.0-372.9.1.el8.x86_64): Core kernel modules
  • kernel-modules (e.g., kernel-modules-4.18.0-372.9.1.el8.x86_64): Additional kernel modules
  • kernel-headers (e.g., kernel-headers-4.18.0-372.9.1.el8.x86_64): Kernel header files needed for compiling userspace programs

For DEB Package Systems (like Ubuntu), you need to upload:

Required packages:

  • linux-image (e.g., linux-image-5.8.0-63-generic): Kernel image package
  • linux-image--dbg (e.g., linux-image-5.8.0-63-generic-dbgsym): Kernel debug symbols

Optional packages:

  • linux-headers (e.g., linux-headers-5.8.0-63-generic): Kernel header files
  • linux-modules: Kernel module packages

Upload Application Debug Information Packages

For applications, please upload the following packages:

RPM format (using OpenResty as an example):

  • Application debug information package (e.g., openresty-debuginfo)

DEB format (using OpenResty as an example):

  • Application debug symbol package (e.g., openresty-dbgsym)