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

az datadog tag-rule

注意

此参考是 Azure CLI(版本 2.17.0 或更高版本)的 datadog 扩展的一部分。 该扩展将在首次运行 az datadog tag-rule 命令时自动安装。 详细了解扩展。

使用 datadog 管理标记规则。

命令

名称 说明 类型 状态
az datadog tag-rule create

为给定的监视器资源创建标记规则集。

扩展 GA
az datadog tag-rule list

列出给定监视资源的标记规则。

扩展 GA
az datadog tag-rule show

获取给定监视器资源的标记规则集。

扩展 GA
az datadog tag-rule update

更新给定监视器资源的标记规则集。

扩展 GA

az datadog tag-rule create

为给定的监视器资源创建标记规则集。

az datadog tag-rule create --monitor-name
                           --resource-group
                           --rule-set-name
                           [--filtering-tags]
                           [--log-rules-filtering-tags]
                           [--send-aad-logs {false, true}]
                           [--send-resource-logs {false, true}]
                           [--send-subscription-logs {false, true}]

示例

TagRules_CreateOrUpdate

az datadog tag-rule create --monitor-name "myMonitor" --log-rules-filtering-tags name="Environment" action="Include" value="Prod" --log-rules-filtering-tags name="Environment" action="Exclude" value="Dev" --send-aad-logs false --send-resource-logs true --send-subscription-logs true --resource-group "myResourceGroup" --rule-set-name "default"

必需参数

--monitor-name

监视资源名称。

--resource-group -g

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

--rule-set-name

规则集名称。

可选参数

--filtering-tags

用于捕获指标的筛选标记列表。 如果为空,将捕获所有资源。 如果仅指定了“排除”操作,规则将应用于所有可用资源的列表。 如果指定了 Include 操作,规则将仅包含具有关联标记的资源。

用法:--filtering-tags name=XX value=XX action=XX

name:标记的名称(也称为键)。 value:标记的值。 操作:筛选标记的有效操作。 排除优先于包含。

可以使用多个 --filtering-tags 参数指定多个操作。

--log-rules-filtering-tags

用于捕获日志的筛选标记列表。 这仅在启用 SendResourceLogs 标志时才生效。 如果为空,将捕获所有资源。 如果仅指定了“排除”操作,规则将应用于所有可用资源的列表。 如果指定了 Include 操作,规则将仅包含具有关联标记的资源。

用法:--log-rules-filtering-tags name=XX value=XX action=XX

name:标记的名称(也称为键)。 value:标记的值。 操作:筛选标记的有效操作。 排除优先于包含。

可以使用多个 --log-rules-filtering-tags 参数来指定多个操作。

--send-aad-logs

指定是否应为监视器资源发送 AAD 日志的标志。

接受的值: false, true
--send-resource-logs

指定是否应为 Monitor 资源发送 Azure 资源日志的标志。

接受的值: false, true
--send-subscription-logs

指定是否应为 Monitor 资源发送 Azure 订阅日志的标志。

接受的值: false, true
全局参数
--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 datadog tag-rule list

列出给定监视资源的标记规则。

az datadog tag-rule list --monitor-name
                         --resource-group

示例

TagRules_List

az datadog tag-rule list --monitor-name "myMonitor" --resource-group "myResourceGroup"

必需参数

--monitor-name

监视资源名称。

--resource-group -g

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

全局参数
--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 datadog tag-rule show

获取给定监视器资源的标记规则集。

az datadog tag-rule show [--ids]
                         [--monitor-name]
                         [--resource-group]
                         [--rule-set-name]
                         [--subscription]

示例

TagRules_Get

az datadog tag-rule show --monitor-name "myMonitor" --resource-group "myResourceGroup" --rule-set-name "default"

可选参数

--ids

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

--monitor-name

监视资源名称。

--resource-group -g

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

--rule-set-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 datadog tag-rule update

更新给定监视器资源的标记规则集。

az datadog tag-rule update [--add]
                           [--filtering-tags]
                           [--force-string]
                           [--ids]
                           [--log-rules-filtering-tags]
                           [--monitor-name]
                           [--remove]
                           [--resource-group]
                           [--rule-set-name]
                           [--send-aad-logs {false, true}]
                           [--send-resource-logs {false, true}]
                           [--send-subscription-logs {false, true}]
                           [--set]
                           [--subscription]

可选参数

--add

通过指定路径和键值对将对象添加到对象列表。 示例:--add property.listProperty <key=value, string or JSON string>

默认值: []
--filtering-tags

用于捕获指标的筛选标记列表。 如果为空,将捕获所有资源。 如果仅指定了“排除”操作,规则将应用于所有可用资源的列表。 如果指定了 Include 操作,规则将仅包含具有关联标记的资源。

用法:--filtering-tags name=XX value=XX action=XX

name:标记的名称(也称为键)。 value:标记的值。 操作:筛选标记的有效操作。 排除优先于包含。

可以使用多个 --filtering-tags 参数指定多个操作。

--force-string

使用“set”或“add”时,保留字符串文本,而不是尝试转换为 JSON。

默认值: False
--ids

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

--log-rules-filtering-tags

用于捕获日志的筛选标记列表。 这仅在启用 SendResourceLogs 标志时才生效。 如果为空,将捕获所有资源。 如果仅指定了“排除”操作,规则将应用于所有可用资源的列表。 如果指定了 Include 操作,规则将仅包含具有关联标记的资源。

用法:--log-rules-filtering-tags name=XX value=XX action=XX

name:标记的名称(也称为键)。 value:标记的值。 操作:筛选标记的有效操作。 排除优先于包含。

可以使用多个 --log-rules-filtering-tags 参数来指定多个操作。

--monitor-name

监视资源名称。

--remove

从列表中删除属性或元素。 示例: --remove property.list <indexToRemove> OR --remove propertyToRemove.

默认值: []
--resource-group -g

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

--rule-set-name

规则集名称。

--send-aad-logs

指定是否应为监视器资源发送 AAD 日志的标志。

接受的值: false, true
--send-resource-logs

指定是否应为 Monitor 资源发送 Azure 资源日志的标志。

接受的值: false, true
--send-subscription-logs

指定是否应为 Monitor 资源发送 Azure 订阅日志的标志。

接受的值: false, true
--set

通过指定要设置的属性路径和值来更新对象。 示例:--set property1.property2=<value>

默认值: []
--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 获取完整的调试日志。