Iniciar ou interromper captura de log CLS no Skype for Business Server 2015
Resumo: Saiba como iniciar ou interromper uma sessão de captura de log do Serviço de Log Centralizado no Skype for Business Server 2015.
Para capturar logs de rastreamento usando o Serviço de Log Centralizado, você emite um comando para começar a fazer logon em um ou mais computadores e pools. Você também emite parâmetros que definem quais computadores ou pools, quais cenários executar (por exemplo, AlwaysOn, outro cenário predefinido ou um cenário que você criou), quais Skype for Business Server componentes (por exemplo, S4, SipStack) a rastrear.
Para capturar informação certa, é necessário usar o cenário correto para coletar informação relevante ao problema. No Serviço centralizado de log, um cenário é o conceito de ativar o log com base em uma coleção de componentes do servidor, níveis de log e sinalizadores, que é muito mais eficiente e útil do que ter que definir esses elementos por servidor. Você define e especifica um cenário para executar e o cenário é executado consistentemente em todos os servidores e pools no escopo da infraestrutura.
O cenário padrão é chamado de AlwaysOn. O objetivo do AlwaysOn é executar o cenários constantemente, conforme o nome do cenário implica. O cenário AlwaysOn coleta informações de nível informativo (observe que o nível de log informativo inclui Fatal, Erro e Aviso, além das mensagens informativas) para boa parte da maioria dos componentes de servidor comum. AlwaysOn coleta informações antes, durante e após o problema ocorrer. Isso difere drasticamente do comportamento típico das ferramentas de log anteriores, como o OCSLogger. É possível executar OCSLogger após o problema ocorrer, dificultando seus esforços para resolução de problemas, pois os dados que você tem são reativos, não proativos. Se AlwaysOn não tem a informação que você está procurando a fim de indicar o componente do problema e um curso de ação para corrigi-lo (o que provavelmente não leva em conta a amplitude e profundidade dos provedores em AlwaysOn), ele indicará um nível adequado de informação para determinar o que mais deve ser feito, como criar um novo cenário, juntar outras informações, realizar uma busca diferente para coletar informações mais detalhadas, e assim por diante.
O Serviço centralizado de log fornece duas maneiras de emitir comandos. Vários tópicos foram focados diretamente no uso de Windows PowerShell por meio do Shell de Gerenciamento de Skype for Business Server. A capacidade de usar várias configurações e comandos complexos favorece Windows PowerShell para uso do Serviço de Log Centralizado. Como Windows PowerShell por meio do Shell de Gerenciamento de Skype for Business Server é quase onipresente para todas as funções em Skype for Business Server, apenas os comandos Windows PowerShell são discutidos.
Para executar Start-CsClsLogging com Windows PowerShell usando comandos básicos
Inicie o Shell de Gerenciamento do Skype for Business Server: clique em Iniciar, em Todos os Programas, em Skype for Business 2015 e em Shell de Gerenciamento do Skype for Business Server.
Inicie um cenário de log com o Serviço de Log Centralizado digitando o seguinte:
Start-CsClsLogging -Scenario <name of scenario>Por exemplo, para iniciar o cenário AlwaysOn, digite:
Start-CsClsLogging -Scenario AlwaysOnNota
O cenário AlwaysOn não tem uma duração padrão. Este cenário será executado até que o pare precisamente com o cmdlet Stop-CsClsLogging. Para obter detalhes, consulte Stop-CsClsLogging. Para todos os outros cenários, a duração padrão é 4 horas.
Pressione Enter para executar o comando.
Nota
Pode levar algum tempo (30 a 60 segundos) para que os comandos sejam executados e recebam o status dos computadores em sua implantação.
Para iniciar outro cenários, use o cmdlet Start-CsClsLogging com o nome do cenário adicional para executar o seguinte (por exemplo, o cenário Autenticação):
Start-CsClsLogging -Scenario AuthenticationImportante
É possível ter um total de dois cenários sendo executados em qualquer computador a qualquer momento. Se o comando for de escopo global, todos os computadores em sua implantação executarão o(s) cenário(s). Para iniciar um terceiro cenário, você deve parar o log no escopo de computador, pool, site ou global em que você queira executar o novo cenário. Caso tenho iniciado um escopo global, é possível parar o log em um ou ambos cenários em um ou mais computadores e pools.
Para executar Start-CsClsLogging com Windows PowerShell usando comandos avançados
Inicie o Shell de Gerenciamento do Skype for Business Server: clique em Iniciar, em Todos os Programas, em Skype for Business 2015 e em Shell de Gerenciamento do Skype for Business Server.
Estão disponíveis parâmetros adicionais para gerenciar os comandos de log. Você pode usar -Duration para ajustar o tempo para que o cenário seja executado. Você também pode definir -Computadores, uma lista de FQDNs (nomes de domínio totalmente qualificados) do computador separados por uma vírgula ou -Pools, uma lista separada por vírgulas de FQDNs para pools nos quais você deseja executar o log.
Você inicia uma sessão de log para o cenário UserReplicator no pool "pool01.contoso.net". Você também define duração da sessão de log em 8 horas. Para isso, digite:
Start-CsClsLogging -Scenario UserReplicator -Duration 8:00 -Pools "pool01.contoso.net"O execução com sucesso deste cenário devolve um resultado como o seguinte:
Observe que, neste exemplo, o cenário AlwaysOn é executado e o cenário UserReplicator também está sendo executado.
Interrompa a captura do log do Serviço de Registro em Log Centralizado
É possível parar uma sessão de registro em log em execução no momento com o cmdlet Stop-CsClsLogging. Geralmente, não há muitas situações em que você precisaria interromper uma sessão de registro em log. Por exemplo, é possível pesquisar logs e alterar as configurações sem antes precisar pará-lo. Se você tiver dois cenários em execução, como o AlwaysOn e o UserReplicator, e for necessário coletar informações relacionadas à Autenticação, será necessário parar um dos outros cenários (em um escopo global, site, pool ou computador) antes de poder iniciar a execução do cenário de Autenticação. Para obter detalhes, consulte Stop-CsClsLogging.
Nota
Ao determinar quais cenários podem ser executados em uma determinada implantação, pool ou computador, é necessário se lembrar de que você está limitado à execução de dois cenários por computador. Se você estiver registrando em log uma atividade em um pool, trate o pool como uma entidade única. Na maioria dos casos, não faria sentido executar cenários diferentes em cada computador em um pool. Não faz sentido analisar o problema sobre o qual você está coletando dados e pensar sobre qual cenário faz mais sentido em um determinado computador na implantação geral. Por exemplo, se você considerar o cenário UserReplicator, haverá muito pouco valor na execução do UserReplicator em um pool do Edge Server ou do Edge.
Depois de entender o problema e o escopo do impacto, faça escolhas cuidadosas sobre quais cenários executar em quais computadores e pools. Embora o cenário AlwaysOn faça sentido para um aplicativo de escopo amplo, pois coleta informações sobre uma ampla variedade de provedores, cenários específicos têm valor de aplicativo apenas em computadores ou pools específicos. Além disso, tome cuidado ao iniciar aleatoriamente uma sessão de registro em log sem antes entender o valor de um determinado cenário. Se você usar o cenário errado ou se usar um cenário apropriado para a tarefa e aplicar o cenário ao escopo errado (seja global, site, pool ou computador), poderá receber dados questionáveis e não muito úteis – como se não tivesse executado o cenário.
Para controlar as funções do Serviço de Log Centralizado usando o Shell de Gerenciamento de Skype for Business Server, você deve ser membro do CsAdministrator ou dos grupos de segurança RBAC (controle de acesso baseado em função) CsServerAdministrator ou uma função RBAC personalizada que contém um desses dois grupos. Para retornar uma lista de todas as funções RBAC às quais esse cmdlet foi atribuído (incluindo todas as funções de RBAC personalizadas que você mesmo criou), execute o seguinte comando do Shell de Gerenciamento de Skype for Business Server ou do prompt Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Skype for Business Server 2015 cmdlet"}
Por exemplo:
Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Set-CsClsConfiguration"}
Nota
Portanto, você pode estar se perguntando: agora que você habilitou o registro em log, onde os logs são mantidos? Como você acessará as informações armazenadas nos logs usando consultas de shell de gerenciamento enviadas aos Agentes CLS e poderá gerar os resultados para vários formatos de arquivo possíveis, em que em cada servidor um agente CLS mantém seus registros não é realmente importante saber. Os arquivos de log podem ser salvos em um local que você especifica e lê e analisa usando uma variedade de ferramentas, incluindo Snooper.exe e qualquer ferramenta que possa ler um arquivo de texto, como Notepad.exe. Snooper.exe faz parte do Skype for Business Server Ferramentas de Depuração 2015 e está disponível como download da Web.
Para interromper uma sessão do Serviço de Log Centralizado atualmente em execução
Inicie o Shell de Gerenciamento do Skype for Business Server: clique em Iniciar, em Todos os Programas, em Skype for Business 2015 e em Shell de Gerenciamento do Skype for Business Server.
Consulte o Serviço de Log Centralizado para descobrir quais cenários estão em execução digitando o seguinte:
Show-CsClsLogging
O resultado de Show-CsClsLogging é um resumo dos cenários em execução e em qual escopo eles estão em execução. Para obter detalhes, consulte Show-CsClsLogging.
Para interromper uma sessão de registro em log atualmente em execução com um cenário específico, digite:
Stop-CsClsLogging -Scenario <scenario name> -Computers <comma separated list of fully qualified computer names> -Pools <comma separated list of fully qualified pool names>Por exemplo:
Stop-CsClsLogging -Scenario UserReplicator -Pools pool01.contoso.netEsse comando interromperá o registro em log com o cenário UserReplicator em pool01.contoso.net.
Nota
Os logs criados durante a sessão de registro em log usando o cenário UserReplicator não são excluídos. O registro em log ainda está disponível para execução de pesquisas usando o comando Search-CsClsLogging. Para obter detalhes, consulte Search-CsClsLogging.
Agindo como o comando acompanhante para Start-CsClsLogging, o cmdlet Stop-CsClsLogging encerra a sessão de registro em log, definida pelos cenários, e retém os logs criados pela sessão de registro em log. É possível executar dois cenários em um determinado computador a qualquer momento. O método de parar um cenário para coletar informações usando outro cenário é uma tarefa comum que pode ser executada durante grande parte das soluções de problemas de carga de trabalho.