Просмотр журналов диагностики в SharePoint Server

 

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

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

Сводка. Изучение просмотра и фильтрации событий журнала с помощью Windows PowerShell, а также просмотра и экспорта журналов диагностики с помощью командлета Out-GridView .

Вы можете устранять проблемы в ферме, используя данные из журналов единой службы ведения журналов (ULS) в SharePoint Server. Журналы ULS могут собирать данные на различных уровнях в зависимости от параметров. Используйте PowerShell для фильтрации данных, изменения режимов просмотра и создания сетки, в которой данные можно фильтровать, сортировать, группировать и экспортировать в Excel 2016.

В этой статье

Разделы статьи:

  • Просмотр и фильтрация событий журнала с помощью Windows PowerShell

  • Просмотр и экспорт журналов диагностики с помощью командлета Windows PowerShell Out-GridView

Просмотр и фильтрация событий журнала с помощью Windows PowerShell

Для просмотра и фильтрации событий журнала.можно использовать PowerShell. Нельзя просматривать или фильтровать события журнала с помощью веб-сайта Веб-сайт центра администрирования SharePoint.

Просмотр и фильтрация событий журнала с помощью Windows PowerShell

  1. Убедитесь, что у вас есть членство в следующих группах:

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

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

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

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

    Примечание

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

  2. Перейдите в командную консоль SharePoint.

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

    • Все события трассировки:

      Get-SPLogEvent
      
    • По уровню:

      Get-SPLogEvent | Where-Object {$_.Level -eq "Information" }
      
    • По области:

      Get-SPLogEvent | Where-Object {$_.Area -eq <Area>}
      

      где <область> — значение свойства Area.

    • По категории:

      Get-SPLogEvent | Where-Object {$_.Category -eq <Category>
      

      Здесь <категория> — это значение свойства Category.

    • По идентификатору события:

      Get-SPLogEvent | Where-Object {$_.EventID -eq <EventID>}
      

      где <код события> — значение свойства EventID.

    • По тексту сообщения:

      Get-SPLogEvent | Where-Object {$_.Message -like "<string>"}
      

      где <строка> — строка в сообщении события.

    • По процессу:

      Get-SPLogEvent | Where-Object {$_.Process -like "<Process>"}
      

      Здесь <процесс> — это значение свойства Process.

    По умолчанию команда получает данные из папки журналов ULS по умолчанию. Чтобы просмотреть и отфильтровать события трассировки, размещаемые в общей папке в сети, используйте параметр Directory командлета Get-SPLogEvent.

    Чтобы просмотреть более подробные сведения о каждом событии, используйте командлет Format-List в конце команды. Например:

    Get-SPLogEvent | Where-Object {$_.Area -eq "SharePoint Foundation"} | Format-List
    

Дополнительные сведения см. в разделе Get-SPLogEvent.

Просмотр и экспортирование журналов диагностики с помощью командлета Windows PowerShell Out-GridView

PowerShell предоставляет мощный и простой компонент, отображающий табулированные данные, получаемые от команд Microsoft PowerShell, в отдельном окне в массиве данных, который можно фильтровать и по которому можно выполнять поиск. Можно использовать этот массив для просмотра событий журнала и выполнения следующих операций с данными:

  • Сортировка данных по любому столбцу.

  • Просмотр данных по группам.

  • Фильтрация данных по уровню, области, категории, сообщению, коду события или метке времени.

  • Поиск данных по любой строке.

  • Экспортирование сырых данных, сортированных или фильтрованных данных в электронную таблицу.

Примечание

Командлет Out-GridView не может использоваться с командлетами, использующими оператор Format. Командлет Out-GridView получает объекты, в то время как командлеты, использующие оператор Format, возвращают форматированный текст.
Вы можете просматривать подмножество данных с помощью командлета Where-Object, который фильтрует результаты и передает их в командлет Out-GridView. Например: Get-SPLogEvent | Where-Object {$_.Area -eq "SharePoint Foundation"} | Out-GridView.
Если массив отображает более нескольких сотен столбцов, он может работать медленно, особенно при выполнении сложных операций фильтрации. Для увеличения производительности экспортируйте данные в Excel 2016.

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

  1. Убедитесь, что у вас есть членство в следующих группах:

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

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

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

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

    Примечание

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

  2. Перейдите в командную консоль SharePoint.

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

    Get-SPLogEvent | Out-GridView
    
  4. Чтобы отсортировать столбцы, щелкните заголовок столбца.

  5. Чтобы выполнить поиск определенной строки, введите строку в поле Фильтр. Поиск выполняется по всем столбцами и строкам. Чтобы очистить результаты поиска, нажмите X.

  6. Чтобы отфильтровать данные только по одному критерию, введите следующее в поле Поиск: <имя свойства>:<значение>. Например, чтобы найти все записи журнала, сделанные SharePoint Foundation 2013, введите следующее: Area:SharePoint Foundation. Чтобы очистить фильтр, нажмите X.

  7. Чтобы отфильтровать данные, используя более одного условия, или используя условия с методами “содержит", "начинается с", "заканчивается на" или другими, выполните следующие действия.

    1. Нажмите кнопку Добавить условие.

    2. Установите флажок для свойств, которые требуется отфильтровать, а затем нажмите кнопку Добавить.

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

    4. Введите значение в текстовое поле.

    5. Повторите шаги “в” и "г” для каждого свойства, выбранного в шаге “б”.

    6. После задания всех условий фильтрации появятся данные, соответствующие этим условиям.

    7. Чтобы очистить определенный фильтр, нажмите кнопку X.

    8. Чтобы очистить все фильтры, сверните представление запроса и нажмите кнопку Очистить все.

Экспорт данных массива в электронную таблицу

  1. Выберите строки, которые требуется экспортировать. Можно выбрать несколько строк: с помощью сочетания нажатия клавиш SHIFT и перетаскивания можно выбрать блок строк; с помощью сочетания нажатия клавиши CTRL и щелчка можно выбрать определенные строки; а сочетание клавиш CTRL+A позволяет выбрать все строки.

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

  2. Скопируйте выделенные строки с помощью сочетания клавиш CTRL+C.

  3. Откройте страницу книги электронной таблицы и затем вставьте скопированные строки в нее с помощью сочетания клавиш CTRL+V.

Дополнительные сведения см. в разделе Out-GridView (https://go.microsoft.com/fwlink/p/?LinkId=181248) и Out-GridView (пересмотрено) (https://go.microsoft.com/fwlink/p/?LinkId=181249).