環境變數

如需選擇性地配置主要 Instana 元件時所使用的各種環境變數，請參閱下列資訊。

主機代理程式

環境變數 值 說明
INSTANA_AGENT_ENDPOINT 字串 主機代理程式所連接的 Instana 後端端點 。 它取決於您的地區，並以 ingress-開頭。
INSTANA_AGENT_ENDPOINT_PORT 字串 主機代理程式所連接的 後端埠 。 預設值為 443。
INSTANA_AGENT_KEY 字串 您的 Instana 代理程式金鑰。
INSTANA_ZONE 字串 要在其中放置此主機代理程式的區域。
INSTANA_TAGS 字串，以逗點區隔 以逗點區隔且與執行代理程式之主機相關聯的標籤清單，例如 my_tag=myvalue,my_other_tag。
JAVA_OPTS 字串，以空格區隔 JVM 引數 您可能想要傳遞至主機代理程式啟動的其他 Java ® 虛擬機器配置。 例如，您可以使用 -Xms<value> 及 -Xmx<value> ，分別設定可供代理程式使用的資料堆數量下限及上限。
INSTANA_GIT_REMOTE_REPOSITORY 字串 遠端 Git 儲存庫的 URL; 例如 https://github.com/<your_account>/<your_repo>.git。
INSTANA_GIT_REMOTE_BRANCH 字串 Instana 主機代理程式要遵循的遠端分支名稱; 例如， main
INSTANA_GIT_REMOTE_USERNAME 字串 選用項目: 要在基本鑑別中使用的使用者名稱或存取記號
INSTANA_GIT_REMOTE_PASSWORD 字串 選用項目: 要在基本鑑別中使用的密碼

如需詳細資訊，請參閱 代理程式配置文件 及 代理程式 Git 型配置文件。

無伺服器監視

環境變數 值 說明
INSTANA_ENDPOINT_URL 字串 無伺服器代理程式所連接的 Instana 後端端點 。 它取決於您的地區，與主機代理程式後端端點不同。 它以 https://serverless-開頭。
INSTANA_AGENT_KEY 字串 您的 Instana 代理程式金鑰。 相同的代理程式金鑰可用於主機代理程式及無伺服器監視。
INSTANA_TIMEOUT 整數 向 Instana 後端報告資料的 HTTP 要求逾時 (毫秒)。
INSTANA_ENDPOINT_PROXY URL 將此變數設為 http://my-proxy.tld 或 http://user:password@my-proxy.tld ，以透過 HTTP (S) Proxy 將資料報告遞送至 Instana 後端。
INSTANA_EXTRA_HTTP_HEADERS 字串，以分號區隔 要擷取的 HTTP 標頭清單 (以分號區隔)。
INSTANA_SERVICE_NAME 字串 自訂服務名稱。
INSTANA_LOG_LEVEL debug、 info、 warn或 error Instana 套件的記載層次。 依預設，它是 info。
INSTANA_LOG_SPANS true 或 false 將此變數設為 true ，以讓 Instana 檢測所產生的文字段傾出至標準輸出。 此設定適用於對 SDK 及自動設備測試問題進行除錯。
INSTANA_DEBUG 字串 將此變數設為任何值，以將記載層次設為 debug。
INSTANA_DISABLE_CA_CHECK true 或 false 將此變數設為 true ，以在連接至 Instana 後端時，針對 Lambda 執行時期中所產生的 CA 清單停用驗證伺服器憑證。 啟用此特性會讓您的 lambda 容易遭到此連線的 MITM 攻擊。 除非您使用 Instana On-Premises ，且無法使用具有已知主要 CA 的憑證來操作 Instana 後端，否則不應使用此設定。
INSTANA_SECRETS 字串 該值的結構必須如下所示: <matcher>:<secret>[,<secret>]，例如: contains-ignore-case:key,password,secret。 如需配對器的詳細資料，請參閱 密鑰 文件。
INSTANA_TAGS 字串，以逗點區隔 以逗點區隔且與受監視元件相關聯的標籤清單，例如 my_tag=myvalue,my_other_tag。
INSTANA_ZONE 字串 要在其中放置此受監視元件的區域。
INSTANA_DISABLE_USE_OPENTELEMETRY true 或 false 將此變數設為 true 可停用 Opentelemery 整合。 預設值為 false。

AWS Lambda 支援

環境變數 Go Java Node.js Python
INSTANA_ENDPOINT_URL ✅ ✅ ✅ ✅
INSTANA_AGENT_KEY ✅ ✅ ✅ ✅
INSTANA_TIMEOUT ✅ ❌ ✅ ✅
INSTANA_ENDPOINT_PROXY ✅ ✅ ✅ ✅
INSTANA_EXTRA_HTTP_HEADERS ✅ ✅ ✅ ✅
INSTANA_SERVICE_NAME ✅ ✅ ✅ ✅
INSTANA_LOG_LEVEL ✅ ✅ ✅ ✅
INSTANA_LOG_SPANS ❌ ✅ ❌ ❌
INSTANA_DEBUG ✅ ✅ ✅ ✅
INSTANA_DISABLE_CA_CHECK ❌ ✅ ✅ ✅
INSTANA_SECRETS ✅ ✅ ✅ ✅
INSTANA_TAGS ❌ ✅ ❌ ❌
INSTANA_ZONE ✅ ✅ ✅ ✅
INSTANA_SSM_PARAM_NAME ❌ ❌ ✅ ❌
INSTANA_SSM_DECRYPTION ❌ ❌ ✅ ❌
INSTANA_DISABLE_USE_OPENTELEMETRY ❌ ❌ ✅ ❌

AWS Fargate 支援

環境變數 .NET Core Go Java Node.js Python
INSTANA_ENDPOINT_URL ✅ ✅ ✅ ✅ ✅
INSTANA_AGENT_KEY ✅ ✅ ✅ ✅ ✅
INSTANA_TIMEOUT ✅ ✅ ❌ ✅ ✅
INSTANA_ENDPOINT_PROXY ✅ ✅ ✅ ✅ ✅
INSTANA_EXTRA_HTTP_HEADERS ✅ ✅ ✅ ✅ ✅
INSTANA_SERVICE_NAME ❌ ✅ ✅ ✅ ✅
INSTANA_LOG_LEVEL ❌ ✅ ✅ ✅ ✅
INSTANA_LOG_SPANS ❌ ❌ ✅ ❌ ❌
INSTANA_DEBUG ✅ ✅ ✅ ✅ ✅
INSTANA_DISABLE_CA_CHECK ❌ ❌ ✅ ✅ ✅
INSTANA_SECRETS ✅ ✅ ✅ ✅ ✅
INSTANA_TAGS ✅ ✅ ✅ ✅ ✅
INSTANA_ZONE ✅ ✅ ✅ ✅ ✅
INSTANA_DISABLE_USE_OPENTELEMETRY ❌ ❌ ❌ ✅ ❌

Google Cloud 執行支援

環境變數 Go Node.js
INSTANA_ENDPOINT_URL ✅ ✅
INSTANA_AGENT_KEY ✅ ✅
INSTANA_TIMEOUT ✅ ✅
INSTANA_ENDPOINT_PROXY ✅ ✅
INSTANA_EXTRA_HTTP_HEADERS ✅ ✅
INSTANA_SERVICE_NAME ✅ ✅
INSTANA_LOG_LEVEL ✅ ✅
INSTANA_LOG_SPANS ❌ ❌
INSTANA_DEBUG ✅ ✅
INSTANA_DISABLE_CA_CHECK ❌ ✅
INSTANA_SECRETS ✅ ✅
INSTANA_TAGS ✅ ✅
INSTANA_ZONE ✅ ✅
INSTANA_DISABLE_USE_OPENTELEMETRY ❌ ✅

動態語言感應器

Instana 提供的「動態語言感應器」遵循一組一般環境變數。 下表說明這個共用集。

如需 Java的相關資訊，請參閱 Scala， 。NET， 。NET Core或 PHP，請參閱對應的文件頁面。

環境變數 值 說明
INSTANA_AGENT_HOST IP 位址或 DNS 名稱 容許使用者手動指定 Instana 主機代理程式的位置。
INSTANA_AGENT_PORT 埠號 手動指定 Instana 主機代理程式的埠。
INSTANA_DISABLE_AUTO_INSTR true 或 false 停用自動檢測。
INSTANA_SERVICE_NAME 字串 設定應用程式層面的服務名稱。
INSTANA_PROCESS_NAME 字串 為代表該執行時期的基礎架構實體設定自訂標籤。[1]
INSTANA_DEBUG 任意值 用來啟用除錯記載。 它應該僅在有限時間內使用，以避免額外負擔及日誌垃圾郵件。
INSTANA_DISABLE_USE_OPENTELEMETRY true 或 false 將此變數設為 true 可停用 Opentelemery 整合。 預設值為 false。

如需 Java的相關資訊，請參閱 Scala: 。NET， 。NET Core或 PHP，請參閱對應的文件頁面。

語言 Crystal 執行 Haskell NGINX Node.js Python Ruby .NET Core .NET
INSTANA_AGENT_HOST ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅
INSTANA_AGENT_PORT ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅
INSTANA_DISABLE_AUTO_INSTR N/A N/A N/A N/A ✅ ✅ ✅ ❌ ❌
INSTANA_SERVICE_NAME ❌ ✅ ✅ ✅ ✅ ✅ ✅ ❌ ❌
INSTANA_PROCESS_NAME ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅
INSTANA_DEBUG ✅ ✅ ❌ ✅ ✅ ✅ ✅ ✅ ✅
INSTANA_DISABLE_USE_OPENTELEMETRY ❌ ❌ ❌ ❌ ✅ ❌ ❌ ❌ ❌

如需配置選項的詳細資料，請參閱對應的語言頁面:

  1. 如果在任何警示規則中使用預設實體名稱 (例如 系統規則 > 主機 ，但沒有比對在其上執行的實體) ，則使用此功能變更實體名稱可以觸發那些警示。 ↩︎