Buscar registros de captura creados por el servicio de registro centralizado en Skype Empresarial Server 2015
Resumen: Obtenga información sobre cómo buscar y leer registros de captura del servicio de registro centralizado en Skype Empresarial Server 2015.
Las características de búsqueda del servicio de registro centralizado son ú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. Busque en los mismos registros y no necesita volver a ejecutar una sesión de registro cuando cambien 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 aprovechar al máximo el servicio de registro centralizado, necesita comprender bien cómo configurar la búsqueda para devolver solo los mensajes de seguimiento del equipo y los registros del grupo que sean relevantes para el problema que está investigando. Cuestiones
Para ejecutar las funciones de búsqueda del servicio de registro centralizado mediante el Shell de administración de Skype Empresarial Server, debe ser miembro de los grupos de seguridad de CsAdministrator o de control de acceso basado en roles (RBAC) de CsServerAdministrator, o bien un rol RBAC personalizado que contenga cualquiera de estos dos grupos. Para devolver una lista de todos los roles RBAC a los que se ha asignado este cmdlet (incluidos los roles RBAC personalizados que haya creado usted mismo), ejecute el siguiente comando desde el 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.
Para ejecutar una búsqueda básica mediante el servicio de registro centralizado
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.
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>
Nota
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, use la ruta de acceso> de archivo completa de la cadena -OutputFilePath<. Para definir el parámetro -OutputFilePath, proporcione 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"
Para ejecutar una búsqueda básica en un grupo o equipo mediante el servicio de registro centralizado
Para limitar la búsqueda a un grupo o equipo específico, use el parámetro -Computers con el equipo definido por un nombre completo, entre comillas y separado por comas 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"
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"Si necesita buscar un grupo completo en lugar de en un solo equipo, cambie el parámetro -Computers a -Pools, quite el nombre del equipo y reemplácelo por el grupo o grupos entre comillas separados por comas.
Por ejemplo:
Search-CsClsLogging -Pools "pool01.contoso.net" -OutputFilePath "C:\Logfiles\logfile.txt"Al usar los comandos de búsqueda, los grupos pueden ser cualquier grupo de la implementación, como grupos de servidores front-end, grupos perimetrales, grupos de servidores de chat persistente u otros que se hayan definido como un grupo en la implementación.
Por ejemplo:
Search-CsClsLogging -Pools "pool01.contoso.net", "pchatpool01.contoso.net", "intedgepool01.contoso.net" -OutputFilePath "C:\Logfiles\logfile.txt"
Para ejecutar una búsqueda utilizando los parámetros de hora
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.
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 60 minutos o 3 horas antes de la hora actual, use el parámetro -StartTime y establezca la cadena de fecha y hora para indicar la hora a la que desea que comience la búsqueda.
Por ejemplo, si usa -StartTime y -EndTime para definir un intervalo de fechas y horas, puede definir una búsqueda entre las 8 y las 9 de la mañana del 20/11/2012 en el grupo. 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"
Nota
La cadena de fecha y hora que especifique puede ser "fecha hora" u "hora fecha". " El comando analizará la cadena y usará los valores apropiados para la fecha y hora y la configuración regional y cultural en el equipo desde el que está ejecutando el cmdlet.
- Si desea recuperar registros a partir de las 11:00:00 AM del 20/11/2012, defina -StartTime. El intervalo de tiempo predeterminado para la búsqueda es de 30 minutos a menos que defina un determinado -EndTime. 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"
- Para realizar una búsqueda de registros dentro de un período de tiempo específico, defina un -StartTime y un -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"
Para ejecutar una búsqueda avanzada utilizando otros criterios y opciones de resultados
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.
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.
Para limitar la búsqueda con los mismos componentes solo a su grupo de servidores front-end denominado pool01.contoso.net, escriba:
Search-CsClsLogging -Components "SIPStack","S4","UserServices" -OutputFilePath "C:\Logfiles\logfile.txt"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 especificando el parámetro -MatchAll . Para ello, escriba lo siguiente:
Search-CsClsLogging -CallId "d0af828e49fa4dcb99f5f80223a634bc" -Components "SIPStack","S4","UserServices" -MatchAll -OutputFilePath "C:\Logfiles\logfile.txt"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"
Leer los registros de captura desde el servicio de registro centralizado
Se da cuenta del beneficio real del servicio de registro centralizado después de ejecutar la búsqueda y tiene un archivo que puede usar para localizar un problema notificado. 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 archivos más grandes y problemas más complejos, podría usar una herramienta como Snooper.exe que esté diseñada para leer y analizar la salida del registro desde el 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. Al instalar las herramientas de depuración, no se crean los cortes cortos ni los elementos del menú. Después de instalar las Herramientas de depuración, abre el Explorador de Windows, una ventana de línea de comandos o Skype Empresarial Server Shell de administración y ve 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, a continuación, presione ENTRAR si usa la línea de comandos o Skype Empresarial Server Shell de administración.
Importante
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 información detallada sobre la solución de problemas y la solución de problemas de cargas de trabajo específicas, consulte el libro Kit de recursos de Microsoft Lync Server 2010 en https://go.microsoft.com/fwlink/p/?linkId=211003. Los procesos y procedimientos siguen aplicándose en Skype Empresarial Server 2015.
Para abrir un archivo de registro en Snooper
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.
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.
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.
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 del mensaje de los seguimientos recopilados.
Para mostrar un diagrama de flujo de llamada
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.
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.
Haga clic en Flujo de llamada.
Nota
Si hace clic en un mensaje o seguimiento que no forma parte de un flujo de llamadas, el diagrama no aparecerá y aparecerá un mensaje de estado en la parte inferior de Snooper que indica "Este mensaje no es apto para callfow". Elija otro mensaje o seguimiento, y el flujo de llamada aparecerá si el mensaje o seguimiento forma parte del flujo de llamada.
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.
Pase el mouse por encima de los elementos para obtener información sobre los mensajes de llamadas, los extremos y otros componentes.