Selecione um plano de tabela com base no uso de dados em um espaço de trabalho do Log Analytics

Você pode usar um espaço de trabalho 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 a longo prazo para auditoria e conformidade
• Dados de aplicativos e recursos para solução de problemas por desenvolvedores
• Principais eventos e dados de desempenho para dimensionamento e alerta para garantir excelência operacional e segurança contínuas
• Tendências de dados agregados de longo prazo para análises avançadas e aprendizado de máquina

Os planos de tabela permitem gerenciar os custos de 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 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
Ver plano da tabela	Microsoft.OperationalInsights/workspaces/tables/readpermissões para o espaço de trabalho do Log Analytics, conforme fornecido pela função interna do Log Analytics Reader, por exemplo
Definir plano de mesa	Microsoft.OperationalInsights/workspaces/writee microsoft.operationalinsights/workspaces/tables/write permissões para o espaço de trabalho do Log Analytics, conforme fornecido pela função interna do 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, as tabelas internas do Azure não oferecem suporte ao plano Auxiliar. Depois de criar uma tabela com um plano Auxiliar, não é possível mudar o plano da tabela.

Todas as tabelas dão suporte ao plano do Google Analytics e todas as tabelas personalizadas baseadas em DCR e algumas tabelas do Azure dão suporte ao plano de log Básico. Você pode alternar entre os planos Analytics e Basic, a alteração entra em vigor nos dados existentes na tabela imediatamente.

Quando você altera o plano de uma tabela do Google Analytics para o Basic, o monitor do Azure trata todos os 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 de retenção total da tabela permanece inalterado, a menos que você modifique explicitamente o período de retenção de longo prazo.

Nota

Pode mudar de plano de uma mesa uma vez por semana.

Portal

Analytics é o plano de tabela padrão de todas as tabelas que você cria no portal. Você pode alternar entre os planos Analytics e Basic, conforme descrito nesta seção.

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

1. No menu Espaços de trabalho do Log Analytics, selecione Tabelas.

   A tela Tabelas lista todas as tabelas no espaço de trabalho.

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

   

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

   A lista suspensa Plano de tabela está habilitada somente para tabelas que oferecem suporte a logs básicos.

   

4. Selecione Guardar.

API

Para configurar uma tabela para logs básicos ou logs do Google Analytics, chame Tabelas - API de atualização:

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

Importante

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

Corpo do pedido

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

Exemplo

Este exemplo configura a ContainerLogV2 tabela para logs básicos.

O Container Insights usa ContainerLog por padrão. Para alternar para o uso ContainerLogV2 de informações de contêiner, habilite o esquema ContainerLogV2 antes de converter a tabela em logs básicos.

Pedido de amostra

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 do Google Analytics:

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

Resposta de amostra

Este exemplo é a resposta para uma tabela alterada para 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 do Google Analytics, execute o comando az monitor log-analytics workspace table update e defina o --plan parâmetro como Basic ou Analytics.

Por exemplo:

• 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 os Logs do Google Analytics:

  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 -Plan Basic|Analytics

Conteúdos relacionados

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