Alibaba Cloud Service Mesh：診斷工具asmctl常用命令

命令

當前不支援原因

dashboard系列命令中，除dashboard envoy以外的命令

Service Mesh控制面由ASM託管，不支援通過命令列工具對控制面核心組件及Service Mesh自建可觀測性。

create-remote-secret

Service Mesh控制面由ASM託管，不支援自行為控制面建立Secret訪問遠程Kubernetes叢集。

istiod

Service Mesh控制面由ASM託管，不支援通過命令列工具管理控制面核心組件。

metrics

Service Mesh控制面由ASM託管，不支援通過命令列工具對控制面核心組件及Service Mesh自建可觀測性。

precheck

Service Mesh控制面由ASM託管，asmctl無需提供Istio相容性檢查相關功能。

proxy-status

Service Mesh控制面由ASM託管，當前不支援通過命令列工具自行查詢控制面狀態，您可以在Service Mesh控制台概覽頁面查看網格狀態。

uninstall、install

Service Mesh控制面由ASM託管，不支援自行安裝、卸載控制面。

version

當前不支援查看版本資訊，可以通過Service Mesh控制台查看網格基礎資訊。

wait

Service Mesh控制面由ASM託管，當前開發進度下不支援通過命令列工具自行查詢控制面狀態。

manifest、operator、profile、upgrade、verify-install

Service Mesh控制面由ASM託管，asmctl不提供通過命令在使用者側叢集中再次安裝istio的能力。

kube-inject、kube-uninject、workload、add-to-mesh系列命令、remove-from-mesh命令

asmctl還處於開發早期階段，目前暫時不開放會對叢集進行實質性更改的命令。

命令

描述

連結

asmctl analyze

分析叢集的控制面配置並輸出分析結果。

asmctl analyze

asmctl bug-report

選擇性地收集ASM執行個體與使用者側叢集中的資訊與日誌，並壓縮到一個壓縮包，協助您對常見問題進行診斷。

asmctl bug-report

asmctl dashboard

訪問與社區Istio相容的Web UI。

asmctl dashboard

asmctl dashboard envoy

為指定容器組的Sidecar開啟Envoy管理面板。

asmctl dashboard envoy

asmctl experimental

這些命令還在開發中，屬於實驗性命令。

asmctl experimental

asmctl experimental authz

提供與Service Mesh授權策略有關的功能。

asmctl experimental authz

asmctl experimental authz check

檢查指定容器組的Sidecar配置，並輸出應用在該容器組Sidecar上的所有授權策略。

asmctl experimental authz check

asmctl experimental config

提供與Service Mesh預設設定有關的功能。

asmctl experimental config

asmctl experimental config list

列出Service Mesh中可配置的預設設定資訊。

asmctl experimental config list

asmctl experimental describe

輸出有關指定Kubernetes資源以及與其相關的Service Mesh配置的描述性資訊。

asmctl experimental describe

asmctl experimental describe pod

根據指定的容器組，分析與它相關的Kubernetes服務、目標規則和虛擬服務等，並最終輸出與該容器組相關的描述性資訊。

asmctl experimental describe pod

asmctl experimental describe service

根據指定的Kubernetes服務，結合分析與之相關的容器組、目標規則和虛擬服務等，並最終輸出與該Kubernetes服務相關的描述性資訊。

asmctl experimental describe service

asmctl experimental injector

負責與Sidecar注入情況以及Sidecar注入器資訊有關的功能。

asmctl experimental injector

asmctl experimental injector list

列出每個命名空間中容器組Sidecar的注入情況，並輸出ASM使用的Sidecar注入器的概要資訊。

asmctl experimental injector list

asmctl proxy-config

負責擷取容器組中Sidecar的配置資訊。

asmctl proxy-config

asmctl proxy-config bootstrap

負責擷取指定容器組中Sidecar Envoy的bootstrap配置資訊。

asmctl proxy-config bootstrap

asmctl proxy-config cluster

負責擷取指定容器組中Sidecar Envoy的cluster配置資訊。

asmctl proxy-config cluster

asmctl proxy-config endpoint

負責擷取指定容器組中Sidecar Envoy的Endpoint配置資訊。

asmctl proxy-config endpoint

asmctl proxy-config listener

負責擷取指定容器組中Sidecar Envoy的Listener配置資訊。

asmctl proxy-config listener

asmctl proxy-config log

負責擷取Sidecar Envoy的日誌等級資訊，並且支援選擇性地更新日誌。

asmctl proxy-config log

asmctl proxy-config route

負責擷取指定容器組中Sidecar Envoy的Route配置資訊。

asmctl proxy-config route

asmctl proxy-config secret

負責擷取指定容器組中Sidecar Envoy的Secret配置資訊。

asmctl proxy-config secret

asmctl validate

負責驗證Service Mesh規則與策略檔案的正確性。

asmctl validate

選項

選項縮寫

描述

--all-namespaces

-A

分析所有的命名空間。

--asmconfig <string>

-m

設定ASM執行個體的kubeconfig檔案路徑，預設為$HOME/.kube/asmconfig。

--color

無

是否以帶顏色的格式輸出分析結果，預設為true，可設定為false。

--context <string>

無

設定預設使用的kubeconfig context名稱，預設為空白。

--failure-threshold <Level>

無

設定分析時在何種等級下會返回非0的錯誤碼。可用的值包括：Info、Warning 、Error，預設為Error。

--istioNamespace <string>

-i

設定Istio所在命名空間名稱，預設為istio-system。

--kubeconfig <string>

-c

設定使用者側叢集的kubeconfig檔案路徑，預設為空白。

--list-analyzers

-L

列出analyze命令當前執行的所有分析手段。

--meshConfigFile <string>

無

在分析時使用給定的網格設定檔來覆蓋當前的網格配置，預設為空白。

--namespace <string>

-n

指定生效的命名空間，預設為空白。

--output <string>

-o

設定輸出的格式，可用的值包括：log、json、yaml ，預設為空白。

--output-threshold <Level>

無

設定分析時在何種等級下會輸出訊息。可用的值包括：Info、Warning 、Error，預設為Info。

--recursive

-R

在指定了分析目錄時，遞迴地處理目錄中的所有檔案，而不是僅分析目錄中的第一層檔案。

--suppress <stringArray>

-S

設定停止報告某個特定資源的某個訊息碼。該項以<code>=<resource>的形式提供，例如--suppress "IST0102=DestinationRule primary-dr.default。該項可以重複提供，且可以在傳入的參數中使用萬用字元“*”來支援部分匹配，例如suppress "IST0102=DestinationRule *.default。該項預設為[]。

--timeout <duration>

無

設定命令返回逾時錯誤的時間，執行分析超過逾時時間後會返回timeout錯誤而不再返回分析結果，預設為30s。

--use-kube

-k

是否基於當前的ASM執行個體與使用者側叢集進行分析，如果只是想要分析檔案本身，則需將此項設定為use-kube=false。

--verbose

-v

設定輸出詳細的分析過程。

選項

選項縮寫

描述

--asmconfig <string>

-m

ASM執行個體的kubeconfig檔案路徑，預設為$HOME/.kube/asmconfig。

--context <string>

無

設定預設使用的kubeconfig context名稱，預設為空白。

--dir <string>

無

為bug-report命令中產生的臨時輸出檔案設定一個目錄，預設為空白。

--dry-run

無

控制是否實際進行日誌的收集和儲存，設定dry-run選項，表示不進行實際的日誌收集和儲存。

--duration <duration>

無

從目前時間計算，往前收集多長一段時間的日誌資訊。預設為無窮大（0s），如果該項被設定，則start-time選項不能被設定。

--end-time <string>

無

要包含在命令輸出中的日誌的時間跨度的結束時間。預設為現在時間。

--exclude <stringSlice>

無

匹配應該從所有Sidecar日誌中排除的容器組的Sidecar日誌。該項在include選項之後生效，更多資訊，請參見下文的自訂過濾bug-report命令收集的Sidecar日誌。預設排除命名空間kube-system、kube-public、kube-node-lease、local-path-storage中的容器組。

--filename <string>

-f

指定一個包含bug-report配置資訊的YAML檔案。該檔案中指定的選項內容將覆蓋在命令列選項中指定的內容，預設為空白。

--full-secrets

無

控制是否收集Secret資訊，設定full-secrets選項，則收集Secret資訊到命令輸出中。

--ignore-errs <stringSlice>

無

一系列以逗號分隔的glob匹配模式，這些模式用來匹配忽略的日誌錯誤（error）資訊字串。在計算日誌重要性時，匹配該項給出模式的錯誤將忽略不計。

--include <stringSlice>

無

匹配應該在命令輸出中包含的容器組的Sidecar日誌，更多資訊，請參見下文的自訂過濾bug-report命令收集的Sidecar日誌。預設為空白。

--istio-namespace <string>

-i

控制面組件安裝的命名空間，預設為istio-system。

--kubeconfig <string>

-c

設定使用者側叢集的kubeconfig檔案路徑，預設為空白。

--namespace <string>

-n

指定生效的命名空間，預設為空白。

--start-time <string>

無

包含在命令輸出中的日誌的時間跨度的開始時間。預設為空白，即從最早的日誌開始收集。

--timeout <duration>

無

能夠容忍擷取日誌所花的最長時間。當收集日誌時間逾時時，僅目前已經收集的日誌會儲存至命令輸出，預設為30m0s。

選項

選項縮寫

描述

--address <string>

無

Web UI的監聽地址，只接受IP地址或localhost。如果該項為localhost，asmctl將會嘗試綁定127.0.0.1（IPV4）或是::1（IPV6）兩個地址，如果這兩個地址都無法綁定則命令執行失敗。預設為localhost。

--browser

無

設定是否開啟瀏覽器。當browse選項被設定為false，asmctl將不會自動開啟瀏覽器，預設為true。

--context <string>

無

設定預設使用的kubeconfig context名稱，預設為空白。

--kubeconfig <string>

-c

設定使用者側叢集的kubeconfig檔案路徑，預設為空白。

--namespace <string>

-n

指定生效的命名空間，預設為空白。

--port <int>

-p

Web UI監聽的本地連接埠，預設為空白。

選項

選項縮寫

描述

--address <string>

無

Web UI的監聽地址，只接受IP地址或localhost。如果該項為localhost，asmctl將會嘗試綁定127.0.0.1（IPV4）或是::1（IPV6）兩個地址，如果這兩個地址都無法綁定則命令執行失敗。預設為localhost。

--browser

無

設定是否開啟瀏覽器。當browse選項被設定為false，asmctl將不會自動開啟瀏覽器，預設為true。

--context <string>

無

設定預設使用的kubeconfig context名稱，預設為空白。

--kubeconfig <string>

-c

設定使用者側叢集的kubeconfig檔案路徑，預設為空白。

--namespace <string>

-n

指定生效的命名空間，預設為空白。

--port <int>

-p

Web UI監聽的本地連接埠（預設為0）。

--selector <string>

-l

容器組標籤選取器（預設為空白，使用標籤選取器時不能提供容器組名稱。）

選項

選項縮寫

描述

--asmconfig <string>

-m

設定ASM執行個體的kubeconfig檔案路徑，預設為$HOME/.kube/asmconfig。

--context <string>

無

設定預設使用的kubeconfig context名稱，預設為空白。

--istioNamespace <string>

-i

設定Istio所在命名空間名稱，預設為istio-system。

--kubeconfig <string>

-c

設定使用者側叢集的kubeconfig檔案路徑，預設為空白。

--namespace <string>

-n

指定生效的命名空間，預設為空白。

選項

選項縮寫

描述

--context <string>

無

設定預設使用的kubeconfig context名稱，預設為空白。

--istioNamespace <string>

-i

設定Istio所在命名空間名稱，預設為istio-system。

--kubeconfig <string>

-c

設定使用者側叢集的kubeconfig檔案路徑，預設為空白。

--namespace <string>

-n

指定生效的命名空間，預設為空白。

選項

選項縮寫

描述

--context <string>

無

設定預設使用的kubeconfig context名稱，預設為空白。

--file <string>

-f

指定被檢查的Envoy配置轉儲檔案，檔案為JSON格式，預設為空白。

--istioNamespace <string>

-i

設定Istio所在命名空間名稱，預設為istio-system。

--kubeconfig <string>

-c

設定使用者側叢集的kubeconfig檔案路徑，預設為空白。

--namespace <string>

-n

指定生效的命名空間，預設為空白。

選項

選項縮寫

描述

--context <string>

無

設定預設使用的kubeconfig context名稱，預設為空白。

--istioNamespace <string>

-i

設定Istio所在命名空間名稱，預設為istio-system。

--kubeconfig <string>

-c

設定使用者側叢集的kubeconfig檔案路徑，預設為空白。

選項

選項縮寫

描述

--context <string>

無

設定預設使用的kubeconfig context名稱，預設為空白。

--istioNamespace <string>

-i

設定Istio所在命名空間名稱，預設為istio-system。

--kubeconfig <string>

-c

設定使用者側叢集的kubeconfig檔案路徑，預設為空白。

--namespace <string>

-n

指定生效的命名空間，預設為空白。

選項

選項縮寫

描述

--asmconfig <string>

-m

ASM執行個體的kubeconfig檔案路徑，預設為$HOME/.kube/asmconfig。

--context <string>

無

設定預設使用的kubeconfig context名稱，預設為空白。

--istioNamespace <string>

-i

設定Istio所在命名空間名稱，預設為istio-system。

--kubeconfig <string>

-c

設定使用者側叢集的kubeconfig檔案路徑，預設為空白。

--namespace <string>

-n

指定生效的命名空間，預設為空白。

選項

選項縮寫

描述

--context <string>

無

設定預設使用的kubeconfig context名稱，預設為空白。

--ignoreUnmeshed

無

對於分析時發現的未加入網格的容器組，設定是否輸出警告資訊，預設為false。

--istioNamespace <string>

-i

設定Istio所在命名空間名稱，預設為istio-system。

--kubeconfig <string>

-c

設定使用者側叢集的kubeconfig檔案路徑，預設為空白。

--asmconfig <string>

-m

ASM執行個體的kubeconfig檔案路徑，預設為$HOME/.kube/asmconfig。

--namespace <string>

-n

指定生效的命名空間，預設為空白。

選項

選項縮寫

描述

--context <string>

無

設定預設使用的kubeconfig context名稱，預設為空白。

--ignoreUnmeshed

無

對於分析時發現的未加入網格的容器組，設定是否輸出警告資訊，預設為false。

--istioNamespace <string>

-i

設定Istio所在命名空間名稱，預設為istio-system。

--kubeconfig <string>

-c

設定使用者側叢集的kubeconfig檔案路徑，預設為空白。

--asmconfig <string>

-m

ASM執行個體的kubeconfig檔案路徑，預設為$HOME/.kube/asmconfig。

--namespace <string>

-n

指定生效的命名空間，預設為空白。

選項

選項縮寫

描述

--context <string>

無

設定預設使用的kubeconfig context名稱，預設為空白。

--istioNamespace <string>

-i

設定Istio所在命名空間名稱，預設為istio-system。

--kubeconfig <string>

-c

設定使用者側叢集的kubeconfig檔案路徑，預設為空白。

--namespace <string>

-n

指定生效的命名空間，預設為空白。

選項

選項縮寫

描述

--context <string>

無

設定預設使用的kubeconfig context名稱，預設為空白。

--istioNamespace <string>

-i

設定Istio所在命名空間名稱，預設為istio-system。

--kubeconfig <string>

-c

設定使用者側叢集的kubeconfig檔案路徑，預設為空白。

--namespace <string>

-n

指定生效的命名空間，預設為空白。

選項

選項縮寫

描述

--context <string>

無

設定預設使用的kubeconfig context名稱，預設為空白。

--istioNamespace <string>

-i

設定Istio所在命名空間名稱，預設為istio-system。

--kubeconfig <string>

-c

設定使用者側叢集的kubeconfig檔案路徑，預設為空白。

--namespace <string>

-n

指定生效的命名空間，預設為空白。

--output <string>

-o

設定命令輸出格式，可選json和short，預設為short。

選項

選項縮寫

描述

--context <string>

無

設定預設使用的kubeconfig context名稱，預設為空白。

--file <string>

-f

Envoy配置轉儲檔案，JSON格式，預設為空白。

--istioNamespace <string>

-i

設定Istio所在命名空間名稱，預設為istio-system。

--kubeconfig <string>

-c

設定使用者側叢集的kubeconfig檔案路徑，預設為空白。

--namespace <string>

-n

指定生效的命名空間，預設為空白。

--output <string>

-o

設定命令輸出格式，可選json和short，預設為short。

選項

選項縮寫

描述

--context <string>

無

設定預設使用的kubeconfig context名稱，預設為空白。

--direction <string>

無

通過Direction欄位篩選收集的cluster配置資訊，預設為空白。

--file <string>

-f

Envoy配置轉儲檔案，JSON格式，預設為空白。

--fqdn <string>

無

通過Service FQDN欄位篩選收集的cluster配置資訊，預設為空白。

--istioNamespace <string>

-i

設定Istio所在命名空間名稱，預設為istio-system。

--kubeconfig <string>

-c

設定使用者側叢集的kubeconfig檔案路徑，預設為空白。

--namespace <string>

-n

指定生效的命名空間，預設為空白。

--output <string>

-o

設定命令輸出格式，可選json和short，預設為short。

--port <int>

無

通過Port欄位篩選收集的cluster配置資訊，預設為空白。

--subset <string>

無

通過Subset欄位篩選收集的cluster配置資訊，預設為空白。

選項

選項縮寫

描述

--address <string>

無

通過address欄位篩選收集的Endpoint配置資訊，預設為空白。

--cluster <string>

無

通過cluster name欄位篩選收集的Endpoint配置資訊，預設為空白。

--context <string>

無

設定預設使用的kubeconfig context名稱，預設為空白。

--file <string>

-f

Envoy配置轉儲檔案，JSON格式，預設為空白。

--istioNamespace <string>

-i

設定Istio所在命名空間名稱，預設為istio-system。

--kubeconfig <string>

-c

設定使用者側叢集的kubeconfig檔案路徑，預設為空白。

--namespace <string>

-n

指定生效的命名空間，預設為空白。

--output <string>

-o

命令輸出格式，可選json和short，預設為short。

--port <int>

無

通過Port欄位篩選收集的Endpoint配置資訊，預設為空白。

--status <string>

無

通過status欄位篩選收集的Endpoint配置資訊，預設為空白。

選項

選項縮寫

描述

--address <string>

無

通過address欄位篩選收集的Listener配置資訊，預設為空白。

--context <string>

無

設定預設使用的kubeconfig context名稱，預設為空白。

--file <string>

-f

Envoy配置轉儲檔案，JSON格式，預設為空白。

--istioNamespace <string>

-i

設定Istio所在命名空間名稱，預設為istio-system。

--kubeconfig <string>

-c

設定使用者側叢集的kubeconfig檔案路徑，預設為空白。

--namespace <string>

-n

指定生效的命名空間，預設為空白。

--output <string>

-o

命令輸出格式，可選json和short，預設為short。

--port <int>

無

通過Port欄位篩選收集的Listener配置資訊，預設為空白。

--type <string>

無

通過type欄位篩選收集的Listener配置資訊，預設為空白。

--verbose

無

輸出更多資訊，預設為true。

選項

選項縮寫

描述

--context <string>

無

設定預設使用的kubeconfig context名稱，預設為空白。

--istioNamespace <string>

-i

設定Istio所在命名空間名稱，預設為istio-system。

--kubeconfig <string>

-c

設定使用者側叢集的kubeconfig檔案路徑，預設為空白。

--level <string>

無

要輸出的以逗號分隔的每個logger的最低訊息層級，形式為：[<logger>:]<level>,[<logger>:]<level>,...。其中，logger可以是admin、aws、assert、backtrace、client、config、connection、conn_handler、dubbo、file、filter、forward_proxy、grpc、hc、health_checker、http、mongo、quic、pool、rbac、redis、router、runtime、stats、secret、tap、testing、thrift、tracing、upstream、udp、wasm中的一個。而訊息層級可以是trace、debug、info、warning、error、critical、off中的一個，預設為空白。

--namespace <string>

-n

指定生效的命名空間，預設為空白。

--output <string>

-o

設定命令輸出格式，可選json和short，預設為short。

--reset

-r

將日誌等級重設為預設值（warning）。

--selector <string>

-l

標籤選取器，預設為空白。

選項

選項縮寫

描述

--context <string>

無

設定預設使用的kubeconfig context名稱，預設為空白。

--file <string>

-f

Envoy配置轉儲檔案，JSON格式，預設為空白。

--istioNamespace <string>

-i

設定Istio所在命名空間名稱，預設為istio-system。

--kubeconfig <string>

-c

設定使用者側叢集的kubeconfig檔案路徑，預設為空白。

--name <string>

無

通過name欄位篩選收集的Router配置資訊，預設為空白。

--namespace <string>

-n

指定生效的命名空間，預設為空白。

--output <string>

-o

設定命令輸出格式，可選json和short，預設為short。

--verbose

無

輸出更多資訊，預設為true。

選項

選項縮寫

描述

--context <string>

無

設定預設使用的kubeconfig context名稱，預設為空白。

--file <string>

-f

Envoy配置轉儲檔案，JSON格式，預設為空白。

--istioNamespace <string>

-i

設定Istio所在命名空間名稱，預設為istio-system。

--kubeconfig <string>

-c

設定使用者側叢集的kubeconfig檔案路徑，預設為空白。

--namespace <string>

-n

指定生效的命名空間，預設為空白。

--output <string>

-o

設定命令輸出格式，可選json和short，預設為short。

選項

選項縮寫

描述

--context <string>

無

設定預設使用的kubeconfig context名稱，預設為空白。

--file <string>

-f

需要驗證的Service Mesh規格與策略檔案名稱。

--istioNamespace <string>

-i

設定Istio所在命名空間名稱，預設為istio-system。

--namespace <string>

-n

指定生效的命名空間，預設為空白。