建立 Log Analytics 工作區

Log Analytics 工作區是一個資料儲存庫，用來收集你所有 Azure 及非 Azure 資源和應用程式中任何類型的日誌資料。除非特定業務需求需要多個工作區，否則將所有日誌資料傳送到一個Log Analytics工作區，詳見設計Log Analytics工作區架構。

必要條件

若要建立 Log Analytics 工作區，您需要具有作用中訂用帳戶的 Azure 帳戶。免費註冊帳號。

需要的權限

您需要對要建立 Log Analytics 工作區所在的資源群組具備 Microsoft.OperationalInsights/workspaces/write 權限，例如由 Log Analytics 參與者內建角色提供的權限。

建立工作區

使用 Azure 入口網站、PowerShell、Azure CLI、Bicep 檔案或 Resource Manager 範本建立 Log Analytics 工作空間。選擇你想用的方法分頁。

在 Azure 入口網站的 Log Analytics workspaces 選單中建立工作區。

在 Azure 入口網站的搜尋方塊中輸入 Log Analytics。當您開始輸入時，清單會根據您的輸入進行篩選。選取 Log Analytics 工作區。
選取 ，創建。
從下拉式清單中選取訂用帳戶。
使用現有的資源群組或建立新群組。
為新的 [Log Analytics 工作區] 提供名稱，例如 DefaultLAWorkspace。此名稱對於每個資源群組必須是唯一的。
選取可用的 [區域]。如需詳細資訊，請查看 Log Analytics 的可用區域。在 [搜尋產品] 方塊中搜尋 Azure 監視器。
選取 [檢閱 + 建立] 來檢閱設定。然後，選取 [建立] 來建立工作區。預設採用隨用付費的收費模式，且在資料收集開始前不會產生任何費用。欲了解更多價格層級資訊，請參閱 Log Analytics 價格詳情。

下列範例指令碼建立不含資料來源設定的工作區。

$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 先前稱為 Operational Insights。 PowerShell Cmdlet 會在 Log Analytics 命令中使用 Operational Insights。

建立工作區後，用 PowerShell 在 Azure 監視器中配置一個Log Analytics工作區。

執行 az group create 命令以建立資源群組，或使用現有的資源群組。若要建立工作區，請使用 az monitor log-analytics workspace create 命令。以下指令對每個指令使用單行表單，因此可在任何 shell 中執行，包括 PowerShell 及預設Windows Cloud Shell：

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

要確認工作區已被建立，請執行 az monitor、log-analytics、workspace show 指令。該工作區也會出現在 Azure 入口網站的 Log Analytics 工作區清單中。

az monitor log-analytics workspace show --resource-group myGroup --workspace-name myWorkspace

如需 Azure CLI 中 Azure 監視器記錄的詳細資訊，請參閱在 Azure CLI 中管理 Azure 監視器記錄。

下列範例會使用 Microsoft.OperationalInsights 工作區，在 Azure 監視器中建立 Log Analytics 工作區。如需 Bicep 的詳細資訊，請參閱 Bicep 概觀。

附註

如需 Azure 監視器的可用範例清單，以及在 Azure 訂用帳戶中的部署指引，請參閱 Azure Resource Manager 範例。

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. Remove this parameter if you use the Free pricing tier.')
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 = 30

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

參數檔案

using './main.bicep'

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

下列範例會使用 Microsoft.OperationalInsights 工作區範本，在 Azure 監視器中建立 Log Analytics 工作區。如需 Azure Resource Manager 範本的詳細資訊，請參閱 Azure Resource Manager 範本。

附註

如需 Azure 監視器的可用範例清單，以及在 Azure 訂用帳戶中的部署指引，請參閱 Azure Resource Manager 範例。

範本檔案

{
  "$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. Remove this parameter if you use the Free pricing tier."
      }
    },
    "resourcePermissions": {
      "type": "bool",
      "metadata": {
        "description": "true to use resource or workspace permissions. false to require workspace permissions."
      }
    },
    "heartbeatTableRetention": {
      "type": "int",
      "defaultValue": 30,
      "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": [
        "[resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspaceName'))]"
      ]
    }
  ]
}

參數檔案

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-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. 永久刪除您的工作區。
3. 使用相同工作區名稱建立新的工作區。

現在工作區已經可用，請設定監控遙測資料的集合，並執行日誌搜尋以分析這些資料。若要深入了解：

請參閱在 Azure 監視器中監視 Log Analytics 工作區的健康狀況，以建立監視工作區健康狀況的警示規則。
請參見 Collect Azure resource logs，透過診斷設定啟用Azure資源的資料收集。

意見反應

此頁面對您有幫助嗎？

Last updated on 2026-08-13