Een Log Analytics-werkruimte maken

Een Log Analytics-werkruimte is een gegevensarchief waarin u elk type logboekgegevens van al uw Azure- en niet-Azure-resources en -toepassingen kunt verzamelen. U wordt aangeraden alle logboekgegevens naar één Log Analytics-werkruimte te verzenden, tenzij u specifieke bedrijfsbehoeften hebt waarvoor u meerdere werkruimten moet maken, zoals beschreven in Een Log Analytics-werkruimtearchitectuur ontwerpen.

In dit artikel wordt uitgelegd hoe u een Log Analytics-werkruimte maakt.

Vereisten

Als u een Log Analytics-werkruimte wilt maken, hebt u een Azure-account met een actief abonnement nodig. U kunt gratis een account maken.

Vereiste machtigingen

U hebt machtigingen nodig Microsoft.OperationalInsights/workspaces/write voor de resourcegroep waar u de Log Analytics-werkruimte wilt maken, zoals is opgegeven door de ingebouwde rol Log Analytics-inzender.

Een werkruimte maken

Portal

Gebruik het menu Log Analytics-werkruimten om een werkruimte te maken.

1. Voer in Azure Portal Log Analytics in het zoekvak in. Als u begint te typen, wordt de lijst gefilterd op basis van uw invoer. Selecteer Log Analytics-werkruimten.

   

2. Selecteer Toevoegen.

3. Selecteer een abonnement in de vervolgkeuzelijst.

4. Gebruik een bestaande resourcegroep of maak een nieuwe.

5. Geef een naam op voor de nieuwe Log Analytics-werkruimte, bijvoorbeeld StandaardLAWerkruimte. Deze naam moet uniek zijn per resourcegroep.

6. Selecteer een beschikbare regio. Bekijk in welke regio's Log Analytics beschikbaar is voor meer informatie. Zoek naar Azure Monitor in het vak Een product zoeken.

   

7. Selecteer Beoordelen + maken om de instellingen te controleren. Selecteer Vervolgens Maken om de werkruimte te maken. Er wordt een standaardprijscategorie van betalen per gebruik toegepast. Er worden pas kosten in rekening gebracht zodra u voldoende gegevens hebt verzameld. Zie Log Analytics-prijsinformatie voor meer informatie over andere prijscategorieën.

PowerShell

Met het volgende voorbeeldscript maakt u een werkruimte zonder gegevensbronconfiguratie.

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

Notitie

Log Analytics werd voorheen Operational Insights genoemd. De PowerShell-cmdlets maken gebruik van Operational Insights in Log Analytics-opdrachten.

Nadat u een werkruimte hebt gemaakt, configureert u een Log Analytics-werkruimte in Azure Monitor met behulp van PowerShell.

Azure-CLI

Voer de opdracht az group create uit om een resourcegroep te maken, of gebruik een bestaande resourcegroep. Als u een werkruimte wilt maken, gebruikt u de opdracht az monitor log-analytics workspace create.

Azure

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

Zie Azure Monitor-logboeken beheren in Azure CLI voor meer informatie over Azure Monitor-logboeken in Azure CLI.

Bicep

In het volgende voorbeeld worden Microsoft.OperationalInsights-werkruimten gebruikt om een Log Analytics-werkruimte te maken in Azure Monitor. Zie Bicep-overzicht voor meer informatie over Bicep.

Notitie

Zie Azure Resource Manager-voorbeelden voor Azure Monitor voor een lijst met voorbeelden die beschikbaar zijn en richtlijnen voor het implementeren ervan in uw Azure-abonnement.

Bicep-bestand

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

Notitie

Als u de prijscategorie Gratis opgeeft, verwijder dan het element retentionInDays.

Parameterbestand

bicepparam

using './main.bicep'

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

Resource Manager-sjabloon

In het volgende voorbeeld wordt de sjabloon Microsoft.OperationalInsights-werkruimten gebruikt om een Log Analytics-werkruimte te maken in Azure Monitor. Zie Azure Resource Manager-sjablonen voor meer informatie over Azure Resource Manager-sjablonen.

Notitie

Zie Azure Resource Manager-voorbeelden voor Azure Monitor voor een lijst met voorbeelden die beschikbaar zijn en richtlijnen voor het implementeren ervan in uw Azure-abonnement.

Sjabloonbestand

JSON

{
  "$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"
      ]
    }
  ]
}

Notitie

Als u de prijscategorie Gratis opgeeft, verwijder dan het element retentionInDays.

Parameterbestand

JSON

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

Probleemoplossing

Wanneer u een werkruimte maakt die in de afgelopen 14 dagen is verwijderd en de status Voorlopig verwijderen heeft, kan de bewerking een ander resultaat hebben, afhankelijk van de configuratie van uw werkruimte:

1. Als u dezelfde werkruimtenaam, resourcegroep, abonnement en regio opgeeft als in de verwijderde werkruimte, wordt uw werkruimte hersteld, inclusief de gegevens, configuratie en verbonden agenten.

2. Werkruimtenamen moeten uniek zijn voor een resourcegroep. Als u een werkruimtenaam gebruikt die al bestaat of voorlopig is verwijderd, wordt er een fout geretourneerd. Voer de volgende stappen uit om uw voorlopig verwijderde naam permanent te verwijderen en een nieuwe werkruimte met dezelfde naam te maken:

   1. Herstel uw werkruimte.
   2. Verwijder uw werkruimte permanent.
   3. Maak een nieuwe werkruimte met dezelfde werkruimtenaam.

Volgende stappen

Nu u een werkruimte beschikbaar hebt, kunt u het verzamelen van bewakingstelemetrie configureren, logboekzoekopdrachten uitvoeren om die gegevens te analyseren en een beheeroplossing toevoegen om meer gegevens en analytische inzichten te bieden. Zie voor meer informatie:

• Zie De status van de Log Analytics-werkruimte in Azure Monitor bewaken om waarschuwingsregels te maken om de status van uw werkruimte te bewaken.
• Zie Azure-servicelogboeken en metrische gegevens verzamelen voor gebruik in Log Analytics om het verzamelen van gegevens uit Azure-resources mogelijk te maken met Azure Diagnostics of Azure Storage.