Configuración del registro de diagnósticos en SharePoint Server

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

Requisitos previos

La cuenta de usuario que está ejecutando los procedimientos de Administración central debe pertenecer al grupo de administradores de la granja de servidores de SharePoint.

Procedimientos recomendados para configurar el registro de diagnóstico

En el entorno de SharePoint Server, puede que necesite configurar los registros de diagnóstico después de la actualización o implementación inicial, y en caso de realizar un cambio en el entorno (como agregar o quitar un servidor). Las instrucciones de la lista siguiente pueden ayudarle a establecer los procedimientos recomendados para el entorno específico.

  • Cambie la unidad donde escribe los registros el servidor.

    De forma predeterminada, SharePoint Server escribe los registros de diagnóstico en la misma unidad y partición donde se instaló. Como el registro de diagnóstico puede usar una gran cantidad de espacio de unidad y afectar al rendimiento de la unidad, tendrá que configurar SharePoint Server para que escriba en una unidad donde no esté instalado SharePoint Server. También necesita tener en cuenta la velocidad de conexión en la unidad donde SharePoint Server escribe los registros. Si se configura un registro de nivel detallado, el servidor escribirá una gran cantidad de datos. Por lo tanto, una conexión lenta puede causar un rendimiento de registros deficiente.

  • Restrinja el uso del espacio en disco para registros.

    De forma predeterminada, no está limitada la cantidad de espacio en disco que puede usar un registro de diagnóstico. Por lo tanto, restrinja el espacio en disco que usa el registro, en especial si configura el registro para escribir eventos con nivel detallado. Cuando el disco alcance la restricción, SharePoint Server quitará los registros más antiguos antes de escribir nuevos datos de registro.

  • Use la configuración de registro detallado con moderación.

    Puede configurar el registro de diagnósticos para grabar eventos de nivel detallado. Esto significa que SharePoint Server registrará todas las acciones que realice. Los registros de nivel detallado pueden usar rápidamente todo el espacio de la unidad y afectar al rendimiento del servidor y la unidad. Puede usar registros de nivel detallado para escribir más detalles cuando realice cambios críticos; después de realizar los cambios, puede volver a configurar el registro para escribir solo los eventos de nivel superior.

  • Realice de forma periódica copias de seguridad de los registros.

    Los registros de diagnóstico contienen datos importantes. Por lo tanto, realice una copia de seguridad de los registros de forma periódica para asegurarse de que los conserve. Si restringe el uso de espacio de la unidad para los registros (o si solo conserva los registros durante unos días), cuando se alcance el umbral, SharePoint Server primero eliminará automáticamente los archivos de registro, empezando por los archivos más antiguos.

  • Habilite la protección de desbordamiento de registros de eventos.

    Al habilitar esta configuración, SharePoint Server detecta eventos repetitivos en el registro de eventos de Windows y los elimina hasta que las condiciones vuelven al estado normal.

Puede configurar el nivel del registro de diagnóstico para el registro de eventos y el de seguimiento. Esto limita los tipos y la cantidad de información que se escribe en cada registro. En la siguiente tabla se definen los niveles de registro disponibles para el registro de eventos y el de seguimiento:

Niveles del registro de eventos

Nivel Definición
Ninguno
No se realiza un registro.
Crítico
Este tipo de mensaje indica un error grave que produjo un error grave en la solución.
Error
Este tipo de mensaje indica una condición urgente. Debe investigar todos los eventos de error.
Advertencia
Este tipo de mensaje indica un posible problema que puede requerir atención. Se deben revisar los mensajes de advertencia y se debe realizar un seguimiento para identificar patrones con el paso del tiempo.
Información
Los mensajes de información no requieren ninguna acción. Sin embargo, pueden proporcionar datos valiosos para supervisar el estado de su solución.
Detallado
Este nivel de registro de eventos corresponde a eventos o mensajes largos.

Niveles de registro de seguimiento

Nivel Definición
Ninguno
No se escriben registros de seguimiento.
Inesperado
Este nivel registra los mensajes acerca de eventos que hacen que las soluciones detengan su procesamiento. Cuando se establece en este nivel, el registro incluye eventos en los niveles Inesperado, Excepción, Aserción y Crítico.
Supervisable
Este nivel registra los mensajes acerca de todos los eventos irrecuperables que limitan la funcionalidad de la solución pero no detienen la aplicación. Cuando se establece en este nivel, el registro también incluye los eventos que registra la opción Inesperado.
Alta
Este nivel registra todos los eventos que son inesperados pero no detienen el procesamiento de una solución. Cuando se establece en este nivel, el registro también incluye todos los eventos que registra la opción Supervisable.
Medio
Cuando se establece en este nivel, el registro de seguimiento incluye todos los mensajes menos los mensajes VerboseEx. Este nivel registra toda la información general acerca de las operaciones realizadas. Este nivel proporciona suficientes detalles para construir el flujo de datos y la secuencia de las operaciones. Los administradores o los profesionales de soporte técnico pueden usar este nivel de registro para solucionar problemas. Cuando se establece en este nivel, el registro también incluye todos los eventos que registra la opción Alto.
Detallado
Cuando se establece en este nivel, el registro incluye la mayoría de las acciones. El seguimiento detallado produce muchos mensajes de registro. Generalmente, este nivel se usa para la depuración en un entorno de desarrollo. Cuando se establece en este nivel, el registro también incluye todos los eventos que registra la opción Medio.
VerboseEx
Este nivel solo es compatible con el cmdlet Set-SPLogLevel de PowerShell e incluye datos de diagnóstico de muy bajo nivel. Este nivel solo debe usarse en un entorno de desarrollo. Cuando se establece en este nivel, el registro incluye todos los eventos que registra la opción Detallado.

Configuración del registro de diagnóstico con Administración central

Puede usar el sitio web de Administración central de SharePoint para configurar el registro de diagnóstico.

Para configurar el registro de diagnóstico con Administración central

  1. En Administración central, en la página principal, haga clic en Supervisión.

  2. En la página Supervisión, en la sección Informes, haga clic en Configurar registro de diagnóstico.

  3. En la página Registro de diagnósticos, en la sección Límite de eventos, configure el límite de eventos de la siguiente manera:

    Para configurar el límite de eventos para todas las categorías:

  4. Active la casilla de verificación Todas las categorías.

  5. Seleccione el nivel de registros de eventos en la lista Evento menos crítico que desea incorporar al registro de eventos.

  6. Seleccione el nivel de registros de seguimiento en la lista Evento menos crítico que desea incorporar al registro de seguimiento.

    Para configurar el límite de eventos para una o varias categorías:

  7. Active las casillas de las categorías deseadas.

  8. Seleccione el nivel de registros de eventos en la lista Evento menos crítico que desea incorporar al registro de eventos.

  9. Seleccione el nivel de registros de seguimiento en la lista Evento menos crítico que desea incorporar al registro de seguimiento.

    Para configurar el límite de eventos para una o varias subcategorías (puede expandir una o varias categorías y seleccionar cualquier subcategoría):

  10. Haga clic en el signo más (+) que está junto a la categoría para expandirla.

  11. Active la casilla de la subcategoría.

  12. Seleccione el nivel de registros de eventos en la lista Evento menos crítico que desea incorporar al registro de eventos.

  13. Seleccione el nivel de registros de seguimiento en la lista Evento menos crítico que desea incorporar al registro de seguimiento.

    Para devolver el límite de eventos de todas las categorías nuevamente a los valores predeterminados:

  14. Active la casilla de verificación Todas las categorías.

  15. Seleccione Restablecer valores predeterminados en la lista Evento menos crítico que desea incorporar al registro de eventos.

  16. Seleccione Restablecer valores predeterminados en la lista Evento menos crítico que desea incorporar al registro de seguimiento.

  17. En la sección Protección de envío masivo de registros de eventos, active la casilla de verificación Habilitar protección de envío masivo de registros de eventos.

  18. En la sección Registro de seguimiento, en el cuadro Ruta de acceso, escriba la ruta de acceso de la carpeta en la que desea escribir los registros.

  19. En el cuadro Cantidad de días que desea almacenar los archivos de registro, escriba la cantidad de días (de 1 a 366) que desea conservar los registros. Después de esta fecha, los registros se eliminarán automáticamente.

  20. Para restringir el espacio en disco que los registros pueden usar, active la casilla Restringir el uso de espacio en disco para registros de seguimiento y, a continuación, escriba la cantidad de gigabytes (GB) a la que desea restringir los archivos de registro. Cuando los registros alcancen este valor, los más antiguos se eliminarán automáticamente.

  21. Después de realizar los cambios deseados en la página Registro de diagnóstico, haga clic en Aceptar.

Configuración del registro de diagnóstico mediante PowerShell

Puede usar PowerShell para configurar el registro de diagnóstico.

Para configurar el registro de diagnóstico 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 para usar cmdlets de PowerShell.

    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.

  2. Desde el Shell de administración de SharePoint, cambie la unidad donde el servidor escribe los registros.

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

    Set-SPDiagnosticConfig -LogLocation D:\DiagnosticLogs
    
  4. Para restringir el uso de espacio en disco, en el símbolo del sistema de PowerShell, escriba el siguiente comando:

    Set-SPDiagnosticConfig -LogMaxDiskSpaceUsageEnabled
    

O bien, asigne el espacio en disco máximo para los registros:

Set-SPDiagnosticConfig -LogDiskSpaceUsageGB 500
  1. Para ver el nivel de registro actual, en el símbolo del sistema de PowerShell, escriba el siguiente comando:

    Get-SPLogLevel
    
  2. Para cambiar el nivel de registro, en el símbolo del sistema de PowerShell, escriba el siguiente comando:

    Set-SPLogLevel -TraceSeverity Monitorable
    

Para establecer todas las categorías nuevamente en los niveles predeterminados, en el símbolo del sistema de PowerShell, escriba el siguiente comando y presione ENTRAR:

Clear-SPLogLevel
  1. Para habilitar la protección contra el envío masivo de registros de eventos, en el símbolo del sistema de PowerShell, escriba el siguiente comando:

    Set-SPDiagnosticConfig -EventLogFloodProtectionEnabled
    

Para obtener más información, vea Set-SPDiagnosticConfig, Set-SPLogLevel y Get-SPLogLevel.

Consulte también

Conceptos

Introducción a la supervisión en SharePoint Server 2016