在 Docker

CPU 和記憶體

您要安裝 Instana 後端的機器必須至少有 12 個 CPU 及 48 GiB 可用記憶體。 此需求是最低限制，僅建議用於小型安裝。 正式作業環境必須具有最少 16 個 CPU 及 64 GiB 記憶體。

儲存體考量

• 資料儲存庫、 Cassandra及 ClickHouse的 Instana 後端裝載點至少需要 1 TB 可用空間。 視要監視的環境大小及資料吸收速率而定，可能需要更多儲存體容量。

  您需要設定下列裝載點及外部磁區，並配置資料儲存庫、 Cassandra及 ClickHouse 的裝載點，至少有 1 TB 可用空間:

  • 資料儲存庫

    預設為 /mnt/data。

  • Cassandra

    它無法將相同的磁區用於正式作業安裝。 預設為 /mnt/metrics。

  • ClickHouse

    它無法將相同的磁區用於正式作業安裝。 預設為 /mnt/traces。

  • 日誌

    預設為 /var/log/instana。 必要的話，您可以建立不同的目錄。

• Docker 映像檔至少需要 25 GB 可用空間。

1. 安裝 Instana 套件

若要在機器上安裝 Instana 套件，請使用下列安裝步驟:

export DOWNLOAD_KEY=<download_key>

echo 'deb [signed-by=/usr/share/keyrings/instana-archive-keyring.gpg] https://artifact-public.instana.io/artifactory/rel-debian-public-virtual generic main' > /etc/apt/sources.list.d/instana-product.list

cat << EOF > /etc/apt/auth.conf
machine artifact-public.instana.io
  login _
  password $DOWNLOAD_KEY
EOF

wget -O- --user=_ --password="$DOWNLOAD_KEY" https://artifact-public.instana.io/artifactory/api/security/keypair/public/repositories/rel-debian-public-virtual | gpg --dearmor > /usr/share/keyrings/instana-archive-keyring.gpg

apt update -y
apt install -y instana-console

cat > /etc/apt/preferences.d/instana-console <<EOF
Package: instana-console
Pin: version <version to pin>
Pin-Priority: 1000
EOF

export DOWNLOAD_KEY=<download_key>

cat << EOF > /etc/yum.repos.d/Instana-Product.repo
[instana-product]
name=Instana-Product
baseurl=https://_:$DOWNLOAD_KEY@artifact-public.instana.io/artifactory/rel-rpm-public-virtual/
enabled=1
gpgcheck=0
gpgkey=https://_:$DOWNLOAD_KEY@artifact-public.instana.io/artifactory/api/security/keypair/public/repositories/rel-rpm-public-virtual
repo_gpgcheck=1
EOF

yum clean expire-cache -y
yum update -y
yum install -y instana-console

yum versionlock add instana-console

2. 安裝 Instana

附註: Instana 指令需要 root 使用者才能執行，因為需要調整核心中的部分值，並確保在不同裝載點上正確地設定存取權。

Instana 儲存器會實作成無根。 因此，即使安裝程式需要 root 使用者，應用程式本身也會在提供的 instana-user 中執行。

1. 若要在機器上安裝 Instana 後端，請執行下列指令:

   instana init
   

   附註: settings.hcl 檔案會產生在您執行 instana init 指令所在的相同目錄中。

2. 選取 single (單一主機安裝)。

3. 輸入下列資訊：

   • 您的租戶名稱及裝置名稱。

     • 租戶名稱必須符合正規表示式型樣 ^[a-z][a-z0-9]*$。
     • 租戶名稱不得超過 15 個字元的長度上限。
     • 租戶名稱必須以字母字元開頭。
     • 租戶名稱可以由英數字元組成。
     • 字元必須是小寫。

   • 您的代理人金鑰和銷售金鑰。

   • DNS 名稱。

   • 憑證檔案的路徑。 如果未定義路徑， Instana 會在 cert 資料夾中為使用者介面 (tls.crt) 和金鑰 (tls.key) 產生 HTTP TLS 憑證。 如果您想要產生自己的自簽憑證，請在下列指令中輸入您的主機名稱:

     openssl req -x509 -newkey rsa:2048 -keyout tls.key -out tls.crt -days 365 -nodes -subj "/CN=<hostname>"
     

4. 您現在可以使用所顯示的認證來登入 Instana。

5. 部署 Instana 之後，請 啟動您的授權。

將映像檔匯出至 tar

執行下列指令，即可將 instana-console 版本的所有必要映像檔匯出至 tar 檔:

instana images export -k ${agent_key}

從 tar 匯入映像檔

執行下列指令，將匯出映像檔 tar 匯入至本端 Docker 快取:

instana images import -f /path/to/export.tar

預先取回映像檔

執行下列指令，將所有必要的映像檔預先提取至本端 Docker 快取:

instana images pull -k ${agent_key}

將映像檔推送至自訂登錄

容許執行下列指令，將儲存器從本端 Docker 快取推送至自訂代管登錄:

instana images push -u ${registry_user} -p ${registry_pass} -r ${registry_url}

之後，登錄可以在 settings.hcl 檔案中配置，且安裝程式會使用它來進行安裝及更新。

列出映像檔和版本

執行下列指令，以傳回此版本目前所需的映像檔清單:

instana images version

刪改本端映像檔快取

執行下列指令，從本端快取中移除現行版本不再需要的所有儲存器:

instana images prune

1. 選用項目: 從現有機器複製資料

如果您想要從現行安裝架構移轉，則需要花一些時間將現有資料移至新機器。

若要這樣做，最好從原始安裝架構複製現有的 data 和 log 目錄。 您可以檢查原始 settings.hcl 檔案，以找出這些目錄的裝載位置。

在 Instana 關閉之後，您可以從下列目錄進行複製:

• 名為 clickhouse的所有目錄，例如 /mnt/traces/clickhouse 和 /mnt/log/instana/clickhouse。
• 名為 zookeeper的所有目錄，例如 /mnt/data/zookeeper 和 /mnt/log/instana/zookeeper。

將目錄移至新機器上的相同目錄，並配置新的 settings.hcl 檔。

附註: 您不需要刪除舊目錄，但建議您在新設定啟動並執行之後執行。

2. 安裝 instana 主控台

如先前所述，從儲存庫安裝 instana-console 。

3. 公開 Docker 常駐程式埠

計算實例的安裝程式會嘗試連接至此主機的埠 :2376 ，以檢查必備項目。 如需相關資訊，請參閱 在遠端 Docker 主機上啟用及存取 Docker 引擎 API

如果未適當地設定，您會看到下列錯誤訊息:

remote docker daemon is not reachable on host <clickhouse-host>:2376 : Cannot connect to the Docker daemon at tcp://<clickhouse-host>:2376. Is the docker daemon running?

4. 在第一個主機上安裝 ClickHouse 和 Zookeeper

  type = "dual-clickhouse"

  instana init -y

iptables -A INPUT -s $(instana backend host IP) -j ACCEPT
iptables -A OUTPUT -d $(instana backend host IP) -j ACCEPT
iptables -A INPUT -d $(ssh host IP) -j ACCEPT #optional
iptables -A OUTPUT -d $(ssh host IP) -j ACCEPT #optional
iptables -A INPUT -j REJECT
iptables -A OUTPUT -j REJECT

5. 在第二部主機上安裝 Instana 的其餘部分

  type                    = "dual-instana"
  clickhouse_bind_address = <IP of ClickHouse box>

  instana init -y

BeeInstana Metric Pipeline (測試版)

此特性包含新的資料管線，其中包含額外的 Instana 後端元件，以及用於儲存基礎架構度量值的資料儲存庫 (BeeInstana)。 根據此資料，可以在產品中啟動進一步特性。

• 自訂基礎架構儀表板
• 基礎架構探索

附註: 請確定儲存體位置中有足夠的可用空間可供度量資料使用，且整個系統目前未以其容量限制運作。 這是因為其他元件可能會危及穩定性。

預估磁碟大小可以從這個表格衍生 100 萬個度量值:

若要啟用管線及「自訂基礎架構儀表板」，請在 settings.hcl 檔案中啟用下列特性旗標，並使用 instana update 指令將此變更套用至系統。

...
feature "beeinstana" {
  enabled=true
}
...

此外，您可以使用下列特性旗標來啟動 Infrastructure Explore:

...
feature "infraEntityExplore" {
  enabled=true
}
...