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 o workspace do Log Analytics, conforme fornecidas pela função interna de 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

Consulte Tabelas que dão suporte ao plano de tabela básico nos Logs do Azure Monitor.
Você pode mudar o plano de uma tabela uma vez por semana.

O Analytics é o plano padrão de tabela para 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:

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

A tela Tabelas lista todas as tabelas no espaço de trabalho.
Selecione o menu de contexto da tabela que você deseja configurar e selecione Gerenciar tabela.
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.
Selecione Salvar.

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	cadeia	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 registros 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"
}

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 Registros 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

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 Registros 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

Saiba mais sobre como gerenciar a retenção de dados.

Comentários

Esta página foi útil?

Last updated on 2025-08-29

Compartilhar via

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

Permissões necessárias

Definir o plano da tabela

Conteúdo relacionado

Comentários

Recursos adicionais