Usar la búsqueda en registros de captura creados por el servicio de registro centralizado en Lync Server 2013
Última modificación del tema: 2013-02-21
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. 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 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 Lync Server, debe ser miembro de los grupos de seguridad de control de acceso basado en roles (RBAC) de CsAdministrator o 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 Lync Server o el símbolo del Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Lync Server 2013 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 Lync Server: Haga clic en Inicio, haga clic en Todos los programas, haga clic en Microsoft Lync Server 2013 y, a continuación, haga clic en Shell de administración de Lync 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> del archivo –OutputFilePath <completa. 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"
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 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"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 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"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 Lync Server: Haga clic en Inicio, haga clic en Todos los programas, haga clic en Microsoft Lync Server 2013 y, a continuación, haga clic en Shell de administración de Lync Server.
De forma predeterminada, la hora de inicio de los parámetros específicos del tiempo de una búsqueda es de 30 minutos antes del momento en que se inicia la búsqueda. En otras palabras, si inicia la búsqueda a las 16:00, la búsqueda buscará los registros de los equipos y grupos que defina de 3:30:00 p.m. a 4:00:00 p.m. 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"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 la hora.
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"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"
Para ejecutar una búsqueda avanzada utilizando otros criterios y opciones de resultados
Inicie el Shell de administración de Lync Server: Haga clic en Inicio, haga clic en Todos los programas, haga clic en Microsoft Lync Server 2013 y, a continuación, haga clic en Shell de administración de Lync 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 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"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"