az monitor metrics

  • 參考

檢視 Azure 資源計量。

命令

名稱 Description 類型 狀態
az monitor metrics alert

管理近乎即時的計量警示規則。

 核心 GA
az monitor metrics alert condition

管理近乎即時的計量警示規則條件。

 核心 GA
az monitor metrics alert condition create

建置計量警示規則條件。

 核心 預覽
az monitor metrics alert create

建立以計量為基礎的警示規則。

 核心 GA
az monitor metrics alert delete

刪除以計量為基礎的警示規則。

 核心 GA
az monitor metrics alert dimension

管理近乎即時的計量警示規則維度。

 核心 GA
az monitor metrics alert dimension create

建置計量警示規則維度。

 核心 預覽
az monitor metrics alert list

列出以計量為基礎的警示規則。

 核心 GA
az monitor metrics alert show

顯示以計量為基礎的警示規則。

 核心 GA
az monitor metrics alert update

更新以計量為基礎的警示規則。

 核心 GA
az monitor metrics list

列出資源的計量值。

 核心 GA
az monitor metrics list-definitions

列出資源的計量定義。

 核心 GA
az monitor metrics list-namespaces

列出資源的計量命名空間。

 核心 預覽
az monitor metrics list-sub

列出訂用帳戶的計量數據。 您可以在本文上指定參數。

 核心 GA
az monitor metrics list-sub-definitions

列出訂用帳戶的計量定義。

 核心 GA

az monitor metrics list

編輯

列出資源的計量值。

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

範例

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

az monitor metrics list --resource {ResourceName} --metric "Percentage CPU"

列出記憶體帳戶的成功 E2E 延遲，並根據 API 名稱分割數據系列

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --dimension ApiName

列出記憶體帳戶的成功 E2E 延遲，並根據 API 名稱和地理位置類型分割數據系列

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --dimension ApiName GeoType

列出記憶體帳戶的成功 E2E 延遲，並使用 「--filter」 參數，根據 API 名稱和地理位置類型分割數據系列

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --filter "ApiName eq '*' and GeoType eq '*'"

列出記憶體帳戶的成功 E2E 延遲，並根據 API 名稱和地理位置類型來分割數據系列。 將 API 名稱限制為 'DeleteContainer'

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --filter "ApiName eq 'DeleteContainer' and GeoType eq '*'"

列出自 2017-01-01 起每天記憶體帳戶的交易

az monitor metrics list --resource {ResourceName} --metric Transactions \
                        --start-time 2017-01-01T00:00:00Z \
                        --interval PT24H

列出自 2017 年以來交易計量 API 名稱維度下記憶體帳戶的元數據值

az monitor metrics list --resource {ResourceName} --metric Transactions \
                        --filter "ApiName eq '*'" \
                        --start-time 2017-01-01T00:00:00Z

必要參數

--resource

目標資源的名稱或識別碼。

選擇性參數

--aggregation

要擷取的匯總類型清單（空格分隔）。

接受的值: Average, Count, Maximum, Minimum, None, Total
值來自: az monitor metrics list-definitions
--dimension

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

值來自: az monitor metrics list-definitions
--end-time

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

--filter

字串，用來減少傳回的計量數據集。 例如 “BlobType eq '*'”。

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

--interval

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

預設值: 1m
--metadata

傳回元數據值，而不是計量數據。

--metrics

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

值來自: az monitor metrics list-definitions
--namespace

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

值來自: az monitor metrics list-namespaces
--offset

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

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

預設值: 1h
--orderby

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

--resource-group -g

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

--resource-namespace

目標資源提供者命名空間。

--resource-parent

如果適用，則以資源父路徑為目標。

--resource-type

目標資源類型。 也可以接受命名空間/類型格式（例如：『Microsoft.Compute/virtualMachines』）。

--start-time

查詢的開始時間。 格式：date（yyyy-mm-dd） time （hh：mm：ss.xxxxx） timezone （+/-hh：mm）。

--top

要擷取的記錄數目上限。

預設值: 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 來取得完整偵錯記錄。

az monitor metrics list-definitions

編輯

列出資源的計量定義。

az monitor metrics list-definitions --resource
                                    [--namespace]
                                    [--resource-group]
                                    [--resource-namespace]
                                    [--resource-parent]
                                    [--resource-type]

範例

列出資源的計量定義。 （ 自動產生 ）

az monitor metrics list-definitions --resource /subscriptions/{subscriptionID}/resourceGroups/{resourceGroup}/Microsoft.Network/networkSecurityGroups/{resourceName}

必要參數

--resource

目標資源的名稱或識別碼。

選擇性參數

--namespace

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

值來自: az monitor metrics list-namespaces
--resource-group -g

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

--resource-namespace

目標資源提供者命名空間。

--resource-parent

如果適用，則以資源父路徑為目標。

--resource-type

目標資源類型。 也可以接受命名空間/類型格式（例如：『Microsoft.Compute/virtualMachines』）。

全域參數
--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 monitor metrics list-namespaces

編輯
預覽

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

列出資源的計量命名空間。

az monitor metrics list-namespaces --resource-uri
                                   [--start-time]

範例

列出資源的計量命名空間。

az monitor metrics list-namespaces --resource /subscriptions/{subscriptionID}/resourceGroups/{resourceGroup}/Microsoft.Network/networkSecurityGroups/{resourceName} --start-time 2021-03-01T00:00:00Z

必要參數

--resource-uri

資源的標識碼。

選擇性參數

--start-time

查詢的開始時間。 格式：date（yyyy-mm-dd） time （hh：mm：ss.xxxxx） timezone （+/-hh：mm）。

全域參數
--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 monitor metrics list-sub

編輯

列出訂用帳戶的計量數據。 您可以在本文上指定參數。

az monitor metrics list-sub --region
                            [--aggregation]
                            [--auto-adjust-timegrain {0, 1, f, false, n, no, t, true, y, yes}]
                            [--filter]
                            [--interval]
                            [--metricnames]
                            [--metricnamespace]
                            [--order-by]
                            [--result-type {Data, Metadata}]
                            [--roll-up-by]
                            [--timespan]
                            [--top]
                            [--validate-dimensions {0, 1, f, false, n, no, t, true, y, yes}]

必要參數

--region

您想要計量所在的區域。

選擇性參數

--aggregation

要擷取的匯總類型清單（逗號分隔）。

--auto-adjust-timegrain

當設定為 true 時，如果此計量不支援傳入的時間範圍，API 會使用最接近的支援時間範圍傳回結果。 當設定為 false 時，會傳回無效時間範圍參數的錯誤。 預設為 False。

接受的值: 0, 1, f, false, n, no, t, true, y, yes
--filter

$filter可用來減少傳回的計量數據集。
範例：
計量包含元數據 A、B 和 C。
- 傳回 C 的所有時間序列，其中 A = a1 和 B = b1 或 b2
$filter=A eq 'a1' 和 B eq 'b1' 或 B eq 'b2' 和 C eq '*'
- 無效的變體：
$filter=A eq 'a1' 和 B eq 'b1' 和 C eq '*' 或 B = 'b2'
這無效，因為邏輯或運算符無法分隔兩個不同的元數據名稱。
- 傳回所有時間序列，其中 A = a1、B = b1 和 C = c1：
$filter=A eq 'a1' 和 B eq 'b1' 和 C eq 'c1'
- 傳回 A = a1 的所有時間序列
$filter=A eq 'a1' 和 B eq '' 和 C eq ''。

--interval

以 ISO 8601 持續時間格式的查詢間隔 （亦即 timegrain） 。 預設為 PT1M。 傳回整個時間範圍之單一數據點之 『FULL』 值的特殊案例。 範例：PT15M、PT1H、P1D、FULL。

--metricnames

要擷取的計量名稱（逗號分隔）。

--metricnamespace

您想要之計量所在的計量命名空間。

--order-by

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

--result-type

減少收集的數據集。 允許的語法取決於作業。 如需詳細資訊，請參閱作業的描述。

接受的值: Data, Metadata
--roll-up-by

要匯總結果的維度名稱。。 例如，如果您只想要查看具有 『City eq Seattle 或 City eq Tacoma』 等篩選條件的計量值，但不想查看每個城市的個別值，您可以指定 'RollUpBy=City' 來查看 Seattle 和 Tacoma 的結果匯總成一次。

--timespan

查詢的時間範圍。 它是具有下列格式 『startDateTime_ISO/endDateTime_ISO』 的字串。

--top

要擷取的記錄數目上限。 只有在指定$filter時才有效。 預設值為 10。

--validate-dimensions

當設定為 false 時，將會忽略無效的篩選參數值。 當設定為 true 時，會傳回無效篩選參數的錯誤。 預設為 true。

接受的值: 0, 1, f, false, n, no, t, true, y, yes
全域參數
--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 monitor metrics list-sub-definitions

編輯

列出訂用帳戶的計量定義。

az monitor metrics list-sub-definitions --region
                                        [--metricnamespace]

必要參數

--region

您想要計量所在的區域。

選擇性參數

--metricnamespace

您想要之計量所在的計量命名空間。

全域參數
--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 來取得完整偵錯記錄。