Share via


az vm monitor metrics

此命令群組處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

管理 VM 的計量。

命令

名稱 Description 類型 狀態
az vm monitor metrics list-definitions

列出 VM 的計量定義。

核心 預覽版
az vm monitor metrics tail

列出 VM 的計量值。

核心 預覽版

az vm monitor metrics list-definitions

預覽

命令群組 'vm monitor metrics' 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

列出 VM 的計量定義。

az vm monitor metrics list-definitions --name
                                       --resource-group
                                       [--namespace]

範例

列出 VM 的計量定義。 (自動產生)

az vm monitor metrics list-definitions --name MyIDVirtualMachine --resource-group MyResourceGroup

必要參數

--name -n

虛擬機器的名稱或識別碼。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>

選擇性參數

--namespace

查詢計量定義的命名空間。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az vm monitor metrics tail

預覽

命令群組 'vm monitor metrics' 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

列出 VM 的計量值。

az vm monitor metrics tail --name
                           --resource-group
                           [--aggregation {Average, Count, Maximum, Minimum, None, Total}]
                           [--dimension]
                           [--end-time]
                           [--filter]
                           [--interval]
                           [--metadata]
                           [--metrics]
                           [--namespace]
                           [--offset]
                           [--orderby]
                           [--start-time]
                           [--top]

範例

列出過去一小時的 VM CPU 使用量

az vm monitor metrics tail --name myVM -g myRG --metric "Percentage CPU"

從 2019-12-18T00:00:00Z 開始列出 VM 的一小時 CPU 使用量

az vm monitor metrics tail --name myVM -g myRG --metric "Percentage CPU" --start-time 2019-12-18T00:00:00Z

使用篩選列出過去一小時的 VM CPU 使用量

az vm monitor metrics tail --name myVM -g myRG --metrics "Per Disk Read Bytes/sec" --filter "SlotId eq '*'"

必要參數

--name -n

虛擬機器的名稱或識別碼。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>

選擇性參數

--aggregation

要擷取的匯總類型清單(空格分隔)。

接受的值: Average, Count, Maximum, Minimum, None, Total
值來自: az vm monitor metrics list-definitions -n MyVM -g MyRG --query "@[*].supportedAggregationTypes"
--dimension

系統會查詢計量的維度清單(以空格分隔)。

值來自: az vm monitor metrics list-definitions -n MyVM -g MyRG --query "@[*].dimensions"
--end-time

查詢的結束時間。 預設為目前時間。 格式:date(yyyy-mm-dd) time (hh:mm:ss.xxxxx) timezone (+/-hh:mm)。

--filter

字串,用來減少傳回的計量資料集。 例如 「LUN eq '*'」。

如需篩選的完整清單,請參閱 上的 https://docs.microsoft.com/rest/api/monitor/metrics/list 篩選字串參考。

--interval

要匯總計量的間隔,格式為 ##h##m。

預設值: 1m
--metadata

傳回中繼資料值,而不是計量資料。

--metrics

要擷取之計量名稱的空間分隔清單。

值來自: az vm monitor metrics list-definitions -n MyVM -g MyRG --query "@[*].name.value"
--namespace

查詢計量定義的命名空間。

--offset

查詢範圍的時間位移,格式為 ##d##h。

可以搭配 --start-time 或 --end-time 使用。 如果搭配 --start-time 使用,則會藉由新增位移來計算結束時間。 如果使用 --end-time (預設值),則會藉由減去位移來計算開始時間。 如果提供 --start-time 和 --end-time,則會忽略 --offset。

預設值: 1h
--orderby

用於排序結果和排序方向的匯總。 只能指定一個訂單。 範例:sum asc。

--start-time

查詢的開始時間。 格式:date(yyyy-mm-dd) time (hh:mm:ss.xxxxx) timezone (+/-hh:mm)。

--top

要擷取的記錄數目上限。 只有在使用 --filter 時才有效。

預設值: 10
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。