Ver registros de diagnóstico en SharePoint Server

  • Artículo

SE APLICA A:yes-img-132013 yes-img-162016 yes-img-192019 yes-img-seSubscription Edition no-img-sopSharePoint en Microsoft 365

Puede solucionar problemas de la granja de servidores con los datos de los registros del Servicio de registro unificado (ULS) de SharePoint Server. Los registros de ULS pueden recopilar datos en varios niveles según la configuración de registro. Use PowerShell para filtrar datos, mostrarlos de varias formas y enviarlos a una cuadrícula de datos con la que puede filtrar, ordenar, agrupar y exportar datos a Excel 2016.

Visualización y filtrado de eventos de registro mediante PowerShell

Puede usar PowerShell para ver y filtrar eventos de registro. No puede hacer esto con el sitio web de Administración central de SharePoint.

Para ver y filtrar eventos de registro mediante PowerShell

  1. Compruebe que cumple con las pertenencias siguientes:

  • Rol fijo de servidor securityadmin en la instancia de SQL Server.

  • Rol fijo de base de datos db_owner en todas las bases de datos que se van a cargar.

  • Grupo de servidores en el servidor en el que se van a ejecutar los cmdlets de PowerShell.

    Un administrador puede usar el cmdlet Add-SPShellAdmin para conceder permisos.

    Nota:

    Si no dispone de permisos, póngase en contacto con el administrador para la instalación o con el administrador de SQL Server para solicitarlos. Para más información sobre permisos de PowerShell, vea Add-SPShellAdmin.

  1. Vaya al Shell de administración de SharePoint.

  2. En el símbolo del sistema de PowerShell, escriba el comando siguiente:

  • Todos los eventos de rastreo:
Get-SPLogEvent
  • Por nivel:
Get-SPLogEvent | Where-Object {$_.Level -eq "Information" }
  • Por área:
Get-SPLogEvent | Where-Object {$_.Area -eq <Area>}

Donde <Area> es el valor de la propiedad Area .

  • Por categoría:
Get-SPLogEvent | Where-Object {$_.Category -eq <Category>

Donde <Category> es el valor de la propiedad Category .

  • Por identificador de evento:
Get-SPLogEvent | Where-Object {$_.EventID -eq <EventID>}

Donde <EventID> es el valor de la propiedad EventID .

  • Por texto de mensaje:
Get-SPLogEvent | Where-Object {$_.Message -like "<string>"}

Donde <cadena> es la cadena que se encuentra en el mensaje de evento.

  • Por proceso:
Get-SPLogEvent | Where-Object {$_.Process -like "<Process>"}

Donde <Process> es el valor de la propiedad Process .

De forma predeterminada, el comando devuelve datos de la carpeta del registro de ULS predeterminada. Para ver y filtrar los eventos de rastreo de una carpeta compartida en una red, use el parámetro Directory del cmdlet Get-SPLogEvent.

Para ver más detalles sobre cada evento de rastreo, use el cmdlet Format-List al final del comando. Por ejemplo,

Get-SPLogEvent | Where-Object {$_.Area -eq "SharePoint Foundation"} | Format-List

Para obtener más información, vea Get-SPLogEvent.

Visualización y exportación de registros de diagnóstico mediante el cmdlet Out-GridView de PowerShell

PowerShell proporciona una característica eficaz y fácil de usar que muestra los datos tabulares resultantes de los comandos de PowerShell en una cuadrícula de datos filtrable que se puede buscar en una ventana independiente. Puede usar la cuadrícula para ver los eventos de registro y realizar las siguientes operaciones en los datos:

  • Ordenar los datos por cualquier columna.

  • Ver los datos en grupos.

  • Filtrar los datos por nivel, área, categoría, mensaje, identificador de evento o marca de tiempo.

  • Buscar en los datos cualquier cadena.

  • Exportar datos sin procesar, organizados o filtrados a una hoja de cálculo.

Nota:

No se puede usar el cmdlet Out-GridView con los cmdlets que usan el verbo Format. El cmdlet Out-GridView recibe objetos, mientras que los cmdlets que usan el verbo Format solo devuelven texto con formato. > Puede ver un subconjunto de los datos mediante el cmdlet Where-Object que filtra y pasa los resultados al cmdlet Out-GridView . Por ejemplo, Get-SPLogEvent | Where-Object {$_.Area -eq "SharePoint Foundation"} | Out-GridView. > Si la cuadrícula muestra más de varios cientos de filas, podría ejecutarse lentamente, especialmente si se realizan operaciones de filtrado complejas. Para obtener un rendimiento más rápido, exporte los datos a Excel 2016.

Para ver y filtrar registros de diagnóstico con Windows PowerShell

  1. Compruebe que cumple con las pertenencias siguientes:

  • Rol fijo de servidor securityadmin en la instancia de SQL Server.

  • Rol fijo de base de datos db_owner en todas las bases de datos que se van a cargar.

  • Grupo de servidores en el servidor en el que se van a ejecutar los cmdlets de PowerShell.

    Un administrador puede usar el cmdlet Add-SPShellAdmin para conceder permisos.

    Nota:

    Si no dispone de permisos, póngase en contacto con el administrador para la instalación o con el administrador de SQL Server para solicitarlos. Para más información sobre permisos de PowerShell, vea Add-SPShellAdmin.

  1. Vaya al Shell de administración de SharePoint.

  2. En el símbolo del sistema de PowerShell, escriba el comando siguiente:

Get-SPLogEvent | Out-GridView

  1. Para ordenar las columnas, haga clic en el encabezado de columna.

  2. Para buscar una cadena específica, escriba la cadena en el cuadro Filtro. La búsqueda se realiza en todas las columnas y filas. Para borrar la búsqueda, haga clic en X.

  3. Para filtrar datos en función de un único criterio, escriba lo siguiente en el cuadro Búsqueda: <nombre de propiedad>:<valor>. Por ejemplo, para buscar todas las entradas de registro generadas por SharePoint Foundation 2013, escriba lo siguiente: Area: SharePoint Foundation. Para borrar el filtro, haga clic en X.

  4. Para filtrar datos con más de un criterio o con criterios de “contiene, empieza por, termina con” u otros métodos:

  5. Haga clic en el botón Agregar criterio.

  6. Haga clic en la casilla de las propiedades que desea usar para filtrar y, a continuación, haga clic en Agregar.

  7. Haga clic en contiene para cambiar a un método de filtrado distinto. Los métodos disponibles son contiene, no contiene, comienza por, es igual a, no es igual a, termina con, está vacío y no está vacío.

  8. Escriba un valor en el cuadro de texto.

  9. Repita los pasos “c” y “d” para cada propiedad que seleccionó en el paso “b”.

  10. Una vez especificados todos los criterios de filtrado, se mostrarán los datos que cumplen los criterios.

  11. Para borrar un filtro especifico, haga clic en el botón X.

  12. Para borrar todos los filtros, contraiga la vista de consulta y haga clic en el botón Borrar todo.

Para exportar datos de una cuadrícula a una hoja de cálculo

  1. Seleccione las filas que desea exportar. Puede seleccionar varias columnas de distintas formas: presione Mayús y arrastre para seleccionar un bloque de columnas, presione CTRL+clic para seleccionar columnas específicas o presione CTRL+A para seleccionar todas las columnas.

    También puede filtrar y ordenar los datos antes de copiarlos en una hoja de cálculo. Cuando ordena o filtra datos, solo se copian los datos visibles.

  2. Copie las filas seleccionadas usando CTRL+C.

  3. Abra la página del libro de la hoja de cálculo y, a continuación, pegue en la página las filas copiadas usando CTRL+V.

Para obtener más información, vea Out-GridView y Out-GridView Revisited.