Een Log Analytics-werkruimte maken

Een Log Analytics werkruimte is een gegevensarchief voor het verzamelen van elk type logboekgegevens van al uw Azure en niet-Azure resources en toepassingen. Alle logboekgegevens naar één Log Analytics werkruimte verzenden, tenzij voor specifieke bedrijfsbehoeften meerdere werkruimten nodig zijn, zoals beschreven in Ontwerp een Log Analytics werkruimtearchitectuur.

Vereisten

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

Vereiste machtigingen

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

Een werkruimte maken

Maak een Log Analytics werkruimte met behulp van de Azure-portal, PowerShell, de Azure CLI, een Bicep-bestand of een Resource Manager-sjabloon. Selecteer het tabblad voor de methode die u wilt gebruiken.

Portaal

Maak een werkruimte in de Azure-portal vanuit het menu Log Analytics werkruimten.

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. Klik op Creëren.

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 Maken om de werkruimte te maken. Er wordt een standaardprijscategorie voor betalen per gebruik toegepast en er worden geen kosten in rekening gebracht totdat het verzamelen van gegevens begint. Zie Log Analytics prijsinformatie voor meer informatie over prijscategorieën.

PowerShell

Met het volgende voorbeeldscript maakt u een werkruimte zonder gegevensbronconfiguratie.

$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. De volgende opdrachten gebruiken een formulier met één regel voor elke opdracht, zodat ze worden uitgevoerd in een shell, waaronder PowerShell en de standaard-Windows Cloud Shell:

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

Voer de opdracht az monitor log-analytics workspace show uit om te controleren of de werkruimte is gemaakt. De werkruimte wordt ook weergegeven in de lijst met Log Analytics werkruimten in de Azure-portal.

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

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

Biceps

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

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

Parameterbestand

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

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

Parameterbestand

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

Probleemoplossing

Wanneer u een werkruimte maakt die u in de afgelopen 14 dagen hebt verwijderd en de status voorlopig verwijderen heeft, kan de bewerking verschillende resultaten hebben, afhankelijk van de configuratie van uw werkruimte:

1. Als u een werkruimte maakt en de parameters die u opgeeft dezelfde werkruimtenaam, resourcegroep, abonnement en regio zijn als een verwijderde werkruimte, herstelt u de verwijderde werkruimte, inclusief de gegevens, configuratie en verbonden agents.

2. Werkruimtenamen moeten uniek zijn voor een resourcegroep. Als u een werkruimtenaam gebruikt die al bestaat of voorlopig is verwijderd, krijgt u een foutmelding. 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.

Verwante onderwerpen

Nu een werkruimte beschikbaar is, configureert u het verzamelen van bewakingstelemetrie en voert u zoekopdrachten in logboeken uit om die gegevens te analyseren. Zie voor meer informatie:

• Zie De status van een Log Analytics-werkruimte bewaken in Azure Monitor om waarschuwingsregels te maken waarmee u de status van uw werkruimte kunt bewaken.
• Zie Collect Azure resource logs om gegevensverzameling uit Azure-resources in te schakelen met behulp van diagnostische instellingen.