az monitor app-insights metrics

注意

此參考是 Azure CLI 應用程式深入解析延伸模組的一部分(2.55.0 版或更高版本)。 擴充功能會在您第一次執行 az monitor app-insights metrics 命令時自動安裝。 深入了解擴充功能。

從應用程式擷取計量。

命令

名稱 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 來取得完整偵錯記錄。