通过 Azure 监视代理选项配置代理

本文介绍如何在Azure 虚拟机（VM）、虚拟机规模集和启用Azure Arc的服务器上配置Azure Monitor代理。许多应用程序和服务使用 Azure Monitor 代理记录遥测数据。可以使用中央控制平面和创建代理设置数据收集规则（DCR）来配置Azure Monitor代理。

先决条件

在使用 Azure Monitor 从虚拟机客户端收集数据中列出了先决条件。

注意事项

当您处理代理设置 DCR 时：

目前，Azure 资源管理器模板是创建代理设置的唯一方法。
代理设置是一个独立的 DCR，没有其他收集源。
应用于 VM 的最新代理设置 DCR 将替代所有其他代理设置 DCR。

支持的参数

代理设置 DCR 支持以下参数：

这些设置用于配置 Azure Monitor 代理，并按遥测类型进行分类。在 DCR JSON 中，将每个设置添加到 properties.agentSettings.logs 或 properties.agentSettings.metrics 集合，如下表所示。

遥测类型	代理设置集合	设置名称	支持的值和验证	Description
概况	`logs`	`MaxDiskQuotaInMB`	从 4,000 到 1,000,000 的整数。默认值为 10,000 MB。	Azure Monitor代理本地缓存使用的最大磁盘空间。如果云连接丢失，并且代理在还原连接后发送数据，则缓存会增大。代理会丢失超出缓存限制的数据。
Logs	`logs`	`UseTimeReceivedForForwardedEvents`	`0` 或 `1`。 `0` 使用 `TimeGenerated`；`1` 使用 `TimeReceived`。	控制Microsoft Sentinel Windows事件转发（WEF）数据的时间戳行为。
概况	`logs`	`Tags`	任何非空字符串。该服务不会验证格式或分隔符。	与代理配置关联的用户定义的标记。
概况	`logs`	`DiskQuotaUsageInPercent`	从 50 到 100 的整数。	用于控制代理配额行为的已配置磁盘配额百分比。
日志和追踪	`logs`	`OtlpGrpcLogsTracesPort`	从 1,024 到 65,535 的整数 TCP 端口。在 DCR 的所有 OTLP 端口设置中必须是唯一的。	覆盖用于日志和跟踪的 OTLP gRPC 监听端口。
日志和追踪	`logs`	`OtlpHttpProtobufLogsTracesPort`	从 1,024 到 65,535 的整数 TCP 端口。在 DCR 的所有 OTLP 端口设置中必须是唯一的。	替代日志和跟踪的 OTLP HTTP/Protobuf 侦听器端口。
Metrics	`metrics`	`OtlpGrpcMetricsPort`	从 1,024 到 65,535 的整数 TCP 端口。在 DCR 的所有 OTLP 端口设置中必须是唯一的。	覆盖用于指标的 OTLP gRPC 监听端口。
Metrics	`metrics`	`OtlpHttpProtobufMetricsPort`	从 1,024 到 65,535 的整数 TCP 端口。在 DCR 的所有 OTLP 端口设置中必须是唯一的。	覆盖用于指标的 OTLP HTTP/Protobuf 监听端口。
Metrics	`metrics`	`OtlpGrpcPrometheusMetricsPort`	从 1,024 到 65,535 的整数 TCP 端口。在 DCR 的所有 OTLP 端口设置中必须是唯一的。	覆盖用于 Prometheus 指标的 OTLP gRPC 监听器端口。

注释

OTLP 端口设置需要 DCR API 版本 2025-05-11 或更高版本。 OTLP 指标端口设置要求 Azure Monitor 代理为 Linux 1.44、Windows 1.45 或更高版本。

创建代理设置 DCR

当前不支持。

通过在 VM 上安装 Azure Monitor 代理来准备环境。
创建代理设置 DCR。

以下示例显示了 logs 和 metrics 类别中的设置，包括对所有 OTLP 侦听器端口的覆盖设置。

步骤 1 - 使用搜索栏查找 “部署自定义模板 ”选项。

显示 Azure 门户中搜索栏内自定义模板的截图。

步骤 2 - 在编辑器中选择“生成自己的模板”。

此截图展示了如何在 Azure 门户中打开模板编辑器。

步骤 3 - 删除模板编辑器中的现有 JSON，并将 JSON 代码复制到编辑器中。请确保在编辑器中修改 JSON 中的参数以满足需求。

下面是用于创建代理设置 DCR 的示例 JSON 代码：

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "region": {
            "defaultValue": "chinanorth2",
            "type": "string"
        },
        "dcrName": {
            "defaultValue": "myDcrName",
            "type": "string"
        },
        "maxDiskQuota": {
            "defaultValue": "5000",
            "type": "string"
        },
        "useTimeReceivedForForwardedEvents": {
            "defaultValue": "0",
            "type": "string"
        },
        "tags": {
            "defaultValue": "environment=production",
            "type": "string"
        },
        "diskQuotaUsageInPercent": {
            "defaultValue": "80",
            "type": "string"
        },
        "otlpGrpcLogsTracesPort": {
            "defaultValue": "14319",
            "type": "string"
        },
        "otlpHttpProtobufLogsTracesPort": {
            "defaultValue": "14320",
            "type": "string"
        },
        "otlpGrpcMetricsPort": {
            "defaultValue": "15317",
            "type": "string"
        },
        "otlpHttpProtobufMetricsPort": {
            "defaultValue": "15318",
            "type": "string"
        },
        "otlpGrpcPrometheusMetricsPort": {
            "defaultValue": "15316",
            "type": "string"
        }
    },
    "resources": [

        {
            "type": "Microsoft.Insights/dataCollectionRules",
            "kind": "AgentSettings",
            "location": "[parameters('region')]",
            "name": "[parameters('dcrName')]",
            "apiVersion": "2025-05-11",
            "properties": {
                "description": "Simple agent settings",
                "agentSettings": {
                    "logs": [
                        {
                            "name": "MaxDiskQuotaInMB",
                            "value": "[parameters('maxDiskQuota')]"
                        },
                        {
                            "name": "UseTimeReceivedForForwardedEvents",
                            "value": "[parameters('useTimeReceivedForForwardedEvents')]"
                        },
                        {
                            "name": "Tags",
                            "value": "[parameters('tags')]"
                        },
                        {
                            "name": "DiskQuotaUsageInPercent",
                            "value": "[parameters('diskQuotaUsageInPercent')]"
                        },
                        {
                            "name": "OtlpGrpcLogsTracesPort",
                            "value": "[parameters('otlpGrpcLogsTracesPort')]"
                        },
                        {
                            "name": "OtlpHttpProtobufLogsTracesPort",
                            "value": "[parameters('otlpHttpProtobufLogsTracesPort')]"
                        }
                    ],
                    "metrics": [
                        {
                            "name": "OtlpGrpcMetricsPort",
                            "value": "[parameters('otlpGrpcMetricsPort')]"
                        },
                        {
                            "name": "OtlpHttpProtobufMetricsPort",
                            "value": "[parameters('otlpHttpProtobufMetricsPort')]"
                        },
                        {
                            "name": "OtlpGrpcPrometheusMetricsPort",
                            "value": "[parameters('otlpGrpcPrometheusMetricsPort')]"
                        }
                    ]
                }
            }
        }
    ]
}

验证并部署模板。请确保不会发生任何错误。

步骤 4 - 将 DCR 与虚拟机关联，转到“在编辑器”选项 中再次部署自定义模板 。删除模板编辑器中的现有 JSON，并将 JSON 代码复制到编辑器中。要与 VM 名称和 DCR 资源保持一致，请确保在参数部分修改相关项。可以通过转到 DCR 并选择右上角的 JSON 视图来复制资源 ID。使用 “复制到剪贴板 ”选项，然后将其粘贴到模板中。对于vmName，请使用 VM 的字符串名。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "vmName": {
      "type": "string",
      "defaultValue":"WindowsM1",
      "metadata": {
        "description": "The name of the virtual machine."
      }
    },
    "dataCollectionResourceId": {
      "type": "string",
      "defaultValue": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/ContosoAdmin/providers/Microsoft.Insights/dataCollectionRules/myDcrName",
      "metadata": {
        "description": "The resource ID of the data collection rule."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Insights/dataCollectionRuleAssociations",
      "apiVersion": "2021-09-01-preview",
      "scope": "[format('Microsoft.Compute/virtualMachines/{0}', parameters('vmResourceId'))]",
      "name": "agentSettings",
      "properties": {
        "description": "Association of data collection rule. Deleting this association will break the data collection for this virtual machine."
        "dataCollectionRuleId": "[parameters('dataCollectionResourceId')]"
      }
    }
  ]
}

验证并部署模板。请确保不会出现任何错误。

步骤 5 - 应用更改并在 VM 上重启 AMA。

创建数据收集规则从代理收集数据并将其发送到Azure Monitor。

上次更新時間： 2026-10-10

通过 Azure 监视代理选项配置代理

先决条件

注意事项

支持的参数

创建代理设置 DCR

相关内容

其他資源