创建 Log Analytics 工作区

Log Analytics工作区是用于从所有Azure和非Azure资源和应用程序收集任何类型的日志数据的数据存储。除非特定的业务需求需要多个工作区，否则将所有日志数据发送到一个Log Analytics工作区，如 Design Log Analytics 工作区体系结构中所述。

先决条件

要创建 Log Analytics 工作区，需要有含活动订阅的 Azure 帐户。创建试用帐户。

所需的权限

你需要对要在其中创建 Log Analytics 工作区的资源组具有 Microsoft.OperationalInsights/workspaces/write 权限，例如，可由 Log Analytics 参与者内置角色授予。

创建工作区

使用“Log Analytics 工作区”菜单创建工作区。

在 Azure 门户的搜索框中输入“Log Analytics”。当您开始输入时，该列表会根据您的输入进行筛选。选择 Log Analytics 工作区。
选择创建。
从下拉列表中选择订阅。
使用现有的资源组，或创建一个新的资源组。
为新的 Log Analytics 工作区提供名称，如 DefaultLAWorkspace。对于每个资源组，该名称必须是唯一的。
选择可用区域。有关详细信息，请参阅提供 Log Analytics 的区域。在“搜索产品”框中搜索 Azure Monitor。
选择“查看 + 创建”以查看设置。然后选择“创建”以创建工作区。应用默认即用即付定价层，在数据收集开始之前不会产生任何费用。有关定价层的详细信息，请参阅[Log Analytics定价详细信息]（https://www.azure.cn/pricing/。

下面的示例脚本会创建一个未配置任何数据源的工作区。

$ResourceGroup = <"my-resource-group">
$WorkspaceName = <"log-analytics-workspace-name">
$Location = <"chinaeast2">

# Create the resource group if needed
try {
    Get-AzResourceGroup -Name $ResourceGroup -ErrorAction Stop
} catch {
    New-AzResourceGroup -Name $ResourceGroup -Location $Location
}

# Create the workspace
New-AzOperationalInsightsWorkspace -Location $Location -Name $WorkspaceName -ResourceGroupName $ResourceGroup

注意

Log Analytics 此前称为 Operational Insights。 PowerShell cmdlet 使用 Log Analytics 中的 Operational Insights 命令。

创建工作区后，使用 PowerShell 在 Azure Monitor 中配置Log Analytics工作区。

运行 az group create 命令创建资源组或使用现有资源组。若要创建工作区，请使用 az monitor log-analytics workspace create 命令。

    az group create --name <myGroup> --location <myLocation>
    az monitor log-analytics workspace create --resource-group <myGroup> \
       --workspace-name <myWorkspace>

有关 Azure CLI 中的 Azure Monitor 日志的详细信息，请参阅在 Azure CLI 中管理 Azure Monitor 日志。

以下示例使用 Microsoft.OperationalInsights 工作区在 Azure Monitor 中创建 Log Analytics 工作区。有关 Bicep 的详细信息，请参阅 Bicep 概述。

注意

有关可用示例的列表以及在 Azure 订阅中部署这些示例的指南，请参阅 Azure Monitor 的 Azure 资源管理器示例。

Bicep 文件

@description('Name of the workspace.')
param workspaceName string

@description('Pricing tier: PerGB2018 or legacy tiers (Free, Standalone, PerNode, Standard or Premium) which are not available to all customers.')
@allowed([
  'pergb2018'
  'Free'
  'Standalone'
  'PerNode'
  'Standard'
  'Premium'
])
param sku string = 'pergb2018'

@description('Specifies the location for the workspace.')
param location string

@description('Number of days to retain data.')
param retentionInDays int = 120

@description('true to use resource or workspace permissions. false to require workspace permissions.')
param resourcePermissions bool

@description('Number of days to retain data in Heartbeat table.')
param heartbeatTableRetention int

resource workspace 'Microsoft.OperationalInsights/workspaces@2023-09-01' = {
  name: workspaceName
  location: location
  properties: {
    sku: {
      name: sku
    }
    retentionInDays: retentionInDays
    features: {
      enableLogAccessUsingOnlyResourcePermissions: resourcePermissions
    }
  }
}

resource workspaceName_Heartbeat 'Microsoft.OperationalInsights/workspaces/tables@2022-10-01' = {
  parent: workspace
  name: 'Heartbeat'
  properties: {
    retentionInDays: heartbeatTableRetention
  }
}

注意

如果指定免费定价层，请删除 retentionInDays 元素。

参数文件

using './main.bicep'

param workspaceName = 'MyWorkspace'
param sku = 'pergb2018'
param location = 'chinanorth2'
param retentionInDays = 120
param resourcePermissions = true
param heartbeatTableRetention = 30

以下示例使用 Microsoft.OperationalInsights 工作区模板在 Azure Monitor 中创建 Log Analytics 工作区。有关 Azure 资源管理器模板的详细信息，请参阅 Azure 资源管理器模板。

注意

有关可用示例的列表以及在 Azure 订阅中部署这些示例的指南，请参阅 Azure Monitor 的 Azure 资源管理器示例。

模板文件

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "workspaceName": {
      "type": "string",
      "metadata": {
        "description": "Name of the workspace."
      }
    },
    "sku": {
      "type": "string",
      "defaultValue": "pergb2018",
      "allowedValues": [
        "pergb2018",
        "Free",
        "Standalone",
        "PerNode",
        "Standard",
        "Premium"
      ],
      "metadata": {
        "description": "Pricing tier: PerGB2018 or legacy tiers (Free, Standalone, PerNode, Standard or Premium) which are not available to all customers."
      }
    },
    "location": {
      "type": "string",
      "metadata": {
        "description": "Specifies the location for the workspace."
      }
    },
    "retentionInDays": {
      "type": "int",
      "defaultValue": 120,
      "metadata": {
        "description": "Number of days to retain data."
      }
    },
    "resourcePermissions": {
      "type": "bool",
      "metadata": {
        "description": "true to use resource or workspace permissions. false to require workspace permissions."
      }
    },
    "heartbeatTableRetention": {
      "type": "int",
      "metadata": {
        "description": "Number of days to retain data in Heartbeat table."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.OperationalInsights/workspaces",
      "apiVersion": "2023-09-01",
      "name": "[parameters('workspaceName')]",
      "location": "[parameters('location')]",
      "properties": {
        "sku": {
          "name": "[parameters('sku')]"
        },
        "retentionInDays": "[parameters('retentionInDays')]",
        "features": {
          "enableLogAccessUsingOnlyResourcePermissions": "[parameters('resourcePermissions')]"
        }
      }
    },
    {
      "type": "Microsoft.OperationalInsights/workspaces/tables",
      "apiVersion": "2022-10-01",
      "name": "[format('{0}/{1}', parameters('workspaceName'), 'Heartbeat')]",
      "properties": {
        "retentionInDays": "[parameters('heartbeatTableRetention')]"
      },
      "dependsOn": [
        "workspace"
      ]
    }
  ]
}

注意

如果指定免费定价层，请删除 retentionInDays 元素。

参数文件

{
  "$schema": "https://schema.management.azure.com/schemas/2019-08-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "workspaceName": {
      "value": "MyWorkspace"
    },
    "sku": {
      "value": "pergb2018"
    },
    "location": {
      "value": "chinaeast2"
    },
    "resourcePermissions": {
      "value": true
    },
    "heartbeatTableRetention": {
      "value": 30
    }
  }
}

故障排除

创建在过去 14 天内删除且处于软删除状态的工作区时，操作可能会产生不同的结果，具体取决于工作区配置：

如果创建工作区和提供的参数与已删除工作区的工作区名称、资源组、订阅和区域相同，则可以恢复已删除的工作区，包括其数据、配置和连接的代理。
资源组的工作区名称必须唯一。如果使用已存在或已被软删除的工作区名称，则会报错。若要永久删除已软删除的工作区名称，并创建一个同名的新工作区，请按以下步骤操作：
1. 恢复您的工作区。
2. 永久删除您的工作区。
3. 使用相同的工作区名称创建新的工作区。

后续步骤

现在工作区可用，请配置监视遥测的集合并运行日志搜索以分析这些数据。若要了解详细信息，请访问以下链接：

请参阅在 Azure Monitor 中监视 Log Analytics 工作区的运行状况，以创建用于监视工作区运行状况的警报规则。
若要使用诊断设置从 Azure 资源收集数据，请参阅收集 Azure 资源日志。

Last updated on 2026-06-22