Iniciar ou interromper captura de log CLS no Skype for Business Server 2015Start or stop CLS log capture in Skype for Business Server 2015

Resumo: Saiba como iniciar ou parar uma sessão de captura de log de serviço de log centralizada no Skype for Business Server 2015.Summary: Learn how to start or stop a Centralized Logging Service log capture session in 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.To capture trace logs using the Centralized Logging Service, you issue a command to begin logging on one or more computers and pools. Você também pode emitir 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 componentes do Skype for Business Server (por exemplo, S4, SipStack) devem ser rastreados.You also issue parameters that define which computers or pools, what scenarios to run (for example, AlwaysOn, another predefined scenario, or a scenario you have created), what Skype for Business Server components (for example, S4, SipStack) to trace.

Para capturar informação certa, é necessário usar o cenário correto para coletar informação relevante ao problema.To capture the right information, you need to make sure you use the right scenario to collect information that is relevant to the problem. No serviço de log centralizado, um cenário é o conceito de ativar o registro em 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 em uma base por servidor.In the Centralized Logging Service, a scenario is the concept of turning logging on based on a collection of server components, logging levels, and flags, which is much more efficient and useful than having to define these elements on a per-server basis. 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.You define and specify a scenario to run and the scenario is run consistently across all servers and pools in the scope of the infrastructure.

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.The default scenario is called AlwaysOn. The intended purpose for AlwaysOn is to run the scenario constantly, as the name of the scenario implies. The AlwaysOn scenario collects Info level information (note that Info logging level includes Fatal, Error, and Warning in addition to Info messages) for many of the most common server components. AlwaysOn collects information before, during, and after a problem occurs. This differs dramatically from the typical behavior of previous logging tools such as OCSLogger. You ran OCSLogger after the problem had already occurred, making your troubleshooting efforts more difficult because the data that you have is reactive, not proactive. If AlwaysOn does not contain the information that you are looking for in order to point to the problem component and indicate a course of action to fix it (which is not likely given the breadth and depth of providers in AlwaysOn), it will indicate a reasonable level of information to determine what else you need to do, such as creating a new scenario, gather other information, run a different search to collect more focused details, and so on.

O serviço de log centralizado oferece duas maneiras de emitir comandos.The Centralized Logging Service provides two ways to issue commands. Vários tópicos se concentraram de acordo com o uso do Windows PowerShell por meio do Shell de gerenciamento do Skype for Business Server.A number of topics have been focused squarely on using Windows PowerShell through the Skype for Business Server Management Shell. A capacidade de usar diversas configurações e comandos complexos favorece o Windows PowerShell para o uso centralizado do serviço de registro em log.The ability to use a number of complex configurations and commands favors Windows PowerShell for Centralized Logging Service use. Como o Windows PowerShell por meio do Shell de gerenciamento do Skype for Business Server é praticamente onipresente para todas as funções do Skype for Business Server, somente os comandos do Windows PowerShell são discutidos.Because Windows PowerShell through the Skype for Business Server Management Shell is nearly ubiquitous for all functions in Skype for Business Server, only the Windows PowerShell commands are discussed.

Para executar Start-CsClsLogging com o Windows PowerShell usando comandos básicosTo run Start-CsClsLogging with Windows PowerShell using basic commands

  1. 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.Start the Skype for Business Server Management Shell: Click Start, click All Programs, click Skype for Business 2015, and then click Skype for Business Server Management Shell.

  2. Inicie um cenário de log com o serviço de log centralizado digitando o seguinte:Start a logging scenario with the Centralized Logging Service by typing the following:

    Start-CsClsLogging -Scenario <name of scenario>
    

    Por exemplo, para iniciar o cenário AlwaysOn, digite:For example, to start the AlwaysOn scenario, type:

    Start-CsClsLogging -Scenario AlwaysOn
    

    Observação

    O cenário AlwaysOn não tem uma duração padrão.The AlwaysOn scenario has no default duration. Este cenário será executado até que o pare precisamente com o cmdlet Stop-CsClsLogging.This scenario will run until you explicitly stop it with the Stop-CsClsLogging cmdlet. Para detalhes, consulte Stop-CsClsLogging.For details, see Stop-CsClsLogging. Para todos os outros cenários, a duração padrão é 4 horas.For all other scenarios, the default duration is 4 hours.

  3. Pressione Enter para executar o comando.Press Enter to run the command.

    Observação

    Pode levar algum tempo (30 a 60 segundos) para que os comandos sejam executados e recebam o status dos computadores em sua implantação.It may take a short amount of time (30 to 60 seconds) for the commands to run and to receive the status back from the computers in your deployment.

    Executando Start-CsClsLogging.

  4. 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):To start another scenario, use the Start-CsClsLogging cmdlet with the name of the additional scenario to run as follows (for example, the scenario Authentication):

    Start-CsClsLogging -Scenario Authentication
    

    Importante

    É 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.You can have a total of two scenarios running on any given computer at any time. If the command is global in scope, all of the computers in your deployment will run the scenario or scenarios. To start a third scenario, you must stop logging on the computer, pool, site, or global scope that you want to run the new scenario on. If you have started a global scope, you can stop logging for one or both of the scenarios on one or more computers and pools.

Para executar Start-CsClsLogging com o Windows PowerShell usando comandos avançadosTo run Start-CsClsLogging with Windows PowerShell using advanced commands

  1. 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.Start the Skype for Business Server Management Shell: Click Start, click All Programs, click Skype for Business 2015, and then click Skype for Business Server Management Shell.

  2. Estão disponíveis parâmetros adicionais para gerenciar os comandos de log.Additional parameters are available to manage the logging commands. Você pode usar-Duration para ajustar o período de tempo que o cenário deve executar.You can use -Duration to adjust the length of time for the scenario to run. Você também pode definir-computadores, uma lista de nomes de domínio totalmente qualificados do computador (FQDNs) separados por uma vírgula ou pools, uma lista de FQDNs separados por vírgula para os pools nos quais você deseja executar o logon.You also can define -Computers, a list of computer fully qualified domain names (FQDNs) separated by a comma, or -Pools, a comma separated list of FQDNs for pools that you want to run logging on.

    Você inicia uma sessão de log para o cenário UserReplicator no pool "pool01.contoso.net".You start a logging session for the UserReplicator scenario on the pool "pool01.contoso.net". Você também define duração da sessão de log em 8 horas.You also define the duration of the logging session at 8 hours. Para isso, digite:To do this, type:

    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:The successful execution of this scenario returns a result like the following:

    Executando Start-CsClsLogging.

Observe que, neste exemplo, o cenário AlwaysOn é executado e o cenário UserReplicator também está sendo executado.Note that in this example, the AlwaysOn scenario is running and the UserReplicator scenario is running.

Interrompa a captura do log do Serviço de Registro em Log CentralizadoStop the Centralized Logging Service log capture

É possível parar uma sessão de registro em log em execução no momento com o cmdlet Stop-CsClsLogging.You can stop a currently running logging session with the Stop-CsClsLogging cmdlet. Geralmente, não há muitas situações em que você precisaria parar uma sessão de log.Generally, there aren't many situations in which you would need to stop a logging session. Por exemplo, é possível pesquisar logs e alterar as configurações sem antes precisar pará-lo.For example, you can search logs and change configurations without first needing to stop logging. 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.If you have two scenarios running, for example AlwaysOn and UserReplicator, and you need to collect information related to Authentication, you will need to stop one of the other scenarios (at a global, site, pool or computer scope) before you can start running to Authentication scenario. Para obter detalhes, consulte Stop-CsClsLogging.For details, see Stop-CsClsLogging.

Observação

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.When determining what scenarios you can run on a given deployment, pool or computer, you need to remember that you are limited to running two scenarios per computer: AlwaysOn and one custom scenario. Se você estiver registrando em log uma atividade em um pool, trate o pool como uma entidade única.If you are logging activity on a pool, you should treat a pool as a single entity. Na maioria dos casos, não faria sentido executar cenários diferentes em cada computador em um pool.In most cases, it would not make sense to run different scenarios on each computer in a 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.It does make sense to look at the problem that you are collecting data about and think about what scenario makes the most sense on a given computer in the overall deployment. Por exemplo, se você considerar o cenário userreplicator, haveria um valor muito baixo na execução do userreplicator em um servidor de borda ou em um pool de bordas.For example, if you consider the UserReplicator scenario, there would be very little value in running UserReplicator on an Edge Server or Edge pool.

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.After you understand the problem and the scope of the impact, you should make careful choices about what scenarios to run on which computers and pools. While the AlwaysOn scenario makes sense for a wide scope application because it collects information on a wide variety of providers, specific scenarios only have application value on specific computers or pools. Also, you should take caution when randomly starting up a logging session without first understanding the value of a given scenario. If you use the wrong scenario, or if you use a scenario that is appropriate for the task and you apply the scenario at the wrong scope (be it global, site, pool, or computer), you can get questionable data that is not very useful—as if you didn't run the scenario at all.

Para controlar as funções de serviço de log centralizado usando o Shell de gerenciamento do Skype for Business Server, você deve ser membro do grupo de segurança CsAdministrator ou do controle de acesso baseado em função do CsServerAdministrator (RBAC) ou uma função RBAC personalizada que contenha um desses dois grupos.To control the Centralized Logging Service functions by using the Skype for Business Server Management Shell, you must be a member of either the CsAdministrator or the CsServerAdministrator role-based access control (RBAC) security groups, or a custom RBAC role that contains either of these two groups. Para retornar uma lista de todas as funções RBAC às quais esse cmdlet foi atribuído (incluindo qualquer função RBAC personalizada que você criou), execute o seguinte comando no Shell de gerenciamento do Skype for Business Server ou no prompt do Windows PowerShell:To return a list of all the RBAC roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Skype for Business Server Management Shell or the Windows PowerShell prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Skype for Business Server 2015 cmdlet"}

Por exemplo:For example:

Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Set-CsClsConfiguration"}

Observação

Você deve estar se perguntando: agora que habilitou o registro em log, onde os logs são mantidos?So you may be wondering: Now that you've enabled logging, where are the logs kept? Como você acessará as informações armazenadas nos logs usando consultas do 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.Since you'll access the information stored in the logs using management shell queries sent to the CLS Agents, and you can output the results to several possible file formats, where on each server a CLS Agent keeps its records isn't actually important to know. Os arquivos de log podem ser salvos em um local que você especifica e lido e analisado usando uma variedade de ferramentas, incluindo Snooper. exe e qualquer ferramenta que possa ler um arquivo de texto, como o Notepad. exe.The log files can be saved to a location you specify and read and analyzed using a variety of tools, including Snooper.exe and any tool that can read a text file, such as Notepad.exe. O Snooper. exe faz parte das ferramentas de depuração do Skype for Business Server 2015 e está disponível como um download da Web.Snooper.exe is part of the Skype for Business Server 2015 Debug Tools and is available as a Web download.

Para parar uma sessão de serviço de log centralizado em execução no momentoTo stop a currently running Centralized Logging Service session

  1. 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.Start the Skype for Business Server Management Shell: Click Start, click All Programs, click Skype for Business 2015, and then click Skype for Business Server Management Shell.

  2. Consulte o serviço de log centralizado para descobrir quais cenários estão sendo executados digitando o seguinte:Query the Centralized Logging Service to find out what scenarios are currently running by typing the following:

    Show-CsClsLogging
    

    Console do Windows PowerShell após chamar show-CsCl

    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.The result of Show-CsClsLogging is a summary of the scenarios that are running and what scope they are running in. For details, see Show-CsClsLogging.

  3. Para interromper uma sessão de registro em log atualmente em execução com um cenário específico, digite:To stop a currently running logging session with a specific scenario, type:

    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:For example:

    Stop-CsClsLogging -Scenario UserReplicator -Pools pool01.contoso.net
    

    Esse comando interromperá o registro em log com o cenário UserReplicator em pool01.contoso.net.This command will stop logging with the UserReplicatior scenario on pool01.contoso.net.

    Observação

    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.Logs created during this logging session using the UserReplicator scenario are not deleted. The logging is still available for you to execute searches against using the Search-CsClsLogging command. For details, see 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.Acting as the companion command to Start-CsClsLogging, the Stop-CsClsLogging cmdlet ends the logging session, defined by scenarios, and retains the logs created by the logging session. You can run two scenarios on a given computer at any time. The method of stopping one scenario to gather information using another scenario is a common task that you can perform during most workload troubleshooting.

Confira tambémSee also

Centralized Logging Service in Skype for Business 2015Centralized Logging Service in Skype for Business 2015