Configurar o log de diagnóstico

Artigo
08/06/2024

Uma parte importante de qualquer solução do Analysis Services é o monitoramento do desempenho de seus servidores. Para obter informações gerais sobre como monitorar o Azure Analysis Services, consulte Monitorar o Azure Analysis Services.

Este artigo descreve como configurar, exibir e gerenciar logs de recursos do Azure Monitor para servidores do Analysis Services. Você pode enviar logs de recursos para o Armazenamento do Microsoft Azure Monitor, transmiti-los para os Hubs de Eventos do Azure e exportá-los para os logs do Azure Monitor.

Registrar em log os recursos do Armazenamento, do Hubs de Eventos ou do Azure Monitor

Observação

Recomendamos que você use o módulo Az PowerShell do Azure para interagir com o Azure. Para começar, consulte Instalar o Azure PowerShell. Para saber como migrar para o módulo Az PowerShell, confira Migrar o Azure PowerShell do AzureRM para o Az.

O que é registrado em log?

Você pode selecionar as categorias de log Mecanismo, Serviço e Métricas. Para obter uma listagem do que é registrado para cada categoria, consulte Logs de recursos com suporte para Microsoft.AnalysisServices/servers.

Definir configurações de diagnóstico

Para aprender como definir configurações de diagnóstico usando o portal do Azure, a CLI do Azure, o PowerShell ou o Azure Resource Manager, confira Criar configurações de diagnóstico no Azure Monitor.

Gerenciar seus logs

Os logs estão geralmente disponíveis em algumas horas após a configuração do registro em log. Cabe a você gerenciar os logs em sua conta de armazenamento:

use os métodos de controle de acesso padrão do Azure para proteger os logs, restringindo quem pode acessá-los.
Exclua os logs que você não deseja manter em sua conta de armazenamento.
Certifique-se de definir um período de retenção para que logs antigos sejam excluídos da sua conta de armazenamento.

Exibir logs no espaço de trabalho do Log Analytics

Para exibir seus dados de diagnóstico, no espaço de trabalho do Log Analytics, abra Logs no menu à esquerda.

No construtor de consultas, expanda LogManagement>AzureDiagnostics. O AzureDiagnostics inclui eventos de Mecanismo e Serviço. Veja que uma consulta é imediatamente criada. O campo EventClass_s contém nomes de xEvents, que podem parecer familiares se você já usou xEvents para registro em log local. Clique em EventClass_s ou em um dos nomes de eventos e o espaço de trabalho do Log Analytics continuará a criar uma consulta. Certifique-se de salvar as consultas para reutilizar posteriormente.

Para mais consultas sobre o que você pode usar com o Analysis Services, consulte Amostras de consultas do Kusto.

Ativar o registro em log usando o PowerShell

Neste tutorial rápido, você cria uma conta de armazenamento na mesma assinatura e mesmo grupo de recursos que o servidor do Analysis Services. Então, você usa Set-AzDiagnosticSetting para ativar o log de diagnósticos, enviando a saída para a nova conta de armazenamento.

Pré-requisitos

Para concluir este tutorial, você deve ter os seguintes recursos:

Um servidor existente do Azure Analysis Services. Para obter instruções de como criar um recurso de servidor, consulte Criar um servidor no Portal do Azure ou Criar um servidor do Azure Analysis Services usando o PowerShell.

Conectar-se às suas assinaturas

Inicie uma sessão do PowerShell do Azure e entre em sua conta do Azure com o seguinte comando:

Connect-AzAccount

Na janela pop-up do navegador, insira o nome de usuário e a senha da sua conta do Azure. O Azure PowerShell obtém todas as assinaturas que estão associadas a essa conta e, por padrão, usa a primeira.

Se você tiver várias assinaturas, talvez tenha que indicar uma assinatura específica que tenha sido usada para criar o Cofre de Chaves do Azure. Digite o seguinte para ver as assinaturas da sua conta:

Get-AzSubscription

Em seguida, para especificar a assinatura associada à conta do Azure Analysis Services que está sendo registrada, digite:

Set-AzContext -SubscriptionId <subscription ID>

Observação

Caso tenha várias assinaturas associadas à sua conta, é importante especificar a assinatura.

Criar uma nova conta de armazenamento para seus logs

Você pode usar uma conta de armazenamento existente para seus logs, desde que ela esteja na mesma assinatura que o servidor. Neste tutorial você cria uma nova conta de armazenamento dedicada aos logs do Analysis Services. Para facilitar, você armazenará os detalhes da conta de armazenamento em uma variável chamada sa.

Você também usa o mesmo grupo de recursos que aquele que contém o servidor do Analysis Services. Substitua os valores de awsales_resgroup, awsaleslogs e West Central US pelos seus próprios valores:

$sa = New-AzStorageAccount -ResourceGroupName awsales_resgroup `
-Name awsaleslogs -Type Standard_LRS -Location 'West Central US'

Identificar a conta de servidor para seus logs

Defina o nome da conta do como uma variável chamada account, em que ResourceName é o nome da conta.

$account = Get-AzResource -ResourceGroupName awsales_resgroup `
-ResourceName awsales -ResourceType "Microsoft.AnalysisServices/servers"

Habilitar o registro em log

Para habilitar o registro em log, use o cmdlet Set-AzDiagnosticSetting junto com as variáveis para a nova conta de armazenamento, a conta do servidor e a categoria. Execute o seguinte comando, definindo o sinalizador -Enabled como $true:

Set-AzDiagnosticSetting  -ResourceId $account.ResourceId -StorageAccountId $sa.Id -Enabled $true -Categories Engine

A saída deve ser semelhante ao exemplo a seguir:

StorageAccountId            : 
/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/awsales_resgroup/providers/Microsoft.Storage/storageAccounts/awsaleslogs
ServiceBusRuleId            :
EventHubAuthorizationRuleId :
Metrics                    
    TimeGrain       : PT1M
    Enabled         : False
    RetentionPolicy
    Enabled : False
    Days    : 0


Logs                       
    Category        : Engine
    Enabled         : True
    RetentionPolicy
    Enabled : False
    Days    : 0


    Category        : Service
    Enabled         : False
    RetentionPolicy
    Enabled : False
    Days    : 0


WorkspaceId                 :
Id                          : /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/awsales_resgroup/providers/microsoft.analysisservic
es/servers/awsales/providers/microsoft.insights/diagnosticSettings/service
Name                        : service
Type                        :
Location                    :
Tags                        :

Essa saída confirma que o registro em log agora está habilitado para o servidor, salvando as informações na conta de armazenamento.

Você também pode definir a política de retenção para os logs, para que logs mais antigos sejam excluídos automaticamente. Por exemplo, defina a política de retenção usando o sinalizador -RetentionEnabled como $true e defina o parâmetro -RetentionInDays como 90. Os logs com mais de 90 dias serão automaticamente excluídos.

Set-AzDiagnosticSetting -ResourceId $account.ResourceId`
 -StorageAccountId $sa.Id -Enabled $true -Categories Engine`
  -RetentionEnabled $true -RetentionInDays 90

Próximas etapas

Saiba mais sobre o log de recursos do Azure Monitor.
Consulte Set-AzDiagnosticSetting na ajuda do PowerShell.

Compartilhar via