Compartilhar via

Usando o log avançado para transações sintéticas no Lync Server 2013

  • Artigo

 

Tópico última modificação: 22-10-2012

As transações sintéticas (introduzidas no Microsoft Lync Server 2010) fornecem uma maneira para os administradores verificarem se os usuários podem concluir com êxito tarefas comuns, como fazer logon no sistema, trocar mensagens instantâneas ou fazer chamadas para um telefone localizado na PSTN (rede telefônica pública comunada). Esses testes (que são empacotados como um conjunto de cmdlets do Lync Server Windows PowerShell) podem ser realizados manualmente por um administrador ou podem ser executados automaticamente por um aplicativo como o System Center Operations Manager.

No Lync Server 2010, as transações sintéticas provaram ser extremamente úteis para ajudar os administradores a identificar problemas com o sistema. Por exemplo, o cmdlet Test-CsRegistration pode alertar os administradores sobre o fato de que alguns usuários estavam tendo dificuldades para se registrar no Lync Server. No entanto, as transações sintéticas foram um pouco menos úteis para ajudar os administradores a determinar por que esses usuários estavam tendo dificuldade para se registrar no Lync Server. Isso ocorreu porque as transações sintéticas não forneceram informações detalhadas de log que poderiam ajudar os administradores a solucionar problemas com o Lync Server. Na melhor das situações, a saída detalhada de uma transação sintética forneceu informações passo a passo que podem permitir que um administrador faça uma estimativa educada sobre onde um problema provavelmente ocorreu.

No Microsoft Lync Server 2013, as transações sintéticas foram arquitetadas novamente para fornecer logs avançados. "Log avançado" significa que, para cada atividade que uma transação sintética realiza, informações como essa serão registradas:

  • A hora em que a atividade foi iniciada

  • A hora em que a atividade foi concluída

  • A ação que foi executada (por exemplo, criar, ingressar ou sair de uma conferência; entrar no Lync Server; enviar uma mensagem instantânea; e assim por diante)

  • Mensagens informativas, detalhadas, de advertência ou de erro geradas quando a atividade foi executada

  • Mensagens de registro SIP

  • Registros de exceção ou códigos de diagnóstico gerados quando a atividade foi executada

  • O resultado líquido da execução da atividade

Essas informações são geradas automaticamente sempre que uma transação sintética é executada. No entanto, as informações não são exibidas ou salvas automaticamente em um arquivo de log. Em vez disso, os administradores que executam manualmente uma transação sintética podem usar o parâmetro OutLoggerVariable para especificar uma variável Windows PowerShell na qual as informações serão armazenadas. A partir daí, os administradores podem usar um par de métodos que permitem salvar e/ou exibir o log avançado no formato XML ou HTML.

Por exemplo, os administradores do Lync Server 2010 podem executar o cmdlet Test-CsRegistration usando um comando semelhante ao seguinte:

Test-CsRegistration -TargetFqdn atl-cs-001.litwareinc.com

Os administradores têm a opção de incluir o parâmetro OutLoggerVariable seguido por um nome de variável de sua escolha:

Test-CsRegistration -TargetFqdn atl-cs-001.litwareinc.com -OutLoggerVariable RegistrationTest

Nota

Não preceda o nome da variável com o caractere $. Use um nome de variável como RegistrationTest e não $RegistrationTest.

O comando anterior gera conteúdo semelhante ao seguinte:

Target Fqdn   : atl-cs-001.litwareinc.com
Result        : Failure
Latency       : 00:00:00
Error Message : This machine does not have any assigned certificates.
Diagnosis     :

No entanto, informações muito mais detalhadas estão disponíveis para essa falha do que apenas a mensagem de erro mostrada acima. Para acessar essas informações em formato HTML, use um comando semelhante a este para salvar as informações armazenadas na variável RegistrationTest em um arquivo HTML:

$RegistrationTest.ToHTML() | Out-File C:\Logs\Registration.html

Como alternativa, é possível usar o método ToXML() para salvar os dados em um arquivo XML:

$RegistrationTest.ToXML() | Out-File C:\Logs\Registration.xml

Esses arquivos podem ser exibidos usando o Internet Explorer, o Visual Studio ou qualquer outro aplicativo capaz de abrir arquivos HTML/XML.

As transações sintéticas executadas de dentro do System Center Operations Manager gerarão automaticamente esses arquivos de log para falhas. No entanto, esses logs não serão gerados se a execução falhar antes Windows PowerShell é capaz de carregar e executar a transação sintética.

Importante

Por padrão, o Lync Server 2013 salva arquivos de log em uma pasta que não é compartilhada. Para tornar esses logs prontamente acessíveis, você deve compartilhar essa pasta (por exemplo, \\atl-watcher-001.litwareinc.com\WatcherNode.