在 Linux

支援的配送

單線性支援下列 Linux 發行套件:

• Debian 衍生工具 (apt 套件管理程式)
• Red Hat 衍生工具 (yum 套件管理程式)
• SUSE 衍生工具 (zypp 套件管理程式)

使用單線性

附註: 您需要 root 使用者專用權，才能安裝 Instana 主機代理程式。

若要使用單線性，請完成下列步驟:

1. 登入 Instana ，然後按一下 其他 > 代理程式 > Instana 代理程式安裝 > Linux。

2. 從 技術 清單中，選取 自動安裝 (單線性)。

   您的 代理程式金鑰 及位置已在單行指令中預先移入。

3. 針對主機代理程式安裝，複製並執行下列其中一個指令:

   使用 Zulu JVM 的動態代理程式 (互動式安裝):

   curl -o setup_agent.sh https://setup.instana.io/agent && chmod 700 ./setup_agent.sh && sudo ./setup_agent.sh -a $yourAgentKey -t dynamic -e $location:443
   

   使用 Zulu JVM 的動態代理程式 (無聲自動安裝):

   curl -o setup_agent.sh https://setup.instana.io/agent && chmod 700 ./setup_agent.sh && sudo ./setup_agent.sh -a $yourAgentKey -t dynamic -e $location:443 -y
   

   使用 Zulu JVM 的靜態代理程式 (互動式安裝):

   curl -o setup_agent.sh https://setup.instana.io/agent && chmod 700 ./setup_agent.sh && sudo ./setup_agent.sh -a $yourAgentKey -t static -e $location:443
   

   使用 Zulu JVM 的靜態代理程式 (無聲自動安裝):

   curl -o setup_agent.sh https://setup.instana.io/agent && chmod 700 ./setup_agent.sh && sudo ./setup_agent.sh -a $yourAgentKey -t static -e $location:443 -y
   

4. 若要執行 Instana 主機代理程式，請執行下列其中一個指令:

   • 如果您的作業系統使用 systemd 作為 init 系統，請執行 systemctl start instana-agent.service 指令。
   • 如果您的作業系統使用 SysVinit 作為 init 系統，請執行 service instana-agent start 指令。

其他參數

單線性指令接受下列參數:

當您下載並執行 one-liner.sh Script 時，它會透過建立儲存庫檔案，將 Instana 的公用系統套件儲存庫新增至您的系統。 這個檔案會將 Instana 鑑別儲存庫新增至機器的安裝來源。

安裝期間的潛在問題

  Setting up Instana APT repository
  Importing Instana GPG key
  Updating apt metadata ...
  E: The method driver /usr/lib/apt/methods/https could not be found.
  APT repository metadata update failed

  Setting up Instana agent for GNU/Linux
  Setting up Instana zypper repository
  Updating zypper metadata ...
  Installing Instana agent ...
  Error building the cache:
  [instana-agent|https://_@packages.instana.io/agent/generic/x86_64] Valid metadata not found at specified URL
  Some of the repositories have not been refreshed because of an error.
  No provider of 'instana-agent-static' found.
  Instana agent package install failed

Setting up Instana agent for GNU/Linux
Setting up Instana YUM repository
Updating YUM metadata ...
YUM repository metadata update failed

Error unpacking rpm package instana-agent-dynamic-20210630-0948.x86_64
Error: Transaction failed

sudo rpm -ivh instana-agent-dynamic-20210713-1352.x86_64.rpm
...
error: unpacking of archive failed on file /etc/init.d/instana-agent;60eda3b3: cpio: Digest mismatch
error: instana-agent-dynamic-20210713-1352.x86_64: install failed

sudo rpm -ivh --nodigest --nofiledigest instana-agent-dynamic-20210713-1352.x86_64.rpm

Debian 衍生

若要使用 Instana 代理程式套件的資源準備 Apt ，請建立下列檔案:

# /etc/apt/sources.list.d/instana-agent.list
deb [arch=amd64] https://packages.instana.io/agent generic main

# /etc/apt/auth.conf.d/instana-packages.conf
machine packages.instana.io
login _
password ${INSTANA_AGENT_KEY}

或者，您可以將鑑別寫在 /etc/apt/sources.list.d/instana-agent.list中的 URL 中，但它會造成溫和的安全風險，且 apt 會發出警告，每當您安裝或更新 Instana 套件時都會顯示這些警告。

若要將 Instana GPG 金鑰新增至 APT ，請執行下列指令:

wget -qO - https://packages.instana.io/Instana.gpg | sudo apt-key add -

RPM 型發行套件

將下列程式碼 Snippet 複製到您的 yum 來源 (/etc/yum.repos.d/Instana-Agent.repo):

[instana-agent]
name=Instana
baseurl=https://_:${INSTANA_AGENT_KEY}@packages.instana.io/agent/generic/x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://packages.instana.io/Instana.gpg
priority=5
sslverify=1

附註: 將 ${INSTANA_AGENT_KEY} 取代為 代理程式金鑰。

如果您想要啟用 GPG 套件驗證，部分發行套件需要您事先將金鑰匯入套件管理程式的金鑰環。

若要匯入金鑰，請執行下列指令:

rpm --import https://packages.instana.io/Instana.gpg

openSUSE/SLES

若為 openSUSE 及 SUSE Linux Enterprise Server ，路徑為 /etc/zypp/yum.repos.d/Instana-Agent.repo，但內容可以維持與 RPM 型發行套件相同。

Debian 導數

若要安裝靜態代理程式，請執行下列指令:

apt-get install instana-agent-static

若要安裝動態代理程式，請執行下列指令:

apt-get install instana-agent-dynamic

Red Hat 衍生工具

若要安裝靜態代理程式，請執行下列指令:

yum install instana-agent-static

若要安裝動態代理程式，請執行下列指令:

yum install instana-agent-dynamic

在 Debian 衍生工具上解除安裝

執行下列指令，以取得系統上所安裝套件的名稱:

apt list --installed | grep instana-agent

輸出會保留確切的套件名稱，以用於 uninstall 指令。 在下列範例中，套件名稱為 instana-agent-static-j9/generic:

instana-agent-static-j9/generic,now 20221024-1455 amd64 [installed]

執行下列指令，以解除安裝代理程式:

sudo apt-get purge <package_name>

其中 <package_name> 是您取得的套件名稱。

在 Red Hat 衍生工具上解除安裝

執行下列指令，以取得系統上所安裝套件的名稱:

yum list installed | grep instana-agent

輸出會保留要用於解除安裝指令的確切套件名稱。 在下列範例中，套件名稱為 instana-agent-static-j9.x86_64:

instana-agent-static-j9.x86_64       20221024-1455                 @instana-agent

執行下列指令，以解除安裝代理程式:

sudo yum remove <package_name>

其中 <package_name> 是您取得的套件名稱。

附註: 在實施時， Instana 代理程式所建立的部分檔案不是套件的一部分。 清除 Instana 代理程式安裝的程序需要額外的手動步驟來移除安裝目錄。 SUSE 和 Red Hat 衍生物需要清除，因為 Yum 不支援清除。

執行下列指令，以移除安裝目錄:

rm -rf /opt/instana/agent

必要條件

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

• 將 JDK 放置或鏈結至 <instana-agent-install-dir>/jvm (使 <instana-agent-install-dir>/jvm/bin/java 存在)。

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

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

• IBM OpenJ9 JDK 11 (偏好)
• Azul Zulu JDK 8
• OpenJDK JDK 8
• Oracle Hotspot JDK 8
• Amazon Corretto JDK 8
• IBM J9 8

JVM 必須是系統上所有使用者的執行檔。 建議您使用您選擇之 Java 發行套件的最新可用修補程式版本。 代理程式需要支援 TLSv1.3 的 JDK (適用於所有現行 JDK 8 和 JDK 11 建置)。 視您的 OS 發行套件而定，由於匯出控制， OS 配送器所提供的套件可能不包含高度加密支援。 如果您使用這類套件，可能會遇到類似「java.lang.RuntimeException: 無法產生 DH 金鑰組」的錯誤。

若要在偵測檔案系統變更時減少代理程式使用的資源，您需要在 Linux 發行套件上安裝 inotify-tools 套件。

代理程式通訊

代理程式會從下列主機下載更新項目及感應器:

DNS 名稱: artifact-public.instana.io 目的地埠: tcp/80 及 tcp/443

目前， Instana 服務在兩個不同的區域中提供。 您的個別實例位於地理上最接近大部分代理程式及使用者的位置。 代理程式會在下載時預先配置，但部分安裝方法需要 Instana 後端配置。 請參閱產品內的「代理程式管理」區段或您在 Instana 的技術聯絡人，以瞭解實例所在的地區。

如果您使用自行管理 (內部部署) Instana ，請使用在 Docker (內部部署) 上自行管理 Instana 後端中說明的端點。

如果您使用 SaaS，請使用 主機代理程式端點上說明的端點。

下載代理程式

若要下載代理程式，請遵循下列步驟:

1. 登入 Instana ，然後按一下 其他 > 代理程式。

2. 按一下 安裝 Instana 代理程式。

3. 在下拉功能表中，選取適當的作業系統。

4. 按一下 下載 按鈕，並解壓縮對應於系統架構的代理程式保存檔。

它會自動預先配置您的帳戶設定，因此您只需要擷取並啟動代理程式。

wget --save-cookies {{agent_folder_name}}/instana-cookies.txt --post-data 'email={{instana_username}}&password={{instana_password}}' https://{{instana_tenant_unit}}-{{instana_tenant}}.instana.io/auth/signIn

wget --content-disposition --load-cookies {{agent_folder_name}}/instana-cookies.txt --post-data 'type=linux64' https://instana.io/ump/{{instana_tenant}}/{{instana_tenant_unit}}/agent/download -O {{opt_folder}}/{{name_of_agent_archive.tar.gz}}

啟動代理程式

若要啟動代理程式，請執行下列指令：

INSTANA_AGENT_FOLDER/bin/start

停止代理程式

若要停止代理程式，請執行下列指令:

INSTANA_AGENT_FOLDER/bin/stop

代理程式的狀態

若要查看代理程式的狀態，請執行下列指令:

INSTANA_AGENT_FOLDER/bin/status

SystemV Init

代理程式會在 /etc/default/ 目錄 (Debian 及衍生工具) 或 /etc/sysconfig/ 目錄 (Red Hat 及衍生工具) 中尋找對應的 Shell Script。 如果服務名稱未變更，則為 SysVinit Script 原始檔 /etc/default/instana-agent 檔案或 /etc/sysconfig/instana-agent 檔案。

例如，在 Debian 中，可以使用 /etc/default/instana-agent 來更新 Instana 變數及 PATH (當發現可讀取此檔案時):

INSTANA_AGENT_KEY=$agentkey
INSTANA_AGENT_HOST=$endpoint
INSTANA_AGENT_PORT=$endpoint_port
PATH=/usr/local/bin:${PATH}

系統

對於 systemd ，您可以找到各種可用的選項、drop-in 單元、 EnvironmentFile 指引及廣域環境設定。 「放入單元」是最建議的方法。

在下列選項中，請務必先執行 sudo systemctl daemon-reload ，然後再執行 sudo systemctl restart instana-agent.service ，以重新載入具有變數變更的代理程式。

[Service]
Environment=INSTANA_AGENT_KEY=$agentkey
Environment=INSTANA_AGENT_HOST=$endpoint
Environment=INSTANA_AGENT_PORT=$endpoint_port
Environment=PATH=/usr/local/bin:${PATH}

INSTANA_AGENT_KEY=$agentkey
INSTANA_AGENT_HOST=$endpoint
INSTANA_AGENT_PORT=$endpoint_port
PATH=/usr/local/bin:${PATH}

[Service]
EnvironmentFile=/etc/instana/environment.conf

[Manager]
DefaultEnvironment="INSTANA_AGENT_KEY=<key>" "INSTANA_AGENT_HOST=<host>" "INSTANA_AGENT_PORT=<port>"

Tmpfiles.d

在 system.d型系統上， systemd-tmpfiles deamon 可以刪除 /tmp/.instana 目錄中主機代理程式所需的檔案，這會導致難以進行疑難排解的更新失敗。 從 v181版開始， DEB 和 RPM 代理程式套件會自動在 /usr/lib/tmpfiles.d 中安裝下列配置 Script ，以調整行為來與 Instana 主機代理程式搭配使用:

# Instana files in /tmp cannot be deleted when the agent is running,
# or it may lead to issues on agent update
R! /tmp/.java_pid*
R! /tmp/.instana/*

此配置僅容許 tmpdfiles.d 在主機重新啟動之後刪除 Instana 代理程式所需的檔案。 新執行的 Instana 主機代理程式會在啟動時重建檔案。

重要事項: Red Hat Enterprise Linux 和 CentOS(在第 6 版和第 7 版中) ，不論 Instana 這類套件可以指定哪些原則，預設 tmpdfiles.d 原則都會每 10 天刪除整個 /tmp 目錄一次。 這表示像 instana 之類的套件可以定義自訂原則，以控制系統或套件本身的行為。

#  This file is part of systemd.
#
#  systemd is free software; you can redistribute it and/or modify it
#  under the terms of the GNU Lesser General Public License as published by
#  the Free Software Foundation; either version 2.1 of the License, or
#  (at your option) any later version.

# See tmpfiles.d(5) for details
# Clear tmp directories separately, to make them easier to override
v /tmp 1777 root root 10d
v /var/tmp 1777 root root 30d

...

除了編輯預設 tmpfiles.d 原則，沒有可用的已知暫行解決方法。 不當的 tmpfiles.d 原則位於 /usr/lib/tmpfiles.d/tmp.conf中。

重要事項: 許多 Debian 衍生工具 (包括 Ubuntu) ，不論 Instana 之類的套件可以指定哪些原則，都會刪除整個 /tmp 目錄的預設 tmpdfiles.d 原則。 安裝時， DEB 及 RPM 套件會執行測試，以驗證暫存檔 tmpfiles.d的行為，並執行指令 systemd-tmpfiles --remove。 在原則會置換 Instana 代理程式套件所指定之所需行為的系統上，您可能會看到下列警告:

WARNING: The tmpfiles.d policies of this system may cause the Instana agent to malfunction by deleting the /tmp/.instana directory; refer https://www.instana.com/docs/setup_and_manage/host_agent/on/linux#tmpfiles.d for more information.

除了編輯預設 tmpfiles.d 原則，沒有可用的已知暫行解決方法。 不當的 tmpfiles.d 原則位於 /usr/lib/tmpfiles.d/tmp.conf中。

Tmpwatch

Red Hat Enterprise Linux 6 和 CentOS 6 包含工具 tmpwatch，已知它會在 /tmp/.instana中刪除不必要的檔案。 不過，在這些發行套件中使用 tmpwatch 有時會導致主機代理程式發生更新問題。 如需相關資訊，請參閱 暫存檔。

# Deal with tmpwatch, found in RHEL 6 and CentOS 6.
# It is a cronjob, installed in /etc/cron.d/daily, with pretty much hardcoded
# configurations to wipe data the Instana agent needs.
readonly TMPWATCH_CRONJOB='/etc/cron.d/daily/tmpwatch'
if [ -f "${TMPWATCH_CRONJOB}" ]; then
  # Let's check if we already touched the file and, if not, add our excludes
  if ! grep "${TMPWATCH_CRONJOB}" Instana 2&>1 > /dev/null; then
    echo "tmpwatch discovered in '${TMPWATCH_CRONJOB}': adding the exclude flags for Instana"
    # Edit in place with `sed`
    sed -i '/^flags=/a flags="${flags} -x /tmp/instana -x /tmp/.javapid* # Added by Instana"' "${TMPWATCH_CRONJOB}"
  fi
fi