主機代理程式

Instana 使用每一部主機上的單一主機代理程式，從受監視系統收集資料。 主機代理程式在主機上執行，以收集並聚集來自各種感應器的資料，然後再將資料傳送至 Instana 後端。

主機代理程式類型

Instana 主機代理程式有兩種類型: 動態 和 靜態，視它是否可以自行更新而定。

  • 動態 主機代理程式: 在啟動時從儲存庫下載最新感應器集的主機代理程式。 依預設，動態代理程式會以每日發行的最新及最大功能自行更新。 也可以透過 固定版本來緊密控制動態主機代理程式的更新。

    在大部分實務範例中，偏好使用動態主機代理程式，因為它很容易使用，而且在獲得新功能、效能改良及錯誤修正程式時可快速進行回轉。 依預設，動態主機代理程式會使用 Instana 儲存庫來取回更新。 但是在進階使用案例中，可以設定您自己的受管理鏡映。 如需如何配置主機代理程式更新的相關資訊，請參閱 主機代理程式更新。

  • 靜態 主機代理程式: 自行包含的主機代理程式，在發行時包含所有最新可用的元件，且沒有動態更新功能。

    靜態主機代理程式具有穩定的「資料清單」，在主機代理程式安裝之後永不變更。 不過，缺少更新功能意味著您需要提供自己的方式來讓 Instana 代理程式保持最新，例如使用基礎架構即程式碼工具 (例如 Ansible 或 Terraform)。 靜態主機代理程式不需要 Instana 儲存庫的網際網路連線，建議在受限網路設定中使用。

一般而言，建議您盡可能使用動態代理程式。 靜態代理程式往往不常更新，這會讓您錯過新功能、效能改良及錯誤修正。

主機代理程式模式

Instana 主機代理程式具有不同的作業模式，在此代理程式中，它會將其主機及在其上執行的應用程式監視至不同的延伸範圍:

  • OFF 模式: 在此模式下，主機代理程式不會監視，但只會定期通知 Instana 後端系統它正在閒置。
  • 基礎架構模式: 在此模式下，主機代理程式會監視基礎主機，並針對 Instana 支援的每一種技術啟動其感應器，但不會對應用程式執行任何追蹤。
  • APM 模式: 預設模式。 在此模式下，主機代理程式提供完整 Instana 體驗，包括對 Instana 支援的每一種技術進行監視和追蹤。

附註：

Instana 儲存器映像檔儲存庫的變更

Docker Hub 上公開可用的所有 Instana 儲存器映像檔都會移轉至 IBM Cloud Container Registry (ICR)。 無需 ICR 鑑別即可下載映像檔。 使用 Instana 專屬登錄 (位於 containers.instana.io ) 提供的映像檔不受此變更影響。

受影響的 Instana 映像檔

Docker Hub 映像檔 IBM Cloud Container Registry 映像檔 附註
instana/agent icr.io/instana/agent containers.instana.io/instana/release/agent/* 沒有變更
instana/aws-fargate-nodejs icr.io/instana/aws-fargate-nodejs containers.instana.io/instana/release/aws/fargate/nodejs 沒有變更
instana/aws-lambda-nodejs icr.io/instana/aws-lambda-nodejs
instana/google-cloud-run-nodejs icr.io/instana/google-cloud-run-nodejs containers.instana.io/instana/release/google/cloud-run/nodejs 沒有變更
instana/instana-agent-operator icr.io/instana/instana-agent-operator
instana/leader-elector icr.io/instana/leader-elector
instana/instrumentation icr.io/instana/instrumentation

Docker Hub 的容器映像檔登錄上的現有映像檔儲存庫將保留到至少 2022 年 6 月為止，但這些儲存庫中的映像檔將不再更新。 只有 ICR 上的儲存庫才會接收更新項目。 在 2022 年 7 月之後的某個時間點， Docker Hub 映像檔儲存庫將變成無法使用。

受影響資源

請參閱下列受影響的資源:

  • 靜態 Kubernetes 部署 YAML
  • 代理程式 Helm 圖表
  • 代理程式操作員
  • 自動追蹤 Webhook
  • 無伺服器影像層

自動更新

將所有映像檔移轉至 ICR 之後， Instana 將與受影響資源的下一版一起採用移轉。 從代理程式 Helm 圖表、代理程式「操作員」或「自動追蹤」Webhook 進行新的安裝及更新，將會參照新的 ICR 儲存庫。 此外，靜態 Kubernetes 部署 YAML 將參照新的代理程式儲存庫。

手動客戶互動

在下列情況下，您會受到這項移轉的影響，當您取回 Instana 映像檔時，需要手動調整:

  • 從 Instana 文件或「安裝 Instana 代理程式」精靈取回的靜態 Kubernetes 部署 YAML。
  • 來自專用儲存器映像檔儲存庫中 Docker Hub 的 Proxy Instana Docker 映像檔。
  • 使用自動化 Script 來安裝 Docker 化代理程式。
  • 建置 Node.js-based Fargate 作業儲存器映像檔及 Google Cloud 執行服務映像檔，這些映像檔使用 Instana 映像檔作為基本映像檔。

手動調整: 將 Instana 映像檔的任何參照變更為 icr.io/<image-repo-name>。 因為 Docker Hub 是預設登錄，所以通常只會使用儲存庫名稱來參照映像檔。 例如， instana/agent 會參照 Docker Hub 上的動態 Instana 代理程式。 這需要調整為 icr.io/instana/agent。 instana/instrumentation:latest 會參照 Autotrace Webhook 檢測映像檔。 這需要調整為 icr.io/instana/instrumentation:latest。

安裝、配置及管理