Criar um workspace do Log Analytics

Um Workspace do Log Analytics é um repositório de dados no qual você pode coletar qualquer tipo de dado de log de todos os seus recursos e aplicativos do Azure e não Azure. Recomendamos que você envie todos os dados de log para um espaço de trabalho do Log Analytics, a menos que você tenha necessidades comerciais específicas que exijam a criação de vários espaços de trabalho, conforme descrito em Projetar uma arquitetura de espaço de trabalho do Log Analytics.

Esse artigo explica como criar um espaço de trabalho do Log Analytics.

Pré-requisitos

Para criar um workspace do Log Analytics, você precisa de uma conta do Azure com uma assinatura ativa. Você pode criar uma conta gratuitamente.

Permissões exigidas

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

Criar um workspace

Portal

Use o menu de workspaces do Log Analytics para criar um workspace.

1. No portal do Azure, insira Log Analytics na caixa de pesquisa. Quando você começa a digitar, a lista é filtrada com base em sua entrada. Escolha workspaces do Log Analytics.

   

2. Selecione Adicionar.

3. Selecione uma Assinatura na lista suspensa.

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

5. Forneça um nome para o novo Espaço de Trabalho do Log Analytics, como DefaultLAWorkspace. Este nome precisa ser exclusivo em um grupo de recursos.

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

   

7. Clique em Examinar + Criar para examinar as configurações. Em seguida, selecione Criar para criar o workspace. O tipo de preço padrão Pagamento Conforme o Uso é aplicado. Nenhum encargo será incorrido até que você comece a coletar dados suficientes. Para obter mais informações sobre outros tipos de preço, consulte Detalhes de preço do Log Analytics.

PowerShell

O script de exemplo a seguir cria um workspace sem configuração de fonte 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

Observação

Anteriormente, o Log Analytics era chamado de Insights Operacionais. Os cmdlets do PowerShell usam Insights Operacionais nos comandos do Log Analytics.

Depois de criar um workspace, configure um workspace do Log Analytics no Azure Monitor usando o PowerShell.

CLI do Azure

Execute o comando az group create para criar um grupo de recursos ou use um grupo de recursos existente. Para criar um espaço de trabalho, use 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 Logs do Azure Monitor na CLI do Azure, consulte Gerenciando Logs do Azure Monitor na CLI do Azure.

Bicep

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

Observação

Consulte Amostras do Azure Resource Manager do Azure Monitor para obter uma lista de amostras disponíveis e diretrizes sobre como implantá-las 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
  }
}

Observação

Se você especificar um tipo 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 a seguir usa o modelo workspaces do Microsoft.OperationalInsights para criar um workspace do Log Analytics no Azure Monitor. Para obter mais informações sobre modelos do Azure Resource Manager, consulte Modelos do Azure Resource Manager.

Observação

Consulte Amostras do Azure Resource Manager do Azure Monitor para obter uma lista de amostras disponíveis e diretrizes sobre como implantá-las 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"
      ]
    }
  ]
}

Observação

Se você especificar um tipo de preço Gratuito, remova o elemento retentionInDays.

Arquivo de parâmetro.

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

Solução de problemas

Quando você cria um workspace que foi excluído nos últimos 14 dias e está no estado de exclusão reversível, a operação pode ter um resultado diferente, dependendo da configuração do seu workspace:

1. Se você fornecer o mesmo nome do workspace, grupo de recursos, assinatura e região como no workspace excluído, seu workspace será recuperado, incluindo os dados, a configuração e os agentes conectados.

2. Os nomes de workspace devem ser exclusivos para um grupo de recursos. Se você usar um nome de workspace que já existe ou foi excluído de modo reversível, um erro será retornado. Para excluir permanentemente o workspace excluído de modo reversível e criar um workspace com o mesmo nome, siga estas etapas:

   1. Recuperar o espaço de trabalho.
   2. Excluir permanentemente o espaço de trabalho.
   3. Criar um workspace usando o mesmo nome.

Próximas etapas

Agora que já tem um workspace disponível, você pode configurar a coleta de monitoramento de telemetria, executar pesquisas de logs para analisar os dados e adicionar uma solução de gerenciamento para fornecer mais dados e informações analíticas. Para saber mais:

• Consulte Monitorar integridade do workspace do Log Analytics no Azure Monitor a fim de criar regras de alerta para monitorar a integridade do workspace.
• Consulte Coletar logs e métricas do serviço para uso no Log Analytics para habilitar a coleta de dados de recursos do Azure com Diagnóstico do Azure ou armazenamento do Azure.