Selecione um plano de tabela com base no uso de dados em um Workspace do Log Analytics

Você pode usar um Workspace do Log Analytics para armazenar qualquer tipo de log necessário para qualquer finalidade. Por exemplo:

• Dados detalhados e de alto volume que exigem armazenamento barato de longo prazo para auditoria e conformidade
• Dados de aplicativos e recursos para solução de problemas pelos desenvolvedores
• Dados importantes de eventos e desempenho para dimensionamento e alertas, a fim de garantir a segurança e a excelência operacional contínua
• Tendências de dados agregados de longo prazo para análise avançada e aprendizado de máquina

Os planos de tabela permitem gerenciar os custos dos dados com base na frequência com que você usa os dados em uma tabela e no tipo de análise para a qual você precisa dos dados. Este artigo explica e como definir o plano de uma tabela.

Para obter informações sobre o que cada plano de tabela oferece e para quais casos de uso ele é ideal, consulte Planos de tabela.

Permissões necessárias

Ação	Permissões necessárias
Exibir o plano de tabela	As permissões Microsoft.OperationalInsights/workspaces/tables/read para os workspaces do Log Analytics, conforme fornecidas pela função integrada Leitor do Log Analytics, por exemplo
Definir o plano de tabela	As permissões Microsoft.OperationalInsights/workspaces/write e microsoft.operationalinsights/workspaces/tables/write para os workspaces do Log Analytics, conforme fornecidas pela função integrada de Colaborador do Log Analytics, por exemplo

Definir o plano da tabela

Você pode definir o plano de tabela como Auxiliar somente quando criar uma tabela personalizada usando a API. Atualmente, não há suporte para o plano Auxiliar nas tabelas internas do Azure. Depois de criar uma tabela com um plano Auxiliar, você não pode mudar o plano da tabela.

Todas as tabelas dão suporte para o plano de Análise e todas as tabelas personalizadas baseadas em DCR e algumas tabelas do Azure dão suporte para o plano de Log Básico. Você pode alternar entre os planos de Análise e Básico; a alteração entrará em vigor imediatamente nos dados existentes na tabela.

Quando você altera o plano de uma tabela de Análise para Básico, o Azure Monitor trata quaisquer dados com mais de 30 dias como dados de retenção de longo prazo, com base no período total de retenção definido para a tabela. Em outras palavras, o período total de retenção da tabela permanece inalterado, a menos que você explicitamente modifique o período de retenção de longo prazo.

Observação

Você pode mudar o plano de uma tabela uma vez por semana.

Portal

Análise é o plano de tabela padrão de todas as tabelas que você cria no portal. É possível alternar entre os planos de Análise e Basic, conforme descrito nesta seção.

Para alternar o plano de uma tabela no portal do Microsoft Azure:

1. No menu Workspaces do Log Analytics, selecione Tabelas.

   A tela Tabelas lista todas as tabelas no workspace.

2. Selecione o menu de contexto da tabela que você deseja configurar e selecione Gerenciar tabela.

   

3. Na lista suspensa Plano da tabela na tela de configuração da tabela, selecione Básico ou Análise.

   A lista suspensa Plano da tabela está habilitada apenas para tabelas com suporte pata Logs Básicos.

   

4. Selecione Salvar.

API

Para configurar uma tabela para Logs Básicos ou Logs de Análise, chame a API Tabelas – Atualizar:

PATCH https://management.azure.com/subscriptions/<subscriptionId>/resourcegroups/<resourceGroupName>/providers/Microsoft.OperationalInsights/workspaces/<workspaceName>/tables/<tableName>?api-version=2021-12-01-preview

Corpo da solicitação

Nome	Tipo	Descrição
properties.plan	string	O plano de tabela. Os valores possíveis são Analytics e Basic.

Importante

Use o token de portador para autenticação. Leia mais sobre como usar tokens de portador.

Exemplo

Este exemplo configura a tabela ContainerLogV2 para Logs Básicos.

O Container Insights usa ContainerLog por padrão. Para alternar para usar ContainerLogV2 para os insights de contêiner, habilite o esquema ContainerLogV2 antes de converter a tabela em Logs Básicos.

Solicitação de exemplo

PATCH https://management.azure.com/subscriptions/ContosoSID/resourcegroups/ContosoRG/providers/Microsoft.OperationalInsights/workspaces/ContosoWorkspace/tables/ContainerLogV2?api-version=2021-12-01-preview

• Use este corpo de solicitação para alterar para Logs Básicos:

  {
      "properties": {
          "plan": "Basic"
      }
  }
  

• Use este corpo de solicitação para alterar para logs de análise:

  {
      "properties": {
          "plan": "Analytics"
      }
  }
  

Resposta de exemplo

• Esta amostra é a resposta para uma tabela alterada para os Logs Básicos:

  Código de status: 200

  {
      "properties": {
          "retentionInDays": 30,
          "totalRetentionInDays": 30,
          "archiveRetentionInDays": 22,
          "plan": "Basic",
          "lastPlanModifiedDate": "2022-01-01T14:34:04.37",
          "schema": {...}        
      },
      "id": "subscriptions/ContosoSID/resourcegroups/ContosoRG/providers/Microsoft.OperationalInsights/workspaces/ContosoWorkspace",
      "name": "ContainerLogV2"
  }
  

CLI

Para configurar uma tabela para Logs Básicos ou Logs de Análise, execute o comando az monitor log-analytics workspace table update e defina o parâmetro --plan como Basic ou Analytics.

Exemplos

• Para definir Logs Básicos:

  az monitor log-analytics workspace table update --subscription ContosoSID --resource-group ContosoRG  --workspace-name ContosoWorkspace --name ContainerLogV2  --plan Basic
  

• Para definir logs de análise:

  az monitor log-analytics workspace table update --subscription ContosoSID --resource-group ContosoRG  --workspace-name ContosoWorkspace --name ContainerLogV2  --plan Analytics
  

PowerShell

Para configurar o plano de uma tabela, use o cmdlet Update-AzOperationalInsightsTable:

Update-AzOperationalInsightsTable  -ResourceGroupName RG-NAME -WorkspaceName WORKSPACE-NAME -TableName TABLE-NAME -Plan Basic|Analytics

Exemplos

• Para definir Logs Básicos:

  Update-AzOperationalInsightsTable  -ResourceGroupName ContosoRG -WorkspaceName ContosoWorkspace -TableName ContainerLogV2 -Plan Basic
  

• Para definir logs de análise:

  Update-AzOperationalInsightsTable  -ResourceGroupName ContosoRG -WorkspaceName ContosoWorkspace -TableName ContainerLogV2 -Plan Analytics
  

Conteúdo relacionado

• Gerenciar retenção de dados.
• Tabelas que dão suporte para o plano de tabela Básico nos Logs do Azure Monitor.