Criar uma área de trabalho do Log Analytics

Um espaço de trabalho do Log Analytics é um repositório de dados para recolher qualquer tipo de dados de registo de todos os seus recursos e aplicações do Azure e não pertencentes ao Azure. Envie todos os dados de registo para um espaço de trabalho do Log Analytics, a menos que necessidades empresariais específicas exijam vários espaços de trabalho, conforme descrito em Conceber uma arquitetura de espaços de trabalho do Log Analytics.

Pré-requisitos

Para criar um espaço de trabalho do Log Analytics, você precisa de uma conta do Azure com uma assinatura ativa. Cria uma conta gratuitamente.

Permissões necessárias

Você precisa de Microsoft.OperationalInsights/workspaces/write permissões para o grupo de recursos no qual deseja criar o espaço de trabalho do Log Analytics, conforme fornecido, por exemplo, pela função interna "Colaborador do Log Analytics".

Criar uma área de trabalho

Portais

Use o menu de espaços de trabalho do Log Analytics para criar um espaço de trabalho.

1. No portal do Azure, insira Log Analytics na caixa de pesquisa. À medida que começa a escrever, a lista filtra com base na sua entrada. Selecione Área de Trabalho do Log Analytics .

   

2. Selecione Criar.

3. Selecione uma Assinatura na lista suspensa.

4. Use um Grupo de Recursos existente ou crie um novo.

5. Indique um nome para a nova Área de trabalho do Log Analytics, como DefaultLAWorkspace. Este nome tem de ser exclusivo por grupo de recursos.

6. Selecione uma região disponível. Para obter mais informações, veja em que regiões está disponível o Log Analytics. Procure Azure Monitor na caixa Procurar um produto.

   

7. Selecione Rever + Criar para rever as definições. Em seguida, selecione Criar para criar o espaço de trabalho. É aplicado um escalão padrão de preços pay-as-you-go, e não existem encargos até o início da recolha de dados. Para mais informações sobre os níveis de preços, consulte os detalhes dos preços do Log Analytics.

PowerShell

O seguinte script de exemplo cria uma área de trabalho sem configuração de origem de dados.

$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

Nota

O Log Analytics era anteriormente chamado de Operational Insights. Os cmdlets do PowerShell usam o Operational Insights em comandos do Log Analytics.

Depois de criares um espaço de trabalho, configura um espaço de trabalho Log Analytics em Azure Monitor usando PowerShell.

CLI do Azure

Execute o comando az group create para criar um grupo de recursos ou utilize um grupo de recursos existente. Para criar uma área de trabalho, utilize o comando 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>

Para obter mais informações sobre os Logs do Azure Monitor na CLI do Azure, consulte Gerenciando Logs do Azure Monitor na CLI do Azure.

Bíceps

O exemplo a seguir usa espaços de trabalho Microsoft.OperationalInsights para criar um espaço de trabalho de Log Analytics no Azure Monitor. Para obter mais informações sobre o Bicep, consulte Visão geral do Bicep.

Nota

Consulte Exemplos do Azure Resource Manager para o Azure Monitor para obter uma lista de exemplos disponíveis e orientações sobre como implantá-los em sua assinatura do Azure.

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

Nota

Se especificar um escalão de preço Gratuito, remova o elemento retentionInDays.

Arquivo de parâmetros

using './main.bicep'

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

Modelo do Resource Manager

O exemplo seguinte utiliza o modelo de áreas de trabalho Microsoft.OperationalInsights para criar uma área de trabalho do Log Analytics no Azure Monitor. Para obter mais informações sobre os modelos do Azure Resource Manager, veja modelos do Azure Resource Manager.

Nota

Consulte Exemplos do Azure Resource Manager para o Azure Monitor para obter uma lista de exemplos disponíveis e orientações sobre como implantá-los em sua assinatura do Azure.

Arquivo de modelo

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

Nota

Se especificar um escalão de preço Gratuito, remova o elemento retentionInDays.

Arquivo de parâmetros

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

Resolução de Problemas

Quando cria um espaço de trabalho que apagou nos últimos 14 dias e está em estado de eliminação suave, a operação pode ter resultados diferentes dependendo da configuração do seu espaço de trabalho:

1. Se criares um espaço de trabalho e os parâmetros que forneces forem o mesmo nome do espaço de trabalho, grupo de recursos, subscrição e região que um espaço de trabalho eliminado, recuperas o teu espaço de trabalho eliminado, incluindo os seus dados, configuração e agentes ligados.

2. Os nomes das áreas de trabalho têm de ser exclusivos para um grupo de recursos. Se utilizar um nome de espaço de trabalho que já exista ou tenha sido eliminado de forma recuperável, é apresentada uma mensagem de erro. Para eliminar permanentemente o seu nome eliminado temporariamente e criar uma nova área de trabalho com o mesmo nome, siga estas etapas:

   1. Recupere a área de trabalho.
   2. Elimine de forma permanente a área de trabalho.
   3. Crie uma nova área de trabalho com o mesmo nome da área de trabalho.

Próximos passos

Agora que existe um espaço de trabalho disponível, configure a recolha de telemetria de monitorização e execute pesquisas de registo para analisar esses dados. Para saber mais:

• Consulte Monitorizar o estado de funcionamento da área de trabalho do Log Analytics no Azure Monitor para criar regras de alerta que monitorizem o estado de funcionamento da sua área de trabalho.
• Consulte Collect Azure resource logs para permitir a recolha de dados de Azure recursos utilizando definições de diagnóstico.