Настройка журнала ведения диагностики в SharePoint Server

 

**Применимо к:**SharePoint Server 2016

**Последнее изменение раздела:**2017-07-31

Сводка. Узнайте, как настроить ведение журнала диагностики в SharePoint Server 2013 и 2016 с помощью сайта центра администрирования SharePoint или Windows PowerShell.

В этой статье

  • Перед началом работы

  • Рекомендации по настройке ведения диагностического журнала

  • Настройка ведения диагностического журнала с помощью центра администрирования

  • Настройка ведения диагностического журнала с помощью Windows PowerShell

Необходимые компоненты

Выполнять процедуры в Центр администрирования могут только участники группы SharePoint "Администраторы фермы".

Рекомендации по настройке ведения диагностического журнала

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

  • Измените диск, на который сервер записывает журналы.

    По умолчанию SharePoint Server записывает диагностические журналы на тот же диск и в тот же раздел, куда установлена сама программа. Так как диагностический журнал может использовать большой объем дискового пространства и ухудшать производительность диска, необходимо настроить SharePoint Server для записи журналов на другой диск, на котором SharePoint Server не установлен. Также необходимо учесть скорость подключения диска, на который SharePoint Server записывает журналы. Если настроен подробный уровень ведения журнала, сервер записывает большой объем данных. Поэтому медленное подключение может привести к плохой производительности журнала.

  • Ограничьте использование дискового пространства журнала.

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

  • Используйте параметр Verbose аккуратно.

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

  • Регулярно создавайте архивы журналов.

    Диагностические журналы содержат важные данные. Поэтому регулярно делайте архивы журналов, чтобы обеспечить сохранность данных. Если ограничить использование дискового пространства журналами или настроить хранение журналов только в течение нескольких дней, то по достижении порогового значения SharePoint Server будет автоматически удалять файлы журналов, начиная с самых старых.

  • Включите защиту от переполнения журнала событий.

    Если включить этот параметр, SharePoint Server определяет повторяющиеся события в журнале событий Windows и отключает их, пока не восстановится нормальное состояние.

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

Уровни журнала событий

Уровень Определение

Нет

Журнал не ведется.

Критический

Этот тип сообщения указывает на серьезную ошибку, которая привела к значительной неисправности в решении.

Ошибка

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

Предупреждение

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

Сведения

Информационные сообщения не требуют каких-либо действий. Но они могут дать ценные сведения для наблюдения за состоянием решения.

Подробный

Этот уровень ведения журнала соответствует подробным описаниям ошибок или сообщений.

Уровни журнала трассировки

Уровень Определение

Нет

Журналы трассировки не записываются.

Непредвиденный

На этом уровне записываются сообщения о событиях, которые вызывают остановку обработки данных решениями. На этом уровне в журнал добавляются также все события, которые записываются на уровнях Unexpected, Exception, Assert и Critical.

Наблюдаемый

На этом уровне записываются сообщения о всех неисправимых событиях, которые ограничивают функциональность решения, но не останавливают приложение. На этом уровне в журнал добавляются также все события, которые записываются на уровне Unexpected (непредвиденный).

Высокий

На этом уровне записываются события, которые не ожидались, но которые не остановили обработку решения. На этом уровне в журнал добавляются также все события, которые записываются на уровне Monitorable.

Средний

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

Подробный

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

VerboseEx

Этот уровень поддерживается только командлетом Set-SPLogLevelPowerShell и содержит очень подробные диагностические данные. Этот уровень должен использоваться только в средах разработки. На этом уровне в журнал добавляются также все события, которые записываются на уровне Verbose.

Настройка ведения диагностического журнала с помощью центра администрирования

Для настройки диагностического журнала можно использовать сайт Веб-сайт центра администрирования SharePoint.

Процедура настройки ведения диагностического журнала с помощью центра администрирования

  1. На домашней странице центра Центр администрирования щелкните Мониторинг.

  2. На странице отслеживания в разделе Отчет выберите Настройка средств сбора данных диагностики.

  3. На странице "Сбор данных диагностики" в разделе Регулирование событий настройте регулирование событий следующим образом:

    Настройка регулирования событий для всех категорий:

    1. Установите флажок Все категории.

    2. Выберите уровень журнала событий в списке Событие наименьшей важности для занесения в журнал событий.

    3. Выберите уровень журнала трассировки в списке Событие наименьшей важности для занесения в журнал трассировки.

    Настройка регулирования событий для одной или нескольких категорий:

    1. Установите флажки для требуемых категорий.

    2. Выберите уровень журнала событий в списке Событие наименьшей важности для занесения в журнал событий.

    3. Выберите уровень журнала трассировки в списке Событие наименьшей важности для занесения в журнал трассировки.

    Настройка регулирования событий для одной или нескольких подкатегорий (можно развернуть одну или несколько категорий и выбрать любую подкатегорию):

    1. Нажмите знак плюс (+) рядом с категорией, чтобы развернуть ее.

    2. Установите флажок подкатегории.

    3. Выберите уровень журнала событий в списке Событие наименьшей важности для занесения в журнал событий.

    4. Выберите уровень журнала трассировки в списке Событие наименьшей важности для занесения в журнал трассировки.

    Чтобы вернуть параметры регулирования событий для всех категорий в состояние по умолчанию, выполните следующее:

    1. Установите флажок Все категории.

    2. Выберите пункт Восстановить значения по умолчанию в списке Событие наименьшей важности для занесения в журнал событий.

    3. Выберите пункт Восстановить значения по умолчанию в списке Событие наименьшей важности для занесения в журнал отслеживания.

  4. В разделе Защита журнала событий от переполнения установите флажок Включить защиту журнала событий от переполнения.

  5. В разделе Журнал отслеживания в поле Путь введите путь к папке, в которую требуется записывать журналы.

  6. В поле Число дней хранения файлов журнала введите число дней (1-366), в течение которых требуется хранить файлы журналов. По истечении этого времени журналы будут автоматически удалены.

  7. Чтобы ограничить используемое журналами дисковое пространство, установите флажок Ограничить дисковое пространство для хранения журналов трассировки, а затем введите число гигабайт (ГБ), до которого следует ограничить объем файлов журналов. Когда объем журналов достигает этого уровня, старые журналы автоматически удаляются.

  8. После внесения требуемых изменений на странице "Сбор сведений диагностики" нажмите кнопку ОК.

Настройка ведения диагностического журнала с помощью Windows PowerShell

Для настройки диагностического журнала можно использовать сайт PowerShell.

Процедура настройки ведения диагностического журнала с помощью Windows PowerShell

  1. Убедитесь, что предоставлены следующие разрешения.

    • Предопределенная роль сервера securityadmin для экземпляра SQL Server.

    • Предопределенная роль базы данных db_owner во всех базах данных, которые должны обновляться.

    • Группа администраторов для сервера, на котором выполняются командлеты PowerShell.

    Администратор может использовать командлет Add-SPShellAdmin для предоставления разрешений на использование командлетов PowerShell.

    Примечание

    Если у вас нет разрешений, запросите их у администратора установки или администратора SQL Server. Дополнительные сведения о разрешениях PowerShell см. в статье Add-SPShellAdmin.

  2. В командной консоли SharePoint замените диск, на который сервер записывает журналы.

  3. В командной строке PowerShell введите следующую команду:

    Set-SPDiagnosticConfig -LogLocation D:\DiagnosticLogs
    
  4. Чтобы ограничить использование дискового пространства журналами, в командной строке PowerShell введите следующую команду:

    Set-SPDiagnosticConfig -LogMaxDiskSpaceUsageEnabled
    

    Или назначьте максимальное дисковое пространство для журналов:

    Set-SPDiagnosticConfig -LogDiskSpaceUsageGB 500
    
  5. Чтобы просмотреть текущий уровень ведения журнала, в командной строке PowerShell введите следующую команду:

    Get-SPLogLevel
    
  6. Чтобы изменить уровень ведения журнала, в командной строке PowerShell введите следующую команду:

    Set-SPLogLevel -TraceSeverity Monitorable
    

    Чтобы вернуть все категории на уровни по умолчанию, в командной строке PowerShell введите следующую команду, после чего нажмите клавишу ВВОД:

    Clear-SPLogLevel
    
  7. Чтобы включить защиту журнала событий от переполнения, в командной строке PowerShell введите следующую команду:

    Set-SPDiagnosticConfig -EventLogFloodProtectionEnabled
    

Дополнительные сведения см. в статьях Set-SPDiagnosticConfig, Set-SPLogLevel и Get-SPLogLevel.

See also

Обзор мониторинга в SharePoint Server 2016