Criar uma área de trabalho do Log Analytics

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

Este artigo explica como criar um espaço 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. Você pode criar 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 pela função interna Colaborador do Log Analytics, por exemplo.

Criar uma área de trabalho

Portal

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 Adicionar.

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 de preço pay as you go predefinido. Não serão cobrados custos até começar a recolher dados suficientes. Para obter mais informações sobre outros escalões de preço, veja Detalhes de 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 criar um espaço de trabalho, configure um espaço de trabalho 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 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.

Bicep

O exemplo a seguir usa espaços de trabalho Microsoft.OperationalInsights para criar um espaço de trabalho do 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 Bíceps

@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 você especificar uma camada de preço de Free, 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 você especificar uma camada de preço de Free, 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 você cria um espaço de trabalho que foi excluído nos últimos 14 dias e no estado de exclusão suave, a operação pode ter um resultado diferente, dependendo da configuração do espaço de trabalho:

1. Se fornecer o mesmo nome da área de trabalho, grupo de recursos, subscrição e região que na área de trabalho eliminada, a área de trabalho será recuperada, incluindo os respetivos 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 área de trabalho que já existe ou que seja eliminado de forma recuperável, é devolvido um erro. Para eliminar permanentemente o seu nome eliminado de forma recuperável e criar uma nova área de trabalho com o mesmo nome, siga estes passos:

   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 você tem um espaço de trabalho disponível, pode configurar a coleta de telemetria de monitoramento, executar pesquisas de log para analisar esses dados e adicionar uma solução de gerenciamento para fornecer mais dados e insights analíticos. Para saber mais:

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