Обзор сбора данных диагностики в службах Business Connectivity Services (SharePoint Foundation 2010)

Статья
02/12/2017

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

Последнее изменение раздела: 2016-11-30

Для устранения неполадок, связанных с Microsoft Business Connectivity Services на серверах с Microsoft SharePoint Foundation 2010 можно воспользоваться журналами событий и трассировки на клиентском компьютере или сервере. Кроме того, с каждой записью в журнале событий или трассировки связан идентификатор операции, который можно использовать для трассировки проблемы от сервера к внешнему источнику данных.

Примечание

Помимо обсуждаемых в этом разделе методов ведения журнала, можно воспользоваться пакетом управления Microsoft System Center Operations Manager для наблюдения за решением на основе Microsoft Business Connectivity Services. Дополнительные сведения о настройке пакета управления System Center Operations Manager см. в руководстве, входящем в комплект загрузки пакета управления на странице Пакет управления для продуктов Microsoft SharePoint 2010 (https://go.microsoft.com/fwlink/?linkid=184971&clcid=0x419).

Содержание:

Сбор данных диагностики в службах Business Connectivity Services
Сведения об идентификаторах операций
Сбор данных диагностики на серверах
Пример. Использование сбора данных диагностики

Сбор данных диагностики в службах Business Connectivity Services

Для решений на основе Microsoft Business Connectivity Services сбор данных диагностики осуществляется на серверах, на которых выполняется Microsoft SharePoint Foundation. Существует два журнала: журнал событий и журнал трассировки. В обоих записываются сведения диагностики, создаваемые Microsoft Business Connectivity Services. В журналах событий фиксируются сообщения об ошибках. В журналах трассировки — более подробные сведения, такие как трассировки стеков и информационные сообщения. В общем случае данные в журналах трассировки подробнее, чем в журналах событий.

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

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

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

Уровень	Определение
Не используется	В журнал ничего не записывается.
Критическое	Этот тип сообщений указывает на наличие серьезной ошибки, которая привела к серьезному сбою в приложении.
Ошибка	Этот тип сообщений указывает на наличие срочного условия. Необходимо изучить все события ошибок.
Предупреждение	Этот тип сообщений указывает на наличие потенциальной проблемы, требующей внимания. Предупреждения следует проверить и наблюдать за закономерностями их возникновения.
Сведения	Информационные сообщения не требуют никаких действий, но в них могут содержаться ценные данные для отслеживания состояния решения.
Подробный	Этот уровень ведения журнала соответствует длительным событиям или длинным сообщениям.

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

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

Журналы диагностики полезны как в среде разработки, так и в производственной среде, однако в зависимости от типа условий требования к уровню ведения журналов могут отличаться. При планировании сбора данных диагностики в службах Microsoft Business Connectivity Services рекомендуется учесть потребности бизнеса и этап жизненного цикла среды и лишь затем задавать уровень ведения журнала.

Например, во время разработки решения в целях отладки для обоих уровней ведения журналов можно задать значение "Подробный", что обеспечит запись всех созданных сообщений о состоянии системы. И наоборот, в производственной среде в журналах трассировки может потребоваться зафиксировать только сообщения уровней "Высокий", "Контролируемый" и "Непредвиденный", а в журналах событий — сообщения уровня "Критический" и "Ошибка". В этом случае можно сократить объем дискового пространства, выделяемого под сбор сведений, и ограничить отрицательное влияние ведения журнала.

Сведения об идентификаторах операций

Для каждой операции создания, обновления или удаления внешних данных в решении на основе Microsoft Business Connectivity Services создается уникальное значение GUID, именуемое идентификатором операции. Вся информация, связанная с операцией и заносимая в журнал трассировки или событий сопровождается идентификатором операции.

Важно!

В файлах журналов событий и журналов трассировки на сервере значения идентификатора операции помечаются как "CorrelationId".

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

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

Совет

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

Сбор данных диагностики на серверах

По умолчанию на серверах SharePoint Foundation включено ведение журналов служб Microsoft Business Connectivity Services. По умолчанию используются следующие уровни ведения журнала.

Для журнала событий: "Критический" и "Ошибка".
Для журнала трассировки: "Средний".

Если сбор данных диагностики служб Microsoft Business Connectivity Services по какой-либо причине был отключен, включите его, выбрав Business Connectivity Services на странице "Сбор данных диагностики" в центре администрирования SharePoint Foundation. Для настройки журналов событий и журналов трассировки на сервере можно воспользоваться Windows PowerShell. Например, можно изменить диск, на который записываются данные, или задать уровень подробности ведения журнала.

Дополнительные сведения о ведении журналов в SharePoint Foundation 2010, например об установке расположения файлов журнала, см. в разделе Configure diagnostic logging (SharePoint Foundation 2010).

С помощью Windows PowerShell можно просматривать журналы на сервере и экспортировать их, например, в программу для работы с электронными таблицами. Дополнительные сведения см. в разделе View diagnostic logs (SharePoint Foundation 2010).

Microsoft Business Connectivity Services вводит в журнал трассировки на интерфейсных веб-серверах SharePoint Foundation две категории: BDC_Shared_Services и SS_Shared_Service. Журнал трассировки открывается с помощью средства просмотра событий, после чего выполняется фильтрация связанных записей журнала по условию поиска "SPS_BusinessData" (для результатов Microsoft Business Connectivity Services) и "SPS_SecureStoreService".

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

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

Для Microsoft Business Connectivity Services в ферме серверов уровням ведения журнала заданы значения по умолчанию:

Для журнала событий: "Критический" и "Ошибка".
Для журнала трассировки: "Средний".

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

Специалист технической поддержки выясняет, что приложение по работе с картами табельного учета основано на службах Microsoft Business Connectivity Services. Он проверяет журнал событий, но не находит ошибок, связанных с подлинностью пользователя в момент отправки им запроса. Затем он проверяет журнал трассировки, где находит подтверждение деятельности: операцию обновления, связанную с пользователем и произошедшую в указанное пользователем время. Операция обновления в журнале трассировки содержит значение идентификатора операции, который фиксируется специалистом службы технической поддержки.

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

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