Monitoring Traefik

Instana 能夠收集透過 Traefik 傳遞之要求的度量及分散式追蹤資料。

在您安裝 Instana 代理程式之後,會自動部署並安裝 Traefik 感應器。

代理程式配置

您可以在 代理程式配置檔中配置下列欄位:

com.instana.plugin.traefik:
  enabled: true
  poll_rate: 1 # seconds

配置

若要顯示度量及追蹤資訊,必須在 Traefik 安裝中啟用對應的特性。

度量值集合

若要檢視度量值,請在「Instana 使用者」介面的資訊看板中選取 基礎架構 ,按一下特定的受監視主機,然後您可以看到具有所有已收集度量值及受監視處理程序的主機儀表板。

配置資料

  • PID
  • 版本
  • 開始時間

效能度量

度量 說明 精度
每秒 HTTP 要求數 每秒 HTTP 要求數 1 秒
配置前次重新載入成功 前次順利重新載入配置的時間 1 秒
配置重新載入次數 每秒配置重新載入數 1 秒
進入點 每個進入點每秒 HTTP 要求數 1 秒

附註: 可監視的進入點數目上限限制為 100。

啟用度量收集

若要從 Traefik 應用程式啟用度量值收集,它必須使用 Prometheus 度量值來公開端點。 有多種方法可以執行此動作:

  • 使用配置檔 (YAML 或 TOML 格式)
  • 設定環境變數
  • 新增指令行引數

例如,配置檔中的下列行將在 :8888/metrics上公開度量:

#config.yaml
entryPoints:
  metrics:
    address: ":8888"

metrics:
  prometheus:
    entryPoint: metrics

度量端點必須可從 Instana 代理程式存取。

如需更多範例,請參閱 Traefik 網站

啟用追蹤

若要在 Traefik 應用程式中啟用追蹤,必須配置它。 有多種方法可以執行此動作:

  • 使用配置檔 (YAML 或 TOML 格式)
  • 設定環境變數
  • 新增指令行引數

例如:

#config.yaml
tracing:
  instana: {}

Instana 代理程式必須可從 Traefik 應用程式存取。

如需更多範例,請參閱 Traefik 網站

Traefik Helm 圖表

若要使用正式 Traefik Proxy Helm Chart,您需要明確提供配置來啟用「Instana 追蹤」,並公開如下所示的 Traefik Prometheus 度量:

helm install \
  --set="additionalArguments={--tracing.instana=true}" \
  --set ports.metrics.port=8080 \
  --set ports.metrics.exposedPort=8080 \
  traefik \
  traefik/traefik

疑難排解

監視問題類型: traefik_metrics_api_not_accessible

若要解決此問題,請參閱 啟用度量值集合 中說明的步驟,以瞭解如何配置 Traefik 應用程式來公開度量值端點。

監視問題類型: traefik_metrics_api_not_enabled

若要解決此問題,請參閱 啟用度量值集合 中說明的步驟,以瞭解如何配置 Traefik 應用程式來公開度量值端點。

監視問題類型: traefik_tracing_not_enabled

若要解決此問題,請參閱 啟用追蹤 中說明的步驟,以瞭解如何在 Traefik 應用程式中啟用追蹤。