在 Mac OS 上安裝主機代理程式

必要條件

代理程式需要有 Java Development Kit (JDK)。 您可以查看支援的 JDK 清單，如下所示。 有兩個選項:

1. 最簡單的方法是將 JDK 放置或鏈結至 <instana-agent-install-dir>/jvm (使 <instana-agent-install-dir>/jvm/bin/java 存在)。

2. 可自訂的方法是匯出稱為 JAVA_HOME 的環境變數，以指向該 JDK (此環境變數也可以透過 instana-agent-install-dir>/bin/setenv來設定)。

目前支援下列 JVM 來執行代理程式:

• IBM OpenJ9 JDK 11 (偏好在 x64上)
• Azul Zulu JDK 8 (偏好在 Apple silicon上)
• OpenJDK JDK 8
• AdoptOpenJDK
• Oracle Hotspot JDK 8
• Amazon Corretto JDK 8
• IBM J9 8

對於系統上的任何使用者而言， JVM 都是可執行的，這是很重要的。 建議您使用您選擇之 Java 發行套件的最新可用修補程式版本。 代理程式需要 JDK 支援 TLSv1.3 (適用於所有現行 JDK 8 和 JDK 11 建置)。 請注意，視您的 OS 發行套件而定，由於匯出控制， OS 配送器所提供的套件可能不包含高度加密支援。 如果您使用這類套件，可能會遇到 "java.lang.RuntimeException: Could not generate DH key pair." 之類的錯誤。

下載代理程式

1. 登入 Instana ，按一下 其他 > 代理程式 > Instana 代理程式安裝 -> Mac OS。

2. 若為 Mac OS (64bit -Intel 和 Apple silicon) ，請按一下 下載。

   代理程式金鑰及位置已預先移入，因此您只需要擷取並啟動代理程式。

   

3. 解壓縮代理程式保存檔。

附註: 您 必須 使用 GNU-tar 來解壓縮保存檔，因為它包含長度超過 100 個字元的路徑。 如果無法這樣做，將阻止代理程式以「嚴重: 無法啟動架構」錯誤啟動。

執行代理程式

1. 開啟 終端機，並將目錄切換至您解壓縮代理程式的路徑。 通常是 ~/Downloads/instana-agent。

   cd ~/Downloads/instana-agent
   

2. 請確定已根據 必要條件 區段來設定 JAVA_HOME 環境變數。 然後，執行下列指令，以在背景中啟動代理程式:

   bin/start
   

3. 透過在終端機中執行下列指令，檢查代理程式是否已啟動並在執行中:

   bin/status
   

4. 在 Apple silicon型機器上第一次啟動 Instana 代理程式時，您可能會看到來自 macOS 的警告，指出執行代理程式需要名為 libsigar-universal64-macosx.dylib的未簽署程式庫。

   

   若要容許使用此架構特定的程式庫，您需要從 系統喜好設定 -> 安全與隱私權 -> 一般核准它。

   

   然後，透過在終端機中執行下列指令來重新啟動代理程式，並在即將出現的蹦現視窗上再次核准程式庫:

   bin/stop & bin/start
   

檢查主機代理程式的狀態

安裝主機代理程式之後，您可以在 Instana 使用者介面或主機上檢查主機代理程式的狀態。 如需相關資訊，請參閱 檢查主機代理程式的狀態。

限制

• Instana 提供與 MacOS 的最大努力相容性，以用於開發及測試。 您必須以一般使用者帳戶而非 root 帳戶身分執行 Instana 代理程式。 此外， Instana 只會監視相同使用者所執行的程序。 不支援在 Docker 儲存器中執行代理程式。 最後，由於 Docker Machine、 Docker for Mac 及一般 Linux Docker的內部差異很大，因此無法監視 Docker 儲存器。

• 在 Apple silicon型機器上，尚未簽署架構特定的程式庫。 遵循本主題中 執行指示 的步驟 4 ，以核准 libsigar-universal64-macosx.dylib 檔案庫。 如需相關資訊，請參閱官方 Apple 文件。