Azure Monitor中的诊断设置

使用以下步骤创建新的诊断设置或编辑Azure门户中的现有诊断设置：

1. 在资源的菜单中的 “监视 ”部分，选择“ 诊断设置”。 或者，在“Azure Monitor”菜单上，选择Settings>Diagnostic settings。 然后选择资源。

2. 选择 “添加诊断设置 ”以添加新设置，或选择 “编辑”设置 以编辑现有设置。

   如果要发送到同一类型的多个目标，可能需要为资源设置多个诊断设置。 以下示例显示了钥匙库资源的配置，但界面与其他资源类似。

   

3. 为设置指定说明性名称（如果未指定）。

   

   此屏幕截图显示了一个示例密钥保管库。 其他类型的资源具有不同的类别集。

4. 对于 日志，请选择 类别组 ，或选择要发送到目标的每个类别数据的单个复选框。 类别列表因每个Azure服务而异。

5. 对于 指标，如果要收集平台指标，请选择 AllMetrics 。

6. 对于 目标详细信息，请选中要包含在诊断设置中的每个目标的复选框。 然后提供每个目标的详细信息。

   如果选择Log Analytics工作区作为目标，则可能需要指定收集模式。 有关详细信息，请参阅 收集模式。

使用 New-AzDiagnosticSetting cmdlet 通过 Azure PowerShell 创建诊断设置。 有关参数的说明，请参阅此 cmdlet 的文档。

以下示例 PowerShell 脚本创建诊断设置，用于将密钥保管库的所有日志和指标发送到Log Analytics工作区：

$KV = Get-AzKeyVault -ResourceGroupName <resource group name> -VaultName <key vault name>
$Law = Get-AzOperationalInsightsWorkspace -ResourceGroupName <resource group name> -Name <workspace name>  # LAW name is case sensitive

$metric = New-AzDiagnosticSettingMetricSettingsObject -Enabled $true -Category AllMetrics
$log = New-AzDiagnosticSettingLogSettingsObject -Enabled $true -CategoryGroup allLogs  # use audit for only audit logs
New-AzDiagnosticSetting -Name 'KeyVault-Diagnostics' -ResourceId $KV.ResourceId -WorkspaceId $Law.ResourceId -Log $log -Metric $metric -Verbose

使用 az monitor diagnostic-settings create 命令通过 Azure CLI 创建诊断设置。 有关参数的说明，请参阅此命令的文档。

以下示例脚本创建一个诊断设置，用于将数据发送到所有三个目标。 若要指定服务支持的资源特定模式，请添加export-to-resource-specific参数，并设置其值为true。

az monitor diagnostic-settings create  \
--name KeyVault-Diagnostics \
--resource /subscriptions/<subscription ID>/resourceGroups/<resource group name>/providers/Microsoft.KeyVault/vaults/mykeyvault \
--logs    '[{"category": "AuditEvent","enabled": true}]' \
--metrics '[{"category": "AllMetrics","enabled": true}]' \
--storage-account /subscriptions/<subscription ID>/resourceGroups/<resource group name>/providers/Microsoft.Storage/storageAccounts/<storage account name> \
--workspace /subscriptions/<subscription ID>/resourcegroups/<resource group name>/providers/microsoft.operationalinsights/workspaces/<log analytics workspace name> \
--event-hub-rule /subscriptions/<subscription ID>/resourceGroups/<resource group name>/providers/Microsoft.EventHub/namespaces/<event hub namespace>/authorizationrules/RootManageSharedAccessKey \
--event-hub <event hub name> \
--export-to-resource-specific true

以下示例模板创建一个诊断设置，用于将所有审核日志发送到Log Analytics工作区。 该值 apiVersion 可能会根据作用域中的资源而更改。 有关其他资源的示例模板，请参阅资源管理器模板示例，了解 Azure Monitor 中的诊断设置。

模板文件

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "scope": {
            "type": "string"
        },
        "workspaceId": {
            "type": "string"
        },
        "settingName": {
            "type": "string"
        }
    },
    "resources": [
        {
            "type": "Microsoft.Insights/diagnosticSettings",
            "apiVersion": "2021-05-01-preview",
            "scope": "[parameters('scope')]",
            "name": "[parameters('settingName')]",
            "properties": {
                "workspaceId": "[parameters('workspaceId')]",
                "logs": [
                    {
                        "category": null,
                        "categoryGroup": "audit",
                        "enabled": true
                    }
                ]
            }
        }
    ]
}

参数文件

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "settingName": {
            "value": "audit3"
        },
        "workspaceId": {
            "value": "/subscriptions/<subscription id>/resourcegroups/<resourcegroup name>/providers/microsoft.operationalinsights/workspaces/<workspace name>"
        },
        "scope": {
            "value": "Microsoft.<resource type>/<resourceName>"
        }
    }
}

以下示例模板创建一个诊断设置，用于将所有审核日志发送到Log Analytics工作区。 该值 apiVersion 可能会根据作用域中的资源而更改。

模板文件

param scope string
param workspaceId string
param settingName string

resource diag 'Microsoft.Insights/diagnosticSettings@2021-05-01-preview' = {
    name: settingName
    scope: scope
    properties: {
      workspaceId: workspaceId
      logs: [
          {
              category: null
              categoryGroup: 'audit'
              enabled: true
          }
      ]
    }
}

参数文件

using './<template-file-name>.bicep'

param settingName = 'audit3'

param workspaceId = '/subscriptions/<subscription id>/resourcegroups/<resourcegroup name>/providers/microsoft.operationalinsights/workspaces/<workspace name>'

param scope = 'Microsoft.<resource type>/<resourceName>

若要使用 Azure Monitor REST API 创建或编辑诊断设置，请参阅 Diagnostic Settings - Create or Update。