`mc admin trace`

描述

mc admin trace 命令顯示目標 MinIO 部署上發生的 API 操作。

僅在 MinIO 部署上使用 mc admin

MinIO 不支援將 mc admin 命令與其他 S3 相容服務一起使用，無論它們聲稱與 MinIO 部署的相容性如何。

範例

監控所有 API 操作

使用 mc admin trace 來監控 MinIO 部署上的 API 操作

mc admin trace -a ALIAS

將 ALIAS 替換為 MinIO 部署的 alias。

查看傳回 503 錯誤的呼叫

使用 mc admin trace 來監控傳回服務不可用 503 錯誤的 API 操作

mc admin trace -v --status-code 503 ALIAS

將 ALIAS 替換為 MinIO 部署的 alias。

查看路徑的主控台追蹤

使用 mc admin trace 來監控特定路徑的活動

mc admin trace --path my-bucket/my-prefix/* ALIAS

將 ALIAS 替換為 MinIO 部署的 alias。
將 my-bucket/my-prefix/* 替換為您想要追蹤的儲存桶、前綴和物件名稱或萬用字元。

查看回應大小大於 1Mb 的主控台追蹤

使用 mc admin trace 來監控超過特定大小的回應

mc admin trace --filter-response --filter-size 1Mb ALIAS

將 ALIAS 替換為 MinIO 部署的 alias。
將 1Mb 替換為所需的回應大小。

查看請求操作時間超過 5 毫秒的控制台追蹤

使用 mc admin trace 監控長時間的操作

mc admin trace --filter-duration --filter-size 5ms ALIAS

將 ALIAS 替換為 MinIO 部署的 alias。

語法

mc admin trace 的語法如下

mc admin trace [FLAGS] TARGET

mc admin trace 支援以下參數

TARGET: 指定要監控 API 操作的已設定 MinIO 部署的 alias。

--all, a: 傳回 MinIO 部署上的所有流量，包括 MinIO 伺服器之間的內部節點流量。

--call

僅追蹤符合的用戶端操作或呼叫類型。例如，以下命令僅追蹤類型為 scanner 的操作。

mc admin trace --call scanner TARGET

有效的呼叫類型包括

batch-keyrotation
batch-replication
bootstrap
decommission
ftp
healing
ilm
internal
os
rebalance
replication-resync
s3
scanner
storage

如果未指定，MinIO 會傳回 s3 的呼叫類型。

--errors, e: 僅傳回失敗的 API 操作。

--filter-request

追蹤請求大小大於指定的 --filter-size 值的用戶端操作或呼叫。

必須與 --filter-size 旗標一起使用。

--filter-response

追蹤回應大小大於指定的 --filter-size 值的用戶端操作或呼叫。

必須與 --filter-size 旗標一起使用。

--filter-size

已篩選的用戶端操作或呼叫的大小限制。

必須與 --filter-request 或 --filter-response 旗標一起使用。

有效單位包括

後綴	單位大小
`k`	KB (千位元組，1000 位元組)
`m`	MB (百萬位元組，1000 千位元組)
`g`	GB (十億位元組，1000 百萬位元組)
`t`	TB (兆位元組，1000 十億位元組)
`ki`	KiB (千位元組，1024 位元組)
`mi`	MiB (百萬位元組，1024 千位元組)
`gi`	GiB (十億位元組，1024 百萬位元組)
`ti`	TiB (兆位元組，1024 十億位元組)

--funcname: 傳回輸入的函數名稱的呼叫。

--method: 傳回指定的 HTTP 方法的呼叫。

--node: 傳回指定伺服器的呼叫。

--path: 傳回指定路徑的呼叫。

--request-header: 傳回符合所提供請求標頭的呼叫。

--request-query: 傳回符合所提供請求查詢參數的呼叫。此偵錯選項僅應在 MinIO 支援的指示下使用。

--response-duration: 追蹤回應時間長度大於指定值的呼叫。

--response-threshold

將時間字串作為值，例如 5ms。僅傳回回應時間大於所提供臨界值的呼叫。

如果未指定，MinIO 會傳回回應時間大於 5 毫秒的呼叫。

--status-code: 傳回指定 HTTP 狀態碼的呼叫。

--stats

在目前的追蹤會期期間，為每個追蹤的函數呼叫累積彙總的統計資料。

輸出表格包含以下欄。

呼叫	擷取的用戶端操作或函數的名稱。
計數	用戶端操作或呼叫發生的次數。
RPM	用戶端操作或呼叫的每分鐘速率 (RPM)。
平均時間	用戶端操作或呼叫完成所需的平均時間。
最短時間	用戶端操作或呼叫完成所花費的最短時間。
最長時間	用戶端操作或呼叫完成所花費的最長時間。
平均 TTFB	RELEASE.2023-11-15T22-45-58Z 版本的新功能。用戶端操作或呼叫回應的平均首次位元組時間 (TTFB)。
最大 TTFB	RELEASE.2023-11-15T22-45-58Z 版本的新功能。用戶端操作或呼叫回應的最大首次位元組時間。
平均大小	用戶端操作或呼叫回應的平均大小。
錯誤	失敗且發生錯誤的用戶端操作或呼叫次數。
RX 平均	用戶端操作或呼叫接收的平均位元組數 (RX)。此統計資料僅在不為零 (0) 時顯示。
TX 平均	用戶端操作或呼叫傳送的平均位元組數 (TX)。此統計資料僅在不為零 (0) 時顯示。

累積統計資料，例如名稱、計數、時間長度、最短時間、最長時間、首次位元組時間或錯誤。最多累積 15 個統計資料項目。

--verbose: 傳回詳細輸出。

全域旗標

此命令支援任何的全域旗標。