建立 Log Analytics 工作區

Log Analytics 工作區是一個資料存放區，您可在其中收集來自所有 Azure 和非 Azure 資源與應用程式的任何類型記錄資料。 我們建議您將所有記錄資料傳送至一個 Log Analytics 工作區，除非您有需要建立多個工作區的特定商務需求，如設計 Log Analytics 工作區架構中所述。

本文說明如何建立 Log Analytics 工作區。

必要條件

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

需要的權限

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

建立工作區

入口網站

使用 [Log Analytics 工作區] 功能表來建立工作區。

1. 在 Azure 入口網站的搜尋方塊中輸入 Log Analytics。 當您開始輸入時，清單會根據您的輸入進行篩選。 選取 [Log Analytics 工作區]。

   

2. 選取 [新增]。

3. 從下拉式清單中選取 [訂用帳戶]。

4. 使用現有的資源群組或建立新群組。

5. 為新的 [Log Analytics 工作區] 提供名稱，例如 DefaultLAWorkspace。 此名稱對於每個資源群組必須是唯一的。

6. 選取可用的 [區域]。 如需詳細資訊，請查看 Log Analytics 的可用區域。 在 [搜尋產品] 方塊中搜尋 Azure 監視器。

   

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

建立工作區之後，請使用 PowerShell 在 Azure 監視器中設定 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 監視器記錄的詳細資訊，請參閱在 Azure CLI 中管理 Azure 監視器記錄。

Bicep

下列範例會使用 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.')
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

Resource Manager 範本

下列範例會使用 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."
      }
    },
    "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 監視器中監視 Log Analytics 工作區的健康情況，以建立警示規則來監視工作區的健康情況。
• 請參閱收集 Azure 服務的記錄和計量以便使用於 Log Analytics，從具有 Azure 診斷或 Azure 儲存體的 Azure 資源啟用資料收集。