Поделиться через


Использование панели мониторинга разработчиков

Дата последнего изменения: 9 марта 2015 г.

Применимо к: SharePoint Foundation 2010

В этой статье
Записываемые данные
Режимы отображения панели мониторинга
Включение панели мониторинга разработчиков
Отключение панели мониторинга разработчиков
На каких страницах отображается панель мониторинга разработчиков
Использование панели мониторинга разработчиков на настраиваемых главных страницах
Использование панели мониторинга разработчиков с пользовательским кодом

Панель мониторинга разработчиков — это инструментальная платформа, введенная в Microsoft SharePoint Foundation 2010. Схожая по концепции с трассировкой страниц ASP.NET, она предоставляет сведения диагностики, которые помогают разработчику или системному администратору устранять проблемы с компонентами страницы, которые в противном случае было бы очень трудно изолировать. Например, разработчик неумышленно может легко ввести дополнительные объекты SPSite или SPWeb в свой код или добавить лишние запросы к SQL Server.

Ранее единственный способ устранить проблемы с производительностью, вызванные дополнительными издержками реализации этих экземпляров в коде, заключался в том, чтобы присоединить отладчик к коду и отслеживать трассировки SQL Server Profiler. Разработчик с помощью панели мониторинга разработчиков может определить такой тип проблемы программными средствами при использовании объектной модели или визуально, посмотрев на страницу.

Хотя сведения о проблемах с производительностью и использовании ресурсов доступны в журналах службы ULS, на интерпретирование необработанных данных может уйти очень много времени. В панели мониторинга разработчиков все связанные данные коррелируются, что позволяет намного легче выявить такие типы проблем.

Записываемые данные

Панель мониторинга разработчиков содержит расширяемый механизм для измерения различных счетчиков производительности в разных областях. В панели мониторинга разработчиков следующие счетчики производительности используются для отслеживания потребляемых ресурсов на каждом этапе выполнения запроса.

Счетчики по потокам

Эти счетчики измеряют значения для текущего запроса или задания таймера:

  • время выполнения потока;

  • номер, длительность, данные стека вызовов и текст для каждого запроса SQL Server, сформированного страницей;

  • номер, длительность, данные стека вызовов каждого вызова WCF;

  • URL-адрес или имя задания таймера;

  • текущий пользователь;

  • время начала выполнения.

  • Любые из указанных параметров в коде включаются в SPMonitoredScope (см. раздел Использование SPMonitoredScope)

Указанные данные записываются в следующие два ресурса в конце каждого запроса или задания таймера:

  • Журнал ULS — вся собранная статистика для указанной области всегда записывается в журнал ULS.

  • Панель мониторинга разработчиков — статистика производительности запроса доступна в окне браузера.

Режимы отображения панели мониторинга

Панель мониторинга разработчиков может отображаться в следующих режимах.

  • On

    В режиме "On" панель мониторинга можно просматривать на всех страницах, которые используют главную страницу по умолчанию.

  • OnDemand

    Если панель мониторинга разработчиков находится в режиме "OnDemand", в правой верхней части страницы отображается соответствующий значок. Он позволяет пользователю включать и выключать панель мониторинга разработчиков.

    ПримечаниеПримечание

    Важно отметить, что когда установлен режим отображения OnDemand, любой человек, имеющий права на просмотр страницы, также будет иметь возможность просматривать выходные данные панели мониторинга.

Включение панели мониторинга разработчиков

По умолчанию панель мониторинга разработчиков всегда отключена. Чтобы ее можно было просматривать, ее необходимо включить с помощью STSADM, командлетов Windows PowerShell или объектной модели SharePoint Foundation.

Использование STSADM

Откройте окно командной строки в каталоге %ProgramFiles%\Common Files\Microsoft Shared Debug\Web Server Extensions\14\BIN и введите одну из следующих команд в зависимости от необходимого режима отображения.

Mode

Command

On

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

OnDemand

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

Использование командлетов Windows PowerShell

Mode

Command

On

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

OnDemand

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

Отключение панели мониторинга разработчиков

Использование STSADM

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

На каких страницах отображается панель мониторинга разработчиков

Если панель мониторинга разработчиков включена, по умолчанию она отображается на любой странице, которая использует главную страницу SharePoint Foundation 2010, или любую страницу, использующую настраиваемую главную страницу, на которой размещен элемент управления панели мониторинга.

Использование панели мониторинга разработчиков на настраиваемых главных страницах

Для отображения панели мониторинга разработчиков необходимы два компонента. Это средство запуска панели мониторинга разработчика и элемент управления для отрисовки страницы, который выполняет визуализацию страницы.

  • Средство запуска панели мониторинга разработчиков

    Если используется режим отображения OnDemand, средство запуска отображает свой значок. Его можно использовать в любом месте страницы. В следующем примере показана разметка, необходимая для размещения средства запуска на главной странице.

    <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 />
    
  • Элемент управления визуализацией страницы

    Элемент управления визуализацией должен быть размещен в нижней части разметки страницы. Показатели всех элементов управления, расположенные ниже элемента управления визуализацией, не передаются в панель мониторинга разработчиков.

    <SharePoint:DeveloperDashboard runat="server" />
    

Использование панели мониторинга разработчиков с пользовательским кодом

С помощью класса SPMonitoredScope разработчики могут создавать "оболочку" для кода и отображать статистику использования этого кода на экране. Эти сведения можно использовать для выявления потенциальных моментов сбоя или, по крайней мере, компонентов, которые работают не так, как ожидается.

См. также

Концепции

Использование SPMonitoredScope

Исключение необязательного создания объектов SPWeb и SPSite