Share via

Uso del panel del programador

  • Artículo

Última modificación: miércoles, 06 de octubre de 2010

Hace referencia a: SharePoint Foundation 2010

En este artículo
¿Qué información se captura?
Modos de presentación del panel
Habilitación del panel del programador
Deshabilitación del panel del programador
¿En qué páginas aparece el panel del programador?
Uso del panel del programador en páginas maestras personalizadas
Mediante el panel del programador con código personalizado

El panel del programador es un marco de instrumentación que introduce Microsoft SharePoint Foundation 2010. Tiene un concepto similar al seguimiento de páginas de ASP.NET y proporciona información de diagnóstico que puede ayudar a los programadores o administradores del sistema a solucionar problemas relacionados con componentes de la página que, en caso contrario, serían muy difíciles de aislar. Por ejemplo, un programador puede introducir fácilmente más objetos SPSite o SPWeb en el código, sin saberlo, o bien agregar consultas de SQL Server extrañas.

Antes, la única forma de depurar problemas de rendimiento causados por la sobrecarga adicional de estas instancias en el código era adjuntar un depurador al código y supervisar los trazos del SQL Server Profiler. Gracias al panel del programador, un programador puede identificar este tipo de problema, ya sea mediante programación usando el modelo de objetos, o bien visualmente observando los resultados de la página.

Aunque los problemas de rendimiento y la información de uso de recursos están disponibles en el Servicio de creación de registros unificado (ULS), interpretar los datos sin formato puede llevar mucho tiempo. Gracias al panel del programador, se correlaciona toda la información relacionada, lo que hace que estos tipos de problemas sean mucho más fáciles de identificar.

¿Qué información se captura?

El panel del programador contiene un mecanismo extensible para medir los distintos contadores de rendimiento en diversos ámbitos. Dentro del panel del programador, los siguientes contadores de rendimiento permiten supervisar el consumo de recursos y el uso en cada fase de las solicitudes.

Contadores de subprocesos

Estos contadores miden los valores para la solicitud o el trabajo del temporizador actuales:

  • Tiempo de ejecución de subprocesos

  • Número, duración, información de pila de llamadas y texto de consulta de cada consulta a SQL Server que genera la página

  • Número, duración e información de pila de llamadas de cada llamada de WCF

  • Dirección URL o nombre del trabajo del temporizador

  • Usuario actual

  • Tiempo de inicio de ejecución

  • Cualquiera de las estadísticas anteriores para código incluido en SPMonitoredScope (vea Uso de SPMonitoredScope)

Los datos anteriores se envían a dos ubicaciones al final de cada solicitud o trabajo del temporizador:

  • Registro ULS: todas las estadísticas recopiladas para un ámbito especificado siempre se registran en el registro ULS.

  • Panel del programador: las estadísticas de rendimiento de una solicitud están disponibles en la ventana del explorador.

Modos de presentación del panel

El panel del programador se puede mostrar en los modos siguientes:

  • On

    Cuando se habilita en el modo On, el panel está visible en todas las páginas que usan la página maestra predeterminada.

  • OnDemand

    Cuando el panel del programador está configurado en el modo OnDemand, se muestra un icono en la parte superior derecha de la página. Este icono permite al usuario activar y desactivar el panel.

    Nota

    Es importante tener en cuenta que, cuando el modo de presentación se establece en OnDemand, cualquier usuario que tenga permisos para ver la página también podrá ver la salida del panel.

Habilitación del panel del programador

El panel del programador siempre está desactivado de manera predeterminada. Para que sea visible, debe habilitarlo mediante el uso de STSADM, cmdlets de Windows PowerShell o el modelo de objetos de SharePoint Foundation.

Uso de STSADM

Abra una ventana de comandos en el directorio %ProgramFiles%\Common Files\Microsoft Shared Debug\Web Server Extensions\14\BIN y escriba uno de los comandos siguientes, según el modo de presentación deseado.

Mode

Command

On

stsadm -o setproperty -pn developer-dashboard -pv on

OnDemand

stsadm -o setproperty -pn developer-dashboard -pv ondemand

Mediante cmdlets de Windows PowerShell

Mode

Command

On

(Get-SPFarm).PerformanceMonitor.DeveloperDashboardLevel = ”On”

OnDemand

(Get-SPFarm).PerformanceMonitor.DeveloperDashboardLevel = ”OnDemand”

Deshabilitación del panel del programador

Uso de STSADM

stsadm -o setproperty -pn developer-dashboard -pv off

¿En qué páginas aparece el panel del programador?

Cuando está habilitado, el panel del programador aparece de manera predeterminada en cualquier página que use la página maestra de SharePoint Foundation 2010 o en cualquier página que use una página maestra personalizada en la que se incluye el control del panel.

Uso del panel del programador en páginas maestras personalizadas

Se requieren dos componentes para mostrar el panel: el selector del panel del programador y el control de representación de página que representa los resultados en la página.

  • Selector del panel del programador

    Cuando el modo de presentación se establece en OnDemand, el selector muestra el icono del selector. Se puede usar en cualquier lugar en la página. En el ejemplo siguiente se muestra el marcado necesario para incluir el selector en una página maestra.

    <Sharepoint:DeveloperDashboardLauncher
   ID="DeveloperDashboardLauncher"
   href="javascript:ToggleDeveloperDashboard()"
   runat="server"
   ImageUrl="/_layouts/images/fgimg.png"
   Text="<%$Resources:wss,multipages_launchdevdashalt_text%>"
   OffsetX=0
   OffsetY=222
   Height=16
   Width=16 />

  • Control de representación de página.

    El control de representación debe encontrarse en la parte inferior del marcado de la página. No se informará acerca de las métricas de los controles de la página que se encuentren debajo del control de representación al panel del programador.

    <SharePoint:DeveloperDashboard runat="server" />

Mediante el panel del programador con código personalizado

Con la introducción de la clase SPMonitoredScope, el programador tiene la capacidad de "envolver" código y de ver las estadísticas correspondientes a dicho código en la pantalla. Esta información se puede usar para identificar posibles puntos de error o, como mínimo, los componentes que no tienen el rendimiento esperado.

Vea también

Conceptos

Uso de SPMonitoredScope

Evitar la construcción innecesaria de objetos SPWeb y SPSite