ACK提供了Nginx-Ingress-tracing鏈路追蹤功能，支援將ACK叢集的Nginx Ingress Controller組件的鏈路資訊上報至Managed Service for OpenTelemetry。Managed Service for OpenTelemetry可以對鏈路資訊進行即時彙總計算和持久化，形成鏈路明細、即時拓撲等監控資料，以便您進行Nginx Ingress Controller組件的問題排查與診斷。
前提條件
已安裝了Nginx Ingress Controller組件。具體操作，請參見管理Nginx Ingress Controller組件。
版本說明
在不同版本的Nginx Ingress Controller組件中，鏈路追蹤的支援情況各不相同，您需要根據對應版本選擇相應的配置方式。
Nginx Ingress Controller版本 | OpenTelemetry | OpenTracing |
≥ v1.10.2-aliyun.1 | 支援 | 不支援 |
v1.9.3-aliyun.1 | 支援 | 支援 |
v1.8.2-aliyun.1 | 支援 | 支援 |
< v1.8.2-aliyun.1 | 不支援 | 支援 |
操作步驟
OpenTelemetry
步驟一：在ARMS中擷取存取點資訊
登入ARMS控制台，在左側導覽列單擊接入中心。
在服務端應用地區單擊Zipkin卡片。
說明根據實際使用的用戶端採集工具擷取存取點資訊，本文以Zipkin為例。
在彈出的Zipkin面板中選擇資料需要上報的地區。
記錄存取點資訊。
說明因為Nginx Ingress Controller組件部署在阿里雲上，且組件所在地區與Managed Service for OpenTelemetry接入配置中的地區一致，所以使用阿里雲VPC網路存取點，否則選擇公網存取點。
步驟二：在ACK的Ingress中開啟Managed Service for OpenTelemetry服務
登入Container Service管理主控台，在左側導覽列選擇叢集。
在叢集列表頁面，單擊目的地組群名稱，然後在左側導覽列，選擇。
在配置項頁面上方設定命名空間為kube-system，然後在名稱搜尋方塊中搜尋nginx-ingress-controller，然後單擊編輯。
在編輯頁面上方，選中nginx-ingress-controller容器，並在環境變數頁簽中單擊新增添加以下環境變數。
類型
變數名稱
變數/變數引用
描述
自訂
OTEL_EXPORTER_OTLP_HEADERS
authentication=<鑒權Token>使用步驟一：在ARMS中擷取存取點資訊中擷取的鑒權Token，例如
authentication=bfXXXXXXXe@7bXXXXXXX1_bXXXXXe@XXXXXXX1。
添加完成後，單擊編輯頁面右側欄的更新，然後在彈框中單擊確定。
在左側導覽列，選擇組態管理 > 配置項。
在配置項頁面上方設定命名空間為kube-system，然後在名稱搜尋方塊中搜尋nginx-configuration，然後單擊nginx-configuration操作列的編輯。
在編輯面板單擊添加以下配置，然後單擊確定。
名稱
描述
值
enable-opentelemetry
是否啟用OpenTelemetry鏈路追蹤。
true表示啟用。main-snippet
-
env OTEL_EXPORTER_OTLP_HEADERS;otel-service-name
自訂的服務名稱。
例如nginx-ingress。
otlp-collector-host
gRPC上報點網域名稱。
使用步驟一：在ARMS中擷取存取點資訊中擷取的阿里雲VPC網路存取點，並刪除
http://和連接埠號碼。例如tracing-analysis-XX-XX-XXXXX.aliyuncs.com。otlp-collector-port
gRPC上報點連接埠。
8090opentelemetry-trust-incoming-span
是否信任來自其他服務或系統的調用鏈。
true表示信任。opentelemetry-operation-name
調用鏈Span格式。
HTTP $request_method $service_name $uri
步驟三：在ARMS上查看調用鏈路資料
登入ARMS控制台，在左側導覽列中單擊。
在應用列表頁面頂部選擇地區，然後單擊應用程式名稱nginx-ingress。
在應用詳情頁面查看鏈路資訊。
在應用概覽頁簽，查看請求數、錯誤數等資訊。
在調用鏈分析頁簽，查看Trace列表、平均耗時等資訊。
在調用鏈分析頁簽，單擊TraceId，查看Trace詳情。
OpenTracing
步驟一：在ARMS中擷取存取點資訊
登入ARMS控制台，在左側導覽列單擊接入中心。
在服務端應用地區單擊Zipkin卡片。
說明根據實際使用的用戶端採集工具擷取存取點資訊，本文以Zipkin為例。
在彈出的Zipkin面板中選擇資料需要上報的地區。
記錄存取點資訊。
說明因為Nginx Ingress Controller組件部署在阿里雲上，且組件所在地區與Managed Service for OpenTelemetry接入配置中的地區一致，所以使用阿里雲VPC網路存取點，否則選擇公網存取點。
步驟二：在ACK的Ingress中開啟Managed Service for OpenTelemetry服務
登入Container Service管理主控台，在左側導覽列選擇叢集。
在叢集列表頁面，單擊目的地組群名稱，然後在左側導覽列，選擇。
在配置項頁面上方設定命名空間為kube-system，然後在名稱搜尋方塊中搜尋nginx-configuration，然後單擊nginx-configuration操作列的編輯。
配置Zipkin鏈路追蹤方式。
在編輯面板單擊添加，設定名稱為zipkin-collector-host ，值為步驟一：在ARMS中擷取存取點資訊擷取的存取點資訊。
重要該存取點資訊需要去掉
http://，並在末尾加上問號。樣本如下：原始存取點資訊為
http://tracing-analysis-dc-hz-internal.aliyuncs.com/adapt_******_******/api/v1/spans。修改後並輸入值為
tracing-analysis-dc-hz-internal.aliyuncs.com/adapt_******_******/api/v1/spans?。
開啟鏈路追蹤服務。
單擊添加，設定名稱為enable-opentracing，值為true，然後單擊確定。
步驟三：在ARMS上查看調用鏈路資料
切換OpenTelemetry透傳協議（可選）
採取OpenTelemetry方式實現Nginx Ingress Controller鏈路追蹤時，OpenTelemetry預設識別並向下遊傳遞W3C Trace Context格式的Trace上下文。如果您的前端應用和後端應用採用了其他協議，例如Jaeger或者Zipkin，需要修改OpenTelemetry的透傳格式，才能使前端應用、Nginx Ingress以及後端應用的調用鏈串聯起來。下面介紹如何修改Nginx Ingress Controller所使用的OpenTelemetry透傳協議。
請在步驟二第4步：在環境變數中添加OTEL_EXPORTER_OTLP_HEADERS的基礎上添加OTEL_PROPAGATORS環境變數，儲存後重新部署nginx-ingress-controller。
環境變數名
值
說明
OTEL_PROPAGATORS
tracecontext,baggage,b3,jaeger
透傳格式。更多資訊，請參見OpenTelemetry指定透傳Header格式。
請在步驟二第7步：添加nginx-configuration配置的基礎上修改main-snippet配置，使OTEL_PROPAGATORS環境變數生效。
配置名
值
說明
main-snippet
env OTEL_EXPORTER_OTLP_HEADERS; env OTEL_PROPAGATORS
載入環境變數。
相關文檔
關於Managed Service for OpenTelemetry，請參見什麼是可觀測鏈路 OpenTelemetry 版。
關於ACK，請參見什麼是Container Service Kubernetes 版。
不同的鏈路追蹤方式，例如Zipkin、Jaeger、SkyWalking等，需要在ACK的nginx-configuration配置不同的欄位。關於更多接入Managed Service for OpenTelemetry的方法，請參見準備工作。