az monitor app-insights metrics

備註

此參考是 Azure CLI 的 application-insights 擴充功能的一部分（2.55.0 版或更高版本）。 當您第一次執行 az monitor app-insights 計量 命令時，擴充功能會自動安裝。 深入瞭解擴充功能。

從應用程式擷取計量。

命令

名稱	Description	類型	狀態
az monitor app-insights metrics get-metadata	取得特定應用程式計量的元數據。	擴充套件	GA
az monitor app-insights metrics show	檢視單一計量的值。	擴充套件	GA

az monitor app-insights metrics get-metadata

取得特定應用程式計量的元數據。

az monitor app-insights metrics get-metadata [--app]
                                             [--ids]
                                             [--resource-group]
                                             [--subscription]

範例

檢視所提供應用程式的元數據。

az monitor app-insights metrics get-metadata --app e292531c-eb03-4079-9bb0-fe6b56b99f8b

選擇性參數

--app -a

Application Insights 元件的 GUID、應用程式名稱或完整 Azure 資源名稱。 您可以從 Azure 入口網站中任何 Application Insights 資源上的 API 存取功能表項取得應用程式 GUID。 如果使用應用程式名稱，請指定資源群組。

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--resource-group -g

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

--subscription

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

全域參數

--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 app-insights metrics show

檢視單一計量的值。

az monitor app-insights metrics show --metrics
                                     [--aggregation]
                                     [--app]
                                     [--end-time]
                                     [--filter]
                                     [--ids]
                                     [--interval]
                                     [--offset]
                                     [--orderby]
                                     [--resource-group]
                                     [--segment]
                                     [--start-time]
                                     [--subscription]
                                     [--top]

範例

檢視 availabilityResults 事件的計數。

az monitor app-insights metrics show --app e292531c-eb03-4079-9bb0-fe6b56b99f8b --metric availabilityResults/count

必要參數

--metrics -m

要擷取的計量。 可能是標準 AI 計量或應用程式特定的自訂計量。

選擇性參數

--aggregation

計算計量值時要使用的匯總。 若要一次擷取多個匯總，請以逗號分隔它們。 如果未指定任何匯總，則會使用計量的預設匯總。

--app -a

Application Insights 元件的 GUID、應用程式名稱或完整 Azure 資源名稱。 您可以從 Azure 入口網站中任何 Application Insights 資源上的 API 存取功能表項取得應用程式 GUID。 如果使用應用程式名稱，請指定資源群組。

--end-time

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

--filter

用來篩選結果的表達式。 此值應該是有效的 OData 篩選表達式，其中每個子句的索引鍵應該是您所擷取計量的適用維度。

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--interval

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

--offset

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

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

預設值: 1h

--orderby

排序區段的聚合函數和方向。 只有在指定區段時，這個值才有效。

--resource-group -g

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

--segment

要分割計量值所依據的維度名稱。 此維度必須適用於您正在擷取的計量。 若要一次分割多個維度，請以逗號 （，， ） 分隔它們。 在此情況下，計量數據會依維度列在 參數中的順序進行區隔。

--start-time

要擷取數據的時間範圍開始時間。 格式：date（yyyy-mm-dd） time （hh：mm：ss.xxxxx） timezone （+/-hh：mm）。

--subscription

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

--top

要傳回的區段數目。 只有在指定區段時，這個值才有效。

全域參數

--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。