Buscar registros de captura creados por el servicio de registro centralizado en Skype Empresarial Server 2015

Skype for Business Server 2015
 

Última modificación del tema:2016-12-20

Resumen: información sobre cómo buscar y leer registros de captura de Servicio de registro centralizado en Skype Empresarial Server 2015.

Las funciones de búsqueda del Servicio de registro centralizado resultan útiles y eficaces por las siguientes razones:

  • Sus búsquedas y los resultados se ejecutan en un único equipo, un grupo de servidores, un sitio o un ámbito global, según el criterio que defina.

  • Sus búsquedas pueden ser inicialmente amplias y, luego, acotarse a un criterio más específico, como la hora, el componente o el equipo. Al realizar sus búsquedas en los mismos registros, no necesita volver a ejecutar una sesión de registro cuando cambian los criterios de búsqueda.

  • Los resultados de su búsqueda se toman de todos los equipos y los grupos de servidores del ámbito, se reúnen y se agregan en un único archivo de salida que representa todos los resultados de los criterios de búsqueda (limitados a los escenarios que se han estado ejecutando y los datos capturados por los escenarios). Es posible utilizar herramientas familiares, como Snooper o el Bloc de notas para leer el archivo de salida y los mensajes de seguimiento desde la implementación.

El CLSAgent en cada equipo individual crea los registros en función del escenario o los escenarios (es posible ejecutar dos escenarios por equipo en cualquier momento). El CLSAgent administra los registros y sus archivos caché e índice asociados. Cuando define y ejecuta una búsqueda, el comando de búsqueda da al CLSAgent la instrucción de qué información necesita recuperarse. El CLSAgent ejecuta la consulta en los archivos de registro, los archivos caché y los archivos de índice y devuelve los resultados de la búsqueda al CLSContoller. El CLSController recibe los resultados de búsqueda de todos los equipos y grupos de servidores en el ámbito de la búsqueda. El CLSController, luego, agrega (combina) los registros y los coloca en orden delta de tiempo, la entrada más antigua en primer lugar, y avanzando en el tiempo hasta la entrada más reciente en último lugar.

Después de cada búsqueda, se ejecuta el cmdlet Sync-CsClsLogging , que vacía la memoria caché utilizada por las búsquedas (tenga presente que no hay que confundirse con los archivos caché que mantienen CLSAgent). Vaciar la memoria caché ayuda a asegurar de que haya un registro limpio y a realizar un seguimiento del búfer de captura de archivos en el CLSController para la próxima operación de búsqueda.

Para obtener el mayor beneficio del Servicio de registro centralizado, necesita comprender bien cómo se configura la búsqueda para que devuelva solamente mensajes de seguimiento desde los registros del equipo y los grupos de servidores que son relevantes para la cuestión que está buscando.

Para ejecutar las funciones de búsqueda del Servicio de registro centralizado utilizando el Shell de administración de Skype Empresarial Server, necesita ser miembro de los grupos de seguridad de control de acceso basado en roles (RBAC) CsAdministrator o bien CsServerAdministrator, o un rol RBAC personalizado que contenga alguno de estos dos grupos. Para devolver una lista de todos los roles RBAC a los que se ha asignado este cmdlet (incluso cualquier rol RBAC personalizado que haya creado usted mismo), ejecute el siguiente comando del Shell de administración de Skype Empresarial Server o el símbolo del sistema de Windows PowerShell:

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

Por ejemplo:

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

El resto de este tema se centra en cómo definir una búsqueda para optimizar la resolución de problemas.

  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 .

  2. Asegúrese de que el escenario AlwaysOn se encuentra en ejecución en la implementación en el ámbito global y, luego, escriba lo siguiente en un símbolo del sistema:

    Search-CsClsLogging -OutputFilePath 
        <string value of path and file to write the output file>
      
    
    noteNota:
    De manera predeterminada, Search-CsClsLogging envía los resultados de la búsqueda a la consola. Si desea guardar los resultados de la búsqueda en un archivo, utilice –OutputFilePath <string fully qualified file path> . Para definir el parámetro –OutputFilePath, suministre una ruta de acceso y un nombre de archivo como parte del parámetro en un formato de cadena entre comillas (por ejemplo; C:\LogFiles\SearchOutput.txt). En este ejemplo, es preciso asegurarse de que exista el directorio C:\LogFiles y de que tenga los permisos de lectura y escritura (permiso NTFS de modificación) de archivos de la carpeta. El resultado se anexa y no se sobrescribe. Si necesita archivos independientes, defina un nombre de archivo diferente para cada búsqueda.

    Por ejemplo:

    Search-CsClsLogging -OutputFilePath "C:\LogFiles\logfile.txt"
    

  1. Para limitar la búsqueda a un determinado equipo o grupo de servidores, utilice el parámetro –Computers con el equipo definido por un nombre de dominio completo del equipo entre comillas y separado por una coma de la siguiente manera:

    Search-CsClsLogging -Computers 
        <string value of computer names>
       -OutputFilePath 
        <string value of path and file to write the output file>
      
    

    Por ejemplo:

    Search-CsClsLogging -Computers "fe01.contoso.net" -OutputFilePath "C:\LogFiles\logfile.txt"
    
  2. Para buscar en más de un equipo, escriba varios nombres de equipos entre comillas y separados por comas, como, por ejemplo, de la siguiente manera:

    Search-CsClsLogging -Computers "fe01.contoso.net", "fe02.contoso.net", "fe03.contoso.net" -OutputFilePath "C:\LogFiles\logfile.txt"
    
  3. Si necesita buscar en un grupo de servidores entero en lugar de en un único equipo, cambie el parámetro –Computers por –Pools, quite el nombre del equipo y reemplácelo con el grupo o los grupos de servidores entre comillas y separados por comas.

    Por ejemplo:

    Search-CsClsLogging -Pools "pool01.contoso.net" -OutputFilePath "C:\Logfiles\logfile.txt"
    
  4. Al utilizar los comandos de búsqueda, los grupos de servidores pueden ser cualquier grupo de servidores de la implementación, como Grupos de servidores front-end, Grupos de servidores perimetrales, Grupos de servidores de chat persistente u otros que se definan como grupos de servidores en su implementación.

    Por ejemplo:

    Search-CsClsLogging -Pools "pool01.contoso.net", "pchatpool01.contoso.net", "intedgepool01.contoso.net" -OutputFilePath "C:\Logfiles\logfile.txt"
    

  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 .

  2. De manera predeterminada, la hora de inicio para los parámetros específicos de hora de una búsqueda es de 25 minutos antes hasta cinco minutos después de la hora en que inició la búsqueda. En otras palabras, si la búsqueda se hace a las 16:00:00, la hora de inicio de la búsqueda se mostrará desde las 15:35:00 hasta las 16:05:00. Si necesita buscar desde 60 minutos o 3 horas antes de la hora actual, utilice el parámetro –StartTime y defina la cadena de fecha y hora para indicar la hora en la que quiera que empiece la búsqueda.

    Por ejemplo, utilizando los parámetros –StartTime y –EndTime para definir un rango de fecha y hora, puede definir una búsqueda entre las 8 y las 9 del 20/11/2012 en su grupo de servidores. Puede definir la ruta de salida para que escriba los resultados en un archivo llamado c:\logfile.txt de la manera siguiente:

    Search-CsClsLogging -Pools "pool01.contoso.net" -StartTime "11/20/2012 08:00:00 AM" -EndTime "11/20/2012 09:00:00 AM" -OutputFilePath "C:\Logfiles\logfile.txt"
    
    noteNota:
    La cadena de fecha y hora que especifique puede ser "fecha hora" u "hora fecha". El comando analizará la cadena y utilizará los valores apropiados de fecha y hora, y su configuración regional y referencia cultural en la máquina desde la que está ejecutando el cmdlet.
  3. Si desea recuperar registros que empiecen a las 11:00:00 del 20/11/2012, es preciso definir el parámetro –StartTime. El rango de hora predeterminado para la búsqueda es de 30 minutos, a menos que defina un parámetro –EndTime específico. La búsqueda resultante devolverá registros desde el equipo o los grupos de servidores definidos desde las 11:00:00 hasta las 11:30:00.

    Por ejemplo:

    Search-CsClsLogging -Pools "pool01.contoso.net" -StartTime "11/20/2012 11:00:00 AM" -OutputFilePath "C:\Logfiles\logfile.txt"
    
  4. Para llevar a cabo una búsqueda de registros dentro de un período de tiempo específico, defina un parámetro –StartTime y –EndTime. Necesita registros desde las 13 hasta las 14:45 en el equipo edge01.contoso.net.

    Por ejemplo:

    Search-CsClsLogging -Computers "edge01.contoso.net" -StartTime "11/20/2012 1:00:00 PM" -EndTime "11/20/2012 2:45:00 PM" -OutputFilePath "C:\Logfiles\logfile.txt"
    

  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 .

  2. Para ejecutar un comando a fin de recopilar seguimientos de determinados componentes, escriba lo siguiente:

    Search-CsClsLogging -Components 
        <components to search on>
       -OutputFilePath 
        <fully qualified path to output logs>
      
    

    Por ejemplo:

    Search-CsClsLogging -Components "SIPStack","S4","UserServices" -OutputFilePath "C:\Logfiles\logfile.txt"
    

    La búsqueda resultante devuelve todas las entradas de registro que tengan componentes de seguimiento para SIPStack, S4 y UserServices en todos los equipos y grupos de servidores en su implementación para los últimos 30 minutos.

  3. Para limitar la búsqueda con los mismos componentes para solamente su Grupo de servidores front-end llamado pool01.contoso.net, escriba:

    Search-CsClsLogging -Components "SIPStack","S4","UserServices" -OutputFilePath "C:\Logfiles\logfile.txt"
    
  4. La lógica de búsqueda predeterminada para los comandos con varios parámetros es utilizar el conector lógico O con cada uno de los parámetros definidos. Puede cambiar este comportamiento al especificar el parámetro –MatchAll . Para ello, escriba lo siguiente:

    Search-CsClsLogging -CallId "d0af828e49fa4dcb99f5f80223a634bc" -Components "SIPStack","S4","UserServices" -MatchAll -OutputFilePath "C:\Logfiles\logfile.txt"
    
  5. Si sus escenarios están definidos para que se ejecuten constantemente, como AlwaysOn, o ha definido un escenario de larga ejecución, los registros podrían salir de la máquina local y pasar al recurso compartido de archivos. Define el recurso compartido de archivos utilizando el parámetro CacheFileNetworkFolder, al utilizar New-CsClsConfiguration para crear una nueva configuración o al modificar una configuración existente con Set-CsClsConfiguration. Si no desea que la búsqueda incluya el recurso compartido de archivos en la colección de registros que se buscará, utilice el parámetro SkipNetworkLogs de la siguiente manera:

    Search-CsClsLogging -Components "SIPStack","S4","UserServices" -StartTime "11/1/2012 00:00:01 AM" -EndTime "11/20/2012 2:45:00 PM" -SkipNetworkLogs -OutputFilePath "C:\Logfiles\logfile.txt"
    
    

Las auténticas ventajas del Servicio de registro centralizado pueden apreciarse al ejecutar la búsqueda y obtener un archivo con el que se puede realizar un seguimiento de un problema informado. Hay varias formas de leer el archivo. El archivo de salida tiene un formato de texto estándar y puede usar Notepad.exe o cualquier otro programa que permita abrir y leer un archivo de texto. Para los archivos de mayor tamaño y para los problemas más complejos, puede usar una herramienta como Snooper.exe, que está diseñada para leer y analizar la salida del registro del Servicio de registro centralizado. Snooper forma parte de las herramientas de depuración disponibles como una descarga independiente. Puede descargar las herramientas de depuración aquí: https://go.microsoft.com/fwlink/?LinkId=285257. Cuando instala las herramientas de depuración, no se crean los accesos directos ni los elementos del menú. Una vez que las haya instalado, abra el Explorador de Windows, una ventana de línea de comandos o el Shell de administración de Skype Empresarial Server, y vaya al directorio (ubicación predeterminada) C:\Archivos de programa\Skype Empresarial Server 2015\Herramientas de depuración. Haga doble clic en Snooper.exe o escriba Snooper.exe y, luego, presione ENTRAR si está usando la línea de comandos o el Shell de administración de Skype Empresarial Server.

importantImportante:
La finalidad de este tema no es dar información detallada ni tratar las técnicas de solución de problemas. La solución de problemas y los procesos relacionados con esta son un tema muy complejo. Para obtener más información acerca de los conceptos básicos de solución de problemas y solución de problemas de cargas de trabajo específicas, consulte el Microsoft Lync Server 2010 libro Kit de recursos en el https://go.microsoft.com/fwlink/p/?linkId=211003. Los procesos y procedimientos también pueden aplicarse a Skype Empresarial Server 2015.

  1. Para usar Snooper y abrir archivos de registro, necesita tener acceso de lectura a los archivos de registro. Para usar Snooper y tener acceso a los archivos de registro tiene que ser miembro de los grupos de seguridad de control de acceso basado en roles (RBAC) CsAdministrator o CsServerAdministrator, o de un rol RBAC personalizado que contenga cualquiera de estos dos grupos.

  2. Tras la instalación de las herramientas de depuración de (LyncDebugTools.msi), vaya al directorio donde se encuentra Snooper.exe con el Explorador de Windows o desde la línea de comandos. De forma predeterminada, las herramientas de depuración se encuentran en C:\Archivos de programa\Skype Empresarial Server 2015\Herramientas de depuración. Haga doble clic en Snooper.exe o ejecútelo.

  3. Tras abrir Snooper, haga clic con el botón secundario en Archivo , haga clic en Abrir archivo , localice los archivos de registro, seleccione un archivo en el cuadro de diálogo Abrir y haga clic en Abrir .

  4. Los mensajes de Seguimiento del archivo de registro se muestran en la pestaña Seguimiento . Haga clic en la pestaña Mensajes para ver el contenido de los mensajes de los seguimientos recopilados.

  1. Para usar Snooper y abrir archivos de registro, necesita tener acceso de lectura a los archivos de registro. Para usar Snooper y tener acceso a los archivos de registro es preciso ser miembro de los grupos de seguridad de control de acceso basado en roles (RBAC) CsAdministrator o CsServerAdministrator, o de un rol RBAC personalizado que contenga cualquiera de estos dos grupos.

  2. Abra el archivo de registro y haga clic en la pestaña Mensajes , seleccione una conversación en la vista de mensajes o seleccione un componente de seguimiento en la pestaña Seguimiento .

  3. Haga clic en Flujo de llamada .

    noteNota:
    Si hace clic en un mensaje o seguimiento que no forma parte de un flujo de llamada, el diagrama no aparecerá y un mensaje de estado en la parte inferior de Snooper indicará que "Este mensaje no es apto para el flujo de llamada". Elija otro mensaje o seguimiento, y el flujo de llamada aparecerá si el mensaje o seguimiento forma parte del flujo de llamada.
  4. Desplácese por las líneas de mensajes o seguimientos y observe si el diagrama de flujo de llamada se actualiza o cambia para mostrar un diagrama nuevo.

  5. Pase el mouse por encima de los elementos para obtener información sobre los mensajes de llamadas, los extremos y otros componentes.

 
Mostrar: