Configurar o log de diagnóstico

  • Artigo

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.

Resource logging to Storage, Event Hubs, or Azure Monitor logs

Observação

Recomendamos que você use o módulo Az PowerShell do Azure para interagir com o Azure. Confira Instalar o Azure PowerShell para começar. 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.

Configurar o log de diagnóstico

Portal do Azure

  1. No servidor do Portal do Azure>, clique em Configurações de diagnóstico na navegação à esquerda e, em seguida, clique em Ativar diagnóstico.

    Screenshot showing Turn on diagnostics in the Azure portal.

  2. Em Configurações de diagnóstico, especifique as opções a seguir:

    • Nome. Insira um nome para os logs a serem criados.

    • Arquivar em uma conta de armazenamento. Para usar essa opção, você precisa de uma conta de armazenamento existente à qual se conectar. Consulte Criar uma conta de armazenamento. Siga as instruções para criar um Gerenciador de Recursos, uma conta de finalidade geral, em seguida, selecione sua conta de armazenamento retornando para esta página no portal. Pode levar alguns minutos para que as contas de armazenamento recém-criadas sejam exibidas no menu suspenso.

    • Transmitir para um hub de eventos. Para usar essa opção, é necessário ter um namespace existente do Hub de Eventos e um hub de evento ao qual se conectar. Para saber mais, consulte Criar um namespace de Hubs de Eventos e um hub de eventos usando o Portal do Azure. Em seguida, retorne a esta página no portal para selecionar o namespace e o nome da política do Hub de Eventos.

    • Enviar para o Azure Monitor (espaço de trabalho do Log Analytics). Para usar essa opção, use um workspace existente ou crie um novo recurso de workspace no portal. Para obter mais informações sobre como exibir os logs, confira Exibir logs no espaço de trabalho do Log Analytics neste artigo.

    • Mecanismo. Selecione esta opção para registrar xEvents. Ao arquivar uma conta de armazenamento, você poderá selecionar o período de retenção para os logs de recurso. Os logs são excluídos automaticamente depois que o período de retenção expira.

    • Serviço. Selecione esta opção para registrar eventos de nível de serviço. Ao arquivar em uma conta de armazenamento, poderá selecionar o período de retenção para os logs de recurso. Os logs são excluídos automaticamente depois que o período de retenção expira.

    • Métricas. Selecione esta opção para armazenar dados detalhados em Métricas. Ao arquivar em uma conta de armazenamento, poderá selecionar o período de retenção para os logs de recurso. Os logs são excluídos automaticamente depois que o período de retenção expira.

  3. Clique em Save (Salvar).

    Se você receber um erro que diga "Falha ao atualizar o diagnóstico para <nome do workspace>. Para a assinatura <ID da assinatura>não está registrado para usar o microsoft.insights", siga as instruções de Solucionar problemas de diagnóstico do Azure para registrar a conta e repetir esse procedimento.

    Sempre que você quiser alterar como os seus logs de recursos são salvos, retorne a esta página para modificar as configurações.

PowerShell

Aqui estão os comandos básicos para você começar. Se você desejar obter ajuda passo a passo sobre como configurar o registro em log para uma conta de armazenamento usando o PowerShell, consulte o tutorial mais adiante neste artigo.

Para habilitar as métricas e o log de recursos usando o PowerShell, use os seguintes comandos:

  • Para habilitar o armazenamento dos logs de recursos em uma conta de armazenamento, use este comando:

    Set-AzDiagnosticSetting -ResourceId [your resource id] -StorageAccountId [your storage account id] -Enabled $true

    A ID da conta de armazenamento é a ID do recurso da conta de armazenamento para a qual você deseja enviar os logs.

  • Para habilitar o streaming dos logs de recursos para um hub de eventos, use este comando:

    Set-AzDiagnosticSetting -ResourceId [your resource id] -ServiceBusRuleId [your service bus rule id] -Enabled $true

    A ID de regra do Barramento de Serviço do Azure é uma cadeia de caracteres com o seguinte formato:

    {service bus resource ID}/authorizationrules/{key name}

  • Para habilitar o envio dos logs de recursos para um workspace do Log Analytics, use este comando:

    Set-AzDiagnosticSetting -ResourceId [your resource id] -WorkspaceId [resource id of the log analytics workspace] -Enabled $true

  • Para obter a ID do recurso do workspace do Log Analytics, use o seguinte comando:

    (Get-AzOperationalInsightsWorkspace).ResourceId

É possível combinar esses parâmetros para habilitar várias opções de saída.

API REST

Saiba como alterar as configurações de diagnóstico usando a API REST do Azure Monitor.

Modelo do Resource Manager

Saiba como habilitar as configurações de diagnóstico na criação de recursos usando um modelo do Resource Manager.

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.

Screenshot showing log Search options in the Azure portal.

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:

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/a23279b5-xxxx-xxxx-xxxx-47b7c6d423ea/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/a23279b5-xxxx-xxxx-xxxx-47b7c6d423ea/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