Azure Monitor 中的诊断设置

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

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

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>"
    }
  }
}

若要使用 Azure Monitor REST API 创建或编辑诊断设置，请参阅 诊断设置 - 创建或更新。