Criar um workspace do Log Analytics

Este artigo mostra como criar um workspace do Log Analytics. Quando você coleta logs e dados, as informações são armazenadas em um workspace. Um workspace tem uma ID de workspace e uma ID de recurso exclusivas. O nome do workspace precisa ser exclusivo para um determinado grupo de recursos. Depois de criar um workspace, configure fontes de dados e soluções para armazenar seus dados nelas.

Você precisará de um workspace do Log Analytics se coletar dados de:

• Recursos do Azure em sua assinatura.
• Computadores locais monitorados pelo System Center Operations Manager.
• Coleções de dispositivos do Configuration Manager.
• Dados de diagnóstico ou de log do armazenamento do Azure.

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.

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-08-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
      "workspaceName": {
          "type": "string",
          "metadata": {
            "description": "Name of the workspace."
          }
      },
      "sku": {
          "type": "string",
          "allowedValues": [
            "pergb2018",
            "Free",
            "Standalone",
            "PerNode",
            "Standard",
            "Premium"
            ],
          "defaultValue": "pergb2018",
          "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",
          "name": "[parameters('workspaceName')]",
          "apiVersion": "2020-08-01",
          "location": "[parameters('location')]",
          "properties": {
              "sku": {
                  "name": "[parameters('sku')]"
              },
              "retentionInDays": "[parameters('retentionInDays')]",
              "features": {
                  "enableLogAccessUsingOnlyResourcePermissions": "[parameters('resourcePermissions')]"
              }
          },
          "resources": [
            {
              "type": "Microsoft.OperationalInsights/workspaces/tables",
              "apiVersion": "2020-08-01",
              "name": "[concat(parameters('workspaceName'),'/','Heartbeat')]",
              "dependsOn": [
                "[parameters('workspaceName')]"
              ],
              "properties": {
                "RetentionInDays": "[parameters('heartbeatTableRetention')]"
              }
            }
          ]
      }
  ]
}

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.