Go 收集器配置

在大部分使用案例中，只要使用 instana.NewSensor() 來起始設定 Instana Go 收集器，並保留預設配置選項即可。 您也可以在起始設定 Instana Go 收集器時傳入配置物件:

sensor := instana.NewSensorWithTracer(
	instana.NewTracerWithOptions(&instana.Options{
		// ...
	},
)

instana.Options 配置物件提供下列欄位來配置收集器:

  • Service -廣域服務名稱，將用來識別 Instana 後端中的程式
  • AgentHost， AgentPort -預設為 localhost:42699，設定 Instana Proxy 代理程式的座標
  • LogLevel - Error、 Warn、 Info 或 Debug 其中之一
  • EnableAutoProfile -在 true 時啟用自動連續處理程序側寫
  • MaxBufferedSpans -緩衝區的跨距數目上限
  • ForceTransmissionStartingAt -清除代理程式的緩衝區之前要收集的跨距數目
  • MaxBufferedProfiles -要緩衝區的設定檔數目上限
  • IncludeProfilerFrames -是否將側寫程式呼叫併入設定檔中
  • Tracer -所有追蹤程式實例使用的 追蹤程式特定配置

大部分這些值也可以透過 環境變數來設定。 應用程式內配置優先於環境變數，但下列設定除外:

  • INSTANA_SERVICE_NAME 容許置換程式碼中設定的服務名稱
  • INSTANA_PROCESS_NAME 容許置換代表 Go 處理程序之基礎架構實體的名稱。
  • 即使應用程式碼配置定義較高的記載層次， INSTANA_DEBUG 也會啟用除錯日誌
  • INSTANA_AUTO_PROFILE 使用 AutoProfile™ 啟用連續側寫

在無伺服器環境中執行

若要使用 Instana Go 收集器來監視在無伺服器環境中執行的服務 (例如 AWS Fargate 或 Google Cloud Run) ，請確定您在作業定義中已設定 INSTANA_ENDPOINT_URL 及 INSTANA_AGENT_KEY 環境變數。 請注意，在此情況下將忽略 INSTANA_AGENT_HOST 和 INSTANA_AGENT_PORT 環境變數。 如需如何執行此動作的詳細說明，請參閱 Instana 文件的個別小節:

在無伺服器環境中執行的服務不會使用主機代理程式將度量及追蹤資料傳送至 Instana 後端，因此透過 configuration.yaml 檔案配置應用程式內感應器的一般方式不適用。 相反地，在服務作業定義中可以選擇性地配置一組環境變數:

  • INSTANA_TIMEOUT
  • INSTANA_SECRETS
  • INSTANA_EXTRA_HTTP_HEADERS
  • INSTANA_ENDPOINT_PROXY
  • INSTANA_TAGS
  • INSTANA_ZONE

如需這些變數及其值格式的更詳細說明，請參閱 無伺服器監視 一節。

Kafka 追蹤相關性標頭

您可以配置 Go 追蹤程式搭配環境變數 INSTANA_KAFKA_HEADER_FORMAT使用之 Kafka 追蹤相關性標頭的格式。 有效值為 binary、 string或 both。

另一個替代方案是在 Instana 主機代理程式層次配置 Kafka 追蹤相關性標頭格式。

如需相關資訊，請參閱 Kafka 標頭移轉。