你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az monitor app-insights component

注意

此参考是 Azure CLI（版本 2.55.0 或更高版本）的 application-insights 扩展的一部分。 该扩展将在首次运行 az monitor app-insights 组件 命令时自动安装。 详细了解扩展。

管理 Application Insights 组件或其子组件。

命令

名称	说明	类型	状态
az monitor app-insights component billing	管理 Application Insights 组件计费功能。	扩展	GA
az monitor app-insights component billing show	显示 Application Insights 资源的计费功能。	扩展	GA
az monitor app-insights component billing update	更新 Application Insights 资源的计费功能。	扩展	GA
az monitor app-insights component connect-function	将 AI 连接到 Azure 函数。	扩展	GA
az monitor app-insights component connect-webapp	将 AI 连接到 Web 应用。	扩展	GA
az monitor app-insights component continues-export	管理 Application Insights 组件的连续导出配置。	扩展	GA
az monitor app-insights component continues-export create	为 Application Insights 组件创建连续导出配置。	扩展	GA
az monitor app-insights component continues-export delete	删除 Application Insights 组件的特定连续导出配置。	扩展	GA
az monitor app-insights component continues-export list	列出 Application Insights 组件的连续导出配置列表。	扩展	GA
az monitor app-insights component continues-export show	获取此导出 ID 的连续导出配置。	扩展	GA
az monitor app-insights component continues-export update	更新 Application Insights 组件的连续导出配置。	扩展	GA
az monitor app-insights component create	新建 Application Insights 资源。	扩展	GA
az monitor app-insights component delete	删除新的 Application Insights 资源。	扩展	GA
az monitor app-insights component favorite	管理组件收藏夹。	扩展	GA
az monitor app-insights component favorite create	创建 Application Insights 组件的新收藏夹。	扩展	GA
az monitor app-insights component favorite delete	删除与 Application Insights 组件关联的收藏夹。	扩展	GA
az monitor app-insights component favorite list	列出 Application Insights 组件中定义的收藏夹列表。	扩展	GA
az monitor app-insights component favorite show	通过 Application Insights 组件中定义的 FavoriteId 获取单个收藏夹。	扩展	GA
az monitor app-insights component favorite update	将新收藏夹更新到 Application Insights 组件。	扩展	GA
az monitor app-insights component linked-storage	管理 Application Insights 组件的链接存储帐户。	扩展	GA
az monitor app-insights component linked-storage link	将存储帐户与 Application Insights 组件链接。	扩展	GA
az monitor app-insights component linked-storage show	获取 Application Insights 组件的当前链接存储设置。	扩展	GA
az monitor app-insights component linked-storage unlink	将存储帐户与 Application Insights 组件取消链接。	扩展	GA
az monitor app-insights component linked-storage update	更新 Application Insights 组件的当前链接存储帐户。	扩展	GA
az monitor app-insights component quotastatus	管理组件配额统计信息。	扩展	GA
az monitor app-insights component quotastatus show	显示 Application Insights 组件的每日数据量上限（配额）状态。	扩展	GA
az monitor app-insights component show	获取 Application Insights 资源。	扩展	GA
az monitor app-insights component update	更新现有 Application Insights 资源的属性。 可以更新的主要值是类型，用于自定义 UI 体验。	扩展	GA
az monitor app-insights component update-tags	更新现有 Application Insights 资源的标记。	扩展	GA

az monitor app-insights component connect-function

将 AI 连接到 Azure 函数。

az monitor app-insights component connect-function --function
                                                   [--app]
                                                   [--ids]
                                                   [--resource-group]
                                                   [--subscription]

示例

将 AI 连接到 Azure 函数。

az monitor app-insights component connect-function -g myRG -a myAI --function myFunction

使用资源 ID 将 AI 连接到 Azure 函数。

az monitor app-insights component connect-function -g myRG -a myAI --function /subscriptions/mySub/resourceGroups/myRG/providers/Microsoft.Web/sites/myFunction

必需参数

--function

Azure 函数的名称或资源 ID。

可选参数

--app -a

Application Insights 组件的 GUID、应用名称或完全限定的 Azure 资源名称。 可以从Azure 门户中任何 Application Insights 资源上的 API 访问菜单项获取应用程序 GUID。 如果使用应用程序名称，请指定资源组。

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az monitor app-insights component connect-webapp

将 AI 连接到 Web 应用。

az monitor app-insights component connect-webapp --web-app
                                                 [--app]
                                                 [--enable-debugger {false, true}]
                                                 [--enable-profiler {false, true}]
                                                 [--ids]
                                                 [--resource-group]
                                                 [--subscription]

示例

将 AI 连接 Web 应用，并为 Web 应用启用探查器和快照调试器。

az monitor app-insights component connect-webapp -g myRG -a myAI --web-app myApp --enable-profiler --enable-snapshot-debugger

使用资源 ID 将 AI 连接 Web 应用，并启用探查器，并为 Web 应用禁用快照调试器。

az monitor app-insights component connect-webapp -g myRG -a myAI --web-app /subscriptions/mySub/resourceGroups/myRG/providers/Microsoft.Web/sites/myApp --enable-profiler --enable-snapshot-debugger false

必需参数

--web-app

Web 应用的名称或资源 ID。

可选参数

--app -a

Application Insights 组件的 GUID、应用名称或完全限定的 Azure 资源名称。 可以从Azure 门户中任何 Application Insights 资源上的 API 访问菜单项获取应用程序 GUID。 如果使用应用程序名称，请指定资源组。

--enable-debugger --enable-snapshot-debugger

引发异常时启用快照调试器。 目前，它仅支持 .NET/.NET Core Web 应用。

接受的值: false, true

--enable-profiler

启用收集分析跟踪，以帮助查看代码中花费的时间。 目前，它仅支持 .NET/.NET Core Web 应用。

接受的值: false, true

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az monitor app-insights component create

新建 Application Insights 资源。

az monitor app-insights component create --app
                                         --location
                                         --resource-group
                                         [--application-type]
                                         [--ingestion-access {Disabled, Enabled}]
                                         [--kind]
                                         [--query-access {Disabled, Enabled}]
                                         [--retention-time]
                                         [--tags]
                                         [--workspace]

示例

创建具有类型 Web 和位置的组件。

az monitor app-insights component create --app demoApp --location westus2 --kind web -g demoRg --application-type web --retention-time 120

必需参数

--app -a

Application Insights 组件的 GUID、应用名称或完全限定的 Azure 资源名称。 可以从Azure 门户中任何 Application Insights 资源上的 API 访问菜单项获取应用程序 GUID。 如果使用应用程序名称，请指定资源组。

--location -l

位置。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--application-type

正在监视的应用程序的类型。 可能的值包括“web”、“other”。 默认值为“web”。

默认值: web

--ingestion-access

用于访问 Application Insights 引入的公共网络访问类型。

接受的值: Disabled, Enabled

--kind -k

此组件引用的应用程序类型，用于自定义 UI。 此值是一个任意多边形字符串，值通常应为 Web、ios、其他、存储、java、phone 之一。

默认值: web

--query-access

用于访问 Application Insights 查询的公共网络访问类型。

接受的值: Disabled, Enabled

--retention-time

Application Insights 保留天数。 该值可以是下列值之一：30,60,90,120,180,270,365,550,730。 仅当 Application Insights 未连接到 Log Analytics 工作区时，才能设置它。

--tags

空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。

--workspace

Log Analytics 工作区的名称或资源 ID。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az monitor app-insights component delete

删除新的 Application Insights 资源。

az monitor app-insights component delete [--app]
                                         [--ids]
                                         [--resource-group]
                                         [--subscription]

示例

删除具有类型 Web 和位置的组件。

az monitor app-insights component delete --app demoApp -g demoRg

可选参数

--app -a

Application Insights 组件的 GUID、应用名称或完全限定的 Azure 资源名称。 可以从Azure 门户中任何 Application Insights 资源上的 API 访问菜单项获取应用程序 GUID。 如果使用应用程序名称，请指定资源组。

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az monitor app-insights component show

获取 Application Insights 资源。

az monitor app-insights component show [--app]
                                       [--ids]
                                       [--resource-group]
                                       [--subscription]

示例

按名称获取组件。

az monitor app-insights component show --app demoApp -g demoRg

列出资源组中的组件。

az monitor app-insights component show -g demoRg

列出当前所选订阅中的组件。

az monitor app-insights component show

可选参数

--app -a

Application Insights 组件的 GUID、应用名称或完全限定的 Azure 资源名称。 可以从Azure 门户中任何 Application Insights 资源上的 API 访问菜单项获取应用程序 GUID。 如果使用应用程序名称，请指定资源组。

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az monitor app-insights component update

更新现有 Application Insights 资源的属性。 可以更新的主要值是类型，用于自定义 UI 体验。

az monitor app-insights component update [--app]
                                         [--ids]
                                         [--ingestion-access {Disabled, Enabled}]
                                         [--kind]
                                         [--query-access {Disabled, Enabled}]
                                         [--resource-group]
                                         [--retention-time]
                                         [--subscription]
                                         [--workspace]

示例

使用类型 Web 更新组件。

az monitor app-insights component update --app demoApp -k web -g demoRg --retention-time 120

可选参数

--app -a

Application Insights 组件的 GUID、应用名称或完全限定的 Azure 资源名称。 可以从Azure 门户中任何 Application Insights 资源上的 API 访问菜单项获取应用程序 GUID。 如果使用应用程序名称，请指定资源组。

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--ingestion-access

用于访问 Application Insights 引入的公共网络访问类型。

接受的值: Disabled, Enabled

--kind -k

此组件引用的应用程序类型，用于自定义 UI。 此值是一个任意多边形字符串，值通常应为 Web、ios、其他、存储、java、phone 之一。

--query-access

用于访问 Application Insights 查询的公共网络访问类型。

接受的值: Disabled, Enabled

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--retention-time

Application Insights 保留天数。 该值可以是下列值之一：30,60,90,120,180,270,365,550,730。 仅当 Application Insights 未连接到 Log Analytics 工作区时，才能设置它。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--workspace

Log Analytics 工作区的名称或资源 ID。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az monitor app-insights component update-tags

更新现有 Application Insights 资源的标记。

az monitor app-insights component update-tags --tags
                                              [--app]
                                              [--ids]
                                              [--resource-group]
                                              [--subscription]

示例

将标记“name”更新为等于“value”。

az monitor app-insights component update-tags --app demoApp --tags name=value -g demoRg

必需参数

--tags

空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。

可选参数

--app -a

Application Insights 组件的 GUID、应用名称或完全限定的 Azure 资源名称。 可以从Azure 门户中任何 Application Insights 资源上的 API 访问菜单项获取应用程序 GUID。 如果使用应用程序名称，请指定资源组。

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。