OpenResty XRay Agent 安裝和解除安裝

安裝

首次安裝

第一次登入控制檯的時候,你會看到如下的安裝引導介面。你可以選擇容器安裝方式或者是二進位制包安裝方式。

接下來,你只要根據安裝嚮導的步驟進行安裝即可順利完成安裝。

再次安裝

後續再安裝 OpenResty XRay Agent 的時候,你可以透過點選下圖上方的加號。

OpenResty XRay 控制檯會記住你上次安裝的方式,因此點選加號後你將得看到如下介面。

一般情況下,你還是會按照同樣的方式安裝 OpenResty XRay Agent,因此直接按照引導介面的步驟安裝即可。

如果你想要使用不同的安裝方式或者不同的作業系統,那麼你可以點選 Install on other operation systems 的按鈕。這樣將回到跟首次安裝一樣的介面。

在 Kubernetes 上安裝

如果你想要在 Kubernetes 叢集上安裝 OpenResty XRay Agent,你可以點選 Install on Kubernetes 按鈕。這樣將會跳轉到如下介面。

然後新增 secret 並複製 yaml 並將其應用到你的 Kubernetes 叢集,OpenResty XRay Agent 將會作為 DaemonSet 安裝到你的 Kubernetes 叢集中。

或者你可以使用 nodeSelector 來指定 OpenResty XRay Agent 安裝的節點:

spec:
  template:
    spec:
      nodeSelector:
        role: monitoring

bottlerocket 系統上關閉 kernel lockdown

預設情況下,bottlerocket 系統是啟用了 kernel lockdown 的。這會導致 OpenResty XRay Agent 無法正常載入核心模組。你可以透過以下命令來關閉 kernel lockdown:

透過 SSH 登入 admin 容器

  1. 使用 SSH 登入 admin 容器
  2. 執行 apiclient set kernel.lockdown=none 關閉 kernel.lockdown
  3. 重啟 AWS EC2 例項

透過控制檯登入 admin 容器

如果沒有開啟 SSH 的登入方式,那麼可以透過如下方式登入控制檯容器

  1. 登入 AWS EC2 控制檯

  2. 選擇 EC2 例項

  3. 選擇 EC2 例項右上角的連線按鈕

  4. 選擇 Session Manager 標籤頁

  5. 輸入 enter-admin-container

  6. 執行 apiclient set kernel.lockdown=none 關閉 kernel.lockdown

  7. 重啟 AWS EC2 例項

透過編輯 user data 關閉 kernel lockdown

  1. 登入 AWS EC2 控制檯

  2. 選擇 EC2 例項

  3. 選擇例項的 Actions 按鈕

  4. 選擇 Instance settings 標籤頁

  5. 選擇 Edit user data 按鈕

  6. User data 文字框中新增如下配置

    [settings.kernel]
    lockdown = "none"
    
  7. 啟動 AWS EC2 例項

解除安裝

如果想要解除安裝 OpenResty Xray Agent 軟體,點選頂部中間的的減號按鈕並按照提示執行即可。

OpenResty XRay 控制檯會根據當前 `OpenResty XRay Agent`` 的安裝方式給出對應的解除安裝命令。

比如,對於線上的二進位制包方式安裝的 OpenResty XRay Agent,您將得到如下提示。只要單擊 Uninstall 即可完成解除安裝。

比如,對於線上的容器方式安裝的 OpenResty XRay Agent,您將得到如下提示。 根據實際情況複製對應的解除安裝命令到目標機器上執行。

如果是已經離線的 OpenResty XRay Agent,您將得到如下的提示。您需要複製解除安裝命令到目標機器上執行。

如果機器的數量已經達到授權數量的限制,但是想在其它新的機器分析問題。你可以先解除安裝已經不使用的機器上的 OpenResty XRay Agent, 然後在新的機器上安裝 OpenResty XRay Agent