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

ОБЛАСТЬ ПРИМЕНЕНИЯ:yes-img-132013 yes-img-162016 yes-img-192019 yes-img-seSubscription Edition no-img-sopSharePoint в Microsoft 365

Предварительные требования

Выполнять процедуры в центре администрирования могут только члены группы 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-SPLogLevel PowerShell и содержит очень подробные диагностические данные. Этот уровень должен использоваться только в средах разработки. На этом уровне в журнал добавляются также все события, которые записываются на уровне Verbose.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Настройка ведения журнала диагностики с помощью 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
  1. Чтобы просмотреть текущий уровень ведения журнала, в командной строке PowerShell введите следующую команду:

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

    Set-SPLogLevel -TraceSeverity Monitorable
    

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

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

    Set-SPDiagnosticConfig -EventLogFloodProtectionEnabled
    

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

См. также

Понятия

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