Usar o Log Analytics para o recurso de diagnóstico na Área de Trabalho Virtual do Azure (clássica)

  • Artigo

Importante

Este conteúdo se aplica à Área de Trabalho Virtual do Azure (clássica), que não dá suporte a objetos do Azure Resource Manager na Área de Trabalho Virtual do Azure. Se você estiver tentando gerenciar objetos do Azure Resource Manager na Área de Trabalho Virtual do Azure, confira este artigo.

A Área de Trabalho Virtual do Azure oferece um recurso de diagnóstico que permite ao administrador identificar problemas por meio de uma só interface. Esse recurso registra em log as informações de diagnóstico sempre que alguém que recebeu a função de Área de Trabalho Virtual do Azure usa o serviço. Cada log contém informações sobre qual função da Área de Trabalho Virtual do Azure estava envolvida na atividade, as mensagens de erro que aparecem durante a sessão, informações de locatário e informações do usuário. O recurso de diagnóstico cria logs de atividade para ações administrativas e de usuário. Cada log de atividades se enquadra em três categorias principais:

  • Atividades de assinatura de feed: quando um usuário tenta se conectar ao feed por meio de aplicativos da Área de Trabalho Remota da Microsoft.
  • Atividades de conexão: quando um usuário tenta se conectar a uma área de trabalho ou ao RemoteApp por meio de aplicativos da Área de Trabalho Remota da Microsoft.
  • Atividades de gerenciamento: quando um administrador realiza operações de gerenciamento no sistema, como a criação de pools de hosts, a atribuição de usuários a grupos de aplicativos e a criação de atribuições de função.

As conexões que não acessam a Área de Trabalho Virtual do Azure não são exibidas nos resultados do diagnóstico, porque o próprio serviço de diagnóstico faz parte da Área de Trabalho Virtual do Azure. Problemas de conexão da Área de Trabalho Virtual do Azure podem ocorrer quando o usuário final enfrenta problemas de conectividade de rede.

Por que você deve usar o Log Analytics

Recomendamos que você use o Log Analytics para analisar dados de diagnóstico no cliente do Azure que vão além da solução de problemas de usuário único. Como você pode incluir contadores de desempenho de VM no Log Analytics, você tem uma ferramenta para coletar informações para sua implantação.

Antes de começar

Para começar a usar o Log Analytics com o recurso de diagnóstico, crie um workspace.

Depois de criar seu workspace, siga as instruções em Conectar computadores Windows ao Azure Monitor para obter as seguintes informações:

  • A ID do workspace
  • A chave primária do seu workspace

Você precisará dessas informações posteriormente no processo de instalação.

Enviar dados de diagnóstico por push para seu workspace

Você pode enviar por push dados de diagnóstico do seu locatário da Área de Trabalho Virtual do Azure para o Log Analytics do seu workspace. Você pode configurar esse recurso imediatamente quando cria seu locatário pela primeira vez vinculando seu workspace ao seu locatário ou pode configurá-lo posteriormente com um locatário existente.

Para vincular seu locatário ao seu workspace do Log Analytics enquanto estiver configurando seu novo locatário, execute o seguinte cmdlet para entrar na Área de Trabalho Virtual do Azure com sua conta de usuário do TenantCreator:

Add-RdsAccount -DeploymentUrl https://rdbroker.wvd.microsoft.com

Se você for vincular um locatário existente, em vez de um novo locatário, execute este cmdlet:

Set-RdsTenant -Name <TenantName> -AzureSubscriptionId <SubscriptionID> -LogAnalyticsWorkspaceId <String> -LogAnalyticsPrimaryKey <String>

Você precisará executar esses cmdlets para todos os locatários que deseja vincular ao Log Analytics.

Observação

Se você não quiser vincular o workspace do Log Analytics ao criar um locatário, execute o cmdlet New-RdsTenant.

Frequência de envio de eventos de diagnóstico

Os eventos de diagnóstico são enviados para o Log Analytics quando concluídos.

Consultas de exemplo

As seguintes consultas de exemplo mostram como o recurso de diagnóstico gera um relatório para as atividades mais frequentes em seu sistema:

Este primeiro exemplo mostra as atividades de conexão iniciadas pelos usuários com clientes da área de trabalho remota com suporte:

WVDActivityV1_CL
| where Type_s == "Connection"
| join kind=leftouter (
    WVDErrorV1_CL
    | summarize Errors = makelist(pack('Time', Time_t, 'Code', ErrorCode_s , 'CodeSymbolic', ErrorCodeSymbolic_s, 'Message', ErrorMessage_s, 'ReportedBy', ReportedBy_s , 'Internal', ErrorInternal_s )) by ActivityId_g
    ) on $left.Id_g  == $right.ActivityId_g 
| join  kind=leftouter (
    WVDCheckpointV1_CL
    | summarize Checkpoints = makelist(pack('Time', Time_t, 'ReportedBy', ReportedBy_s, 'Name', Name_s, 'Parameters', Parameters_s) ) by ActivityId_g
    ) on $left.Id_g  == $right.ActivityId_g
|project-away ActivityId_g, ActivityId_g1

Esta consulta de exemplo mostra as atividades de gerenciamento por administradores em locatários:

WVDActivityV1_CL
| where Type_s == "Management"
| join kind=leftouter (
    WVDErrorV1_CL
    | summarize Errors = makelist(pack('Time', Time_t, 'Code', ErrorCode_s , 'CodeSymbolic', ErrorCodeSymbolic_s, 'Message', ErrorMessage_s, 'ReportedBy', ReportedBy_s , 'Internal', ErrorInternal_s )) by ActivityId_g
    ) on $left.Id_g  == $right.ActivityId_g 
| join  kind=leftouter (
    WVDCheckpointV1_CL
    | summarize Checkpoints = makelist(pack('Time', Time_t, 'ReportedBy', ReportedBy_s, 'Name', Name_s, 'Parameters', Parameters_s) ) by ActivityId_g
    ) on $left.Id_g  == $right.ActivityId_g
|project-away ActivityId_g, ActivityId_g1

Interromper o envio de dados para o Log Analytics

Para interromper o envio de dados de um locatário existente para o Log Analytics, execute o seguinte cmdlet e defina cadeias de caracteres vazias:

Set-RdsTenant -Name <TenantName> -AzureSubscriptionId <SubscriptionID> -LogAnalyticsWorkspaceId <String> -LogAnalyticsPrimaryKey <String>

Você precisará executar esse cmdlet para todos os locatários dos quais deseja interromper o envio de dados.

Próximas etapas

Para examinar os cenários de erro comuns que o recurso de diagnóstico pode ajudar a identificar, confira Identificar e diagnosticar problemas.