Iniciar o detener la captura de registros de CLS en Skype Empresarial Server 2015Start or stop CLS log capture in Skype for Business Server 2015

Resumen: Obtenga información sobre cómo iniciar o detener una sesión de captura del registro de servicio de registro centralizado en Skype para 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 los registros de seguimiento mediante el servicio de registro centralizado, emitir un comando que se va a iniciar sesión en uno o varios equipos y grupos de servidores.To capture trace logs using the Centralized Logging Service, you issue a command to begin logging on one or more computers and pools. También emitir los parámetros que definen qué equipos o grupos, qué escenarios para ejecutar (por ejemplo, AlwaysOn, otro escenario predefinido o un escenario que haya creado), ¿qué Skype para los componentes de Business Server (por ejemplo, S4, SipStack) para realizar un seguimiento.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 la información correcta, asegúrese de que utiliza el escenario correcto para recopilar información relevante al 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. En el servicio de registro con centralizado, un escenario es el concepto de activar el registro en función de una colección de componentes de servidor, los niveles de registro y los indicadores, que es mucho más eficaz y útil que tener que volver a definir estos elementos en un servidor a la vez.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. Es preciso definir y especificar un escenario para que se ejecute de forma homogénea en todos los servidores y grupos de servidores de la infraestructura.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.

El escenario predeterminado se denomina AlwaysOn. El propósito de este escenario es ejecutarse constantemente, tal como su nombre lo indica. El escenario AlwaysOn recopila datos de información (tenga en cuenta que el nivel de registro de información incluye los errores irrecuperables, los errores y las advertencias, además de los mensajes de información) para muchos de los componentes de servidores más comunes. AlwaysOn recopila información antes, durante y después de que se produzca un problema. Esto supone una diferencia significativa con respecto al comportamiento típico de las herramientas de registro anteriores como, por ejemplo, OCSLogger. OCSLogger se ejecutaba después de que se hubiera producido el problema, lo que dificultaba la tarea de solución de problemas, ya que los datos con los que se trabajaba eran reactivos y no proactivos. En caso de que AlwaysOn no contenga la información que busca para identificar el componente que presenta el problema e indicar la acción que necesita llevar a cabo para corregirlo (cosa poco probable dada la amplitud y la profundidad que caracterizan a los proveedores de AlwaysOn), siempre mostrará información razonable para determinar qué acción necesita llevar a cabo como, por ejemplo, crear un escenario, recopilar más datos, ejecutar una búsqueda diferente para recopilar detalles más específicos, etc.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.

El servicio de registro centralizado proporciona dos formas para emitir comandos.The Centralized Logging Service provides two ways to issue commands. Se han centrado directamente un número de temas sobre el uso de Windows PowerShell a través de la Skype para Shell de administración de servidor empresarial.A number of topics have been focused squarely on using Windows PowerShell through the Skype for Business Server Management Shell. La capacidad para usar un número de configuraciones complejas y comandos favorezca Windows PowerShell para su uso del servicio de registro centralizado.The ability to use a number of complex configurations and commands favors Windows PowerShell for Centralized Logging Service use. Dado que Windows PowerShell a través de la Skype para Shell de administración de servidor empresarial es casi ubicuo para todas las funciones de Skype para Business Server, se analizan únicamente los comandos de Windows PowerShell.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 ejecutar Start-CsClsLogging con Windows PowerShell mediante comandos básicosTo run Start-CsClsLogging with Windows PowerShell using basic commands

  1. Inicie el Shell de administración de Skype Empresarial Server: haga clic en Inicio, Todos los programas, Skype Empresarial Server 2015 y, después, en Shell de administración de Skype Empresarial 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. Iniciar un escenario de registro con el servicio de registro centralizado escribiendo lo siguiente:Start a logging scenario with the Centralized Logging Service by typing the following:

    Start-CsClsLogging -Scenario <name of scenario>
    

    Por ejemplo, para iniciar el escenario AlwaysOn, escriba:For example, to start the AlwaysOn scenario, type:

    Start-CsClsLogging -Scenario AlwaysOn
    

    Nota

    El escenario AlwaysOn no tiene duración predeterminada.The AlwaysOn scenario has no default duration. En este escenario se ejecutará hasta que lo detenga explícitamente con el cmdlet Stop-CsClsLogging .This scenario will run until you explicitly stop it with the Stop-CsClsLogging cmdlet. Para obtener información detallada, vea Stop-CsClsLogging.For details, see Stop-CsClsLogging. Para el resto de los escenarios, la duración predeterminada es de 4 horas.For all other scenarios, the default duration is 4 hours.

  3. Presione Entrar para ejecutar el comando.Press Enter to run the command.

    Nota

    La ejecución de los comandos y la recepción de datos de estado de los equipos de su implementación pueden llevar algo de tiempo (de 30 a 60 segundos).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.

    Ejecutar Start-CsClsLogging.

  4. Para iniciar otro escenario, use el cmdlet Start-CsClsLogging con el nombre del escenario adicional para que se ejecute como se muestra a continuación (por ejemplo, el escenario de autenticación):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

    Puede tener un total de hasta dos escenarios en ejecución a la vez en un mismo equipo. Si el comando tiene un ámbito global, todos los equipos de su implementación ejecutarán el escenario o los escenarios. Para iniciar un tercer escenario, es preciso detener el registro en el equipo, en el grupo, en el sitio o en el ámbito global en el que desee ejecutar el nuevo escenario. En caso de que haya iniciado un ámbito global, detenga el registro de uno o ambos escenarios en uno o varios de los equipos o grupos.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 ejecutar Start-CsClsLogging con Windows PowerShell mediante comandos avanzadosTo run Start-CsClsLogging with Windows PowerShell using advanced commands

  1. Inicie el Shell de administración de Skype Empresarial Server: haga clic en Inicio, Todos los programas, Skype Empresarial Server 2015 y, después, en Shell de administración de Skype Empresarial 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. Puede utilizar parámetros adicionales para administrar los comandos de registro.Additional parameters are available to manage the logging commands. Puede usar - duración que se va a ajustar el período de tiempo para el escenario para que se ejecute.You can use -Duration to adjust the length of time for the scenario to run. También puede definir - equipos, una lista de nombres de dominio de equipo completo (FQDN) separadas por comas, o - grupos de servidores, una coma separados por la lista de nombres de dominio completos de los grupos de servidores que desee que ejecute el inicio de sesión.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.

    Iniciar una sesión de registro para el escenario UserReplicator en el grupo de servidores "pool01.contoso.net".You start a logging session for the UserReplicator scenario on the pool "pool01.contoso.net". Defina también la duración de la sesión de registro en 8 horas.You also define the duration of the logging session at 8 hours. Para ello, escriba lo siguiente:To do this, type:

    Start-CsClsLogging -Scenario UserReplicator -Duration 8:00 -Pools "pool01.contoso.net"
    

    La correcta ejecución de este escenario devuelve un resultado similar al siguiente:The successful execution of this scenario returns a result like the following:

    Ejecutar Start-CsClsLogging.

Tenga en cuenta que en este ejemplo, el escenario AlwaysOn está en ejecución junto con el escenario UserReplicator.Note that in this example, the AlwaysOn scenario is running and the UserReplicator scenario is running.

Detener la captura de registros del servicio de registro centralizadoStop the Centralized Logging Service log capture

Puede detener una sesión de registro que se esté ejecutando actualmente con el cmdlet Stop-CsClsLogging.You can stop a currently running logging session with the Stop-CsClsLogging cmdlet. Por lo general, no hay muchas situaciones en las que sería necesario detener una sesión de registro.Generally, there aren't many situations in which you would need to stop a logging session. Por ejemplo, puede buscar en registros y cambiar configuraciones sin tener que detener primero el registro.For example, you can search logs and change configurations without first needing to stop logging. Si tiene dos escenarios en ejecución, por ejemplo, AlwaysOn y UserReplicator, y tiene que recopilar información relacionada con la autenticación, tendrá que detener uno de los demás escenarios (en un ámbito global, de sitio, de grupo o de equipo) antes de poder empezar a ejecutar en el escenario de autenticación.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 obtener información detallada, vea Stop-CsClsLogging.For details, see Stop-CsClsLogging.

Nota

Al determinar qué escenarios puede ejecutar en una implementación, grupo o equipo determinado, tiene que recordar que está limitado a ejecutar dos escenarios por equipo: AlwaysOn y un escenario personalizado.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. Si está registrando actividad en un grupo, dicho grupo necesita considerarse como una entidad única.If you are logging activity on a pool, you should treat a pool as a single entity. En la mayoría de los casos, no tendría sentido ejecutar diferentes escenarios en cada equipo de un grupo.In most cases, it would not make sense to run different scenarios on each computer in a pool. Parece lógico mirar el problema sobre el que está recopilando datos y considerar qué escenario tiene más sentido en un equipo determinado en la implementación global.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 ejemplo, si tiene en cuenta el escenario UserReplicator, habrá muy poco valor en la ejecución de UserReplicator en un servidor perimetral o grupo de servidores perimetrales.For example, if you consider the UserReplicator scenario, there would be very little value in running UserReplicator on an Edge Server or Edge pool.

Tras comprender el problema y el ámbito del impacto, es preciso realizar elecciones cuidadosas sobre qué escenarios ejecutar en qué equipos y grupos. A pesar de que el escenario AlwaysOn tiene sentido para una aplicación de amplio ámbito porque recopila información en una gran variedad de proveedores, los escenarios específicos solo tienen valor de aplicación en grupos o equipos específicos. Además, necesita tener cuidado al iniciar de manera aleatoria una sesión de registro sin comprender primero el valor de un escenario determinado. Si usa el escenario incorrecto, o si usa un escenario que es adecuado para la tarea y aplica el escenario en el ámbito equivocado (ya sea global, de sitio, de grupo o de equipo), puede obtener datos cuestionables que no son muy útiles, como si no ejecutara el escenario en absoluto.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 las funciones de servicio de registro centralizado mediante el uso de la Skype para Shell de administración de servidor empresarial, debe ser un miembro de la CsAdministrator o los grupos de seguridad de CsServerAdministrator acceso basado en roles (RBAC) del control o un rol RBAC personalizado que contiene cualquiera de estos dos 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 devolver una lista de todas las funciones RBAC que se ha asignado este cmdlet para (incluidos los roles RBAC personalizados que haya creado), ejecute el siguiente comando desde el Skype para Business Server Management Shell o el símbolo del sistema de 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 ejemplo:For example:

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

Para detener una sesión de servicio de registro centralizado actualmente en ejecuciónTo stop a currently running Centralized Logging Service session

  1. Inicie el Shell de administración de Skype Empresarial Server: haga clic en Inicio, Todos los programas, Skype Empresarial Server 2015 y, después, en Shell de administración de Skype Empresarial 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. Consultar el servicio de registro centralizado para averiguar qué escenarios se están ejecutando escribiendo lo siguiente:Query the Centralized Logging Service to find out what scenarios are currently running by typing the following:

    Show-CsClsLogging
    

    Consola Windows PowerShell después de llamar Show-CsCl

    El resultado de Show-CsClsLogging es un resumen de los escenarios que se están ejecutando y en qué ámbito se están ejecutando.The result of Show-CsClsLogging is a summary of the scenarios that are running and what scope they are running in. Para obtener información detallada, vea Mostrar-CsClsLogging.For details, see Show-CsClsLogging.

  3. Para detener una sesión de registro actualmente en ejecución con un escenario específico, escriba: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 ejemplo:For example:

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

    Este comando detendrá el registro con el escenario de UserReplicatior en pool01.contoso.net.This command will stop logging with the UserReplicatior scenario on pool01.contoso.net.

    Nota

    No se eliminan los registros creados durante esta sesión de registro con el escenario de UserReplicator.Logs created during this logging session using the UserReplicator scenario are not deleted. El registro todavía está disponible para que ejecute las búsquedas con el comando Search-CsClsLogging.The logging is still available for you to execute searches against using the Search-CsClsLogging command. Para obtener información detallada, vea Search-CsClsLogging.For details, see Search-CsClsLogging.

Al actuar como el comando complementario para Start-CsClsLogging, el cmdlet Stop-CsClsLogging finaliza la sesión de registro, definida por los escenarios, y conserva los registros creados por la sesión de registro. Puede ejecutar dos escenarios en un equipo determinado en cualquier momento. El método de detener un escenario para recopilar información usando otro escenario es una tarea común que puede llevar a cabo durante la mayor parte de la solución de problemas de cargas de trabajo.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.

Vea tambiénSee also

Servicio de registro centralizado en Skype para profesionales de 2015Centralized Logging Service in Skype for Business 2015