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

创建 Log Analytics 工作区

本文介绍如何创建 Log Analytics 工作区。 收集日志和数据时，信息将存储在工作区中。 工作区具有唯一的工作区 ID 和资源 ID。 给定资源组的工作区名称必须唯一。 创建工作区后，请配置数据源和解决方案以在其中存储数据。

要收集来自以下源的数据，需要 Log Analytics 工作区：

• 订阅中的 Azure 资源。
• 受 System Center Operations Manager 监视的本地计算机。
• Configuration Manager 中的设备集合。
• Azure 存储中的诊断或日志数据。

先决条件

要创建 Log Analytics 工作区，需要有含活动订阅的 Azure 帐户。 你可以免费创建一个帐户。

所需的权限

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

创建工作区

Portal

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

1. 在 Azure 门户的搜索框中输入“Log Analytics”。 开始键入时，会根据输入筛选该列表。 选择“Log Analytics 工作区”。

   

2. 选择“添加” 。

3. 从下拉列表中选择一个订阅。

4. 使用现有的资源组，或创建一个新的资源组。

5. 为新的 Log Analytics 工作区提供名称，如 DefaultLAWorkspace。 对于每个资源组，该名称必须是唯一的。

6. 选择可用区域。 有关详细信息，请参阅提供 Log Analytics 的区域。 在“搜索产品”框中搜索 Azure Monitor。

   

7. 选择“查看 + 创建”以查看设置。 然后选择“创建”以创建工作区。 将应用一个默认的“即用即付”定价层。 在开始收集足够的数据之前不会产生费用。 若要详细了解其他定价层，请参阅 Log Analytics 定价详细信息。

PowerShell

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

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

# 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 以前称为“操作见解”。 PowerShell cmdlet 在 Log Analytics 命令中使用操作见解。

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

Azure CLI

运行 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 日志。

Bicep

以下示例使用 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 = 'eastus'
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": "eastus"
    },
    "resourcePermissions": {
      "value": true
    },
    "heartbeatTableRetention": {
      "value": 30
    }
  }
}

故障排除

如果创建了一个工作区，该工作区已在过去 14 天内删除且处于软删除状态，那么该操作可能会有不同的结果，具体取决于你的工作区配置：

1. 如果你提供的工作区名称、资源组、订阅和区域与已删除的工作区中的相同，则将恢复你的工作区，包括其数据、配置和连接的代理。

2. 资源组的工作区名称必须唯一。 如果使用已存在的或已软删除的工作区名称，则会返回错误。 若要永久删除已软删除的工作区名称，并创建一个同名的新工作区，请按以下步骤操作：

   1. 恢复工作区。
   2. 永久删除工作区。
   3. 使用相同的工作区名称创建新的工作区。

后续步骤

现在，你已有可用的工作区，可以配置监视遥测收集、运行日志搜索分析该数据，以及添加管理解决方案以提供更多数据和分析见解。 若要了解详细信息，请访问以下链接：

• 请参阅在 Azure Monitor 中监视 Log Analytics 工作区的运行状况创建用于监视工作区运行状况的警报规则。
• 请参阅收集要在 Log Analytics 中使用的 Azure 服务日志和指标启用通过 Azure 诊断或 Azure 存储从 Azure 资源收集数据。