共用方式為

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://learn.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。