Просмотр записей о заданиях в очередях в журналах ULS

  • Статья

 

Последнее изменение раздела: 2015-02-27

Журналы единой службы ведения журнала (ULS) используются для разрешения проблем в Microsoft Office Project Server 2007. Сведения об элементах очередей в журналах ULS особенно полезны совместно с информацией на странице "Управление очередью" в веб-клиенте Project или в средстве просмотра событий Windows Server.

В этой статье описывается:

  • Настройка параметров файлов журнала ULS

  • Настройка Microsoft Office Excel 2007 для просмотра файлов журнала ULS

  • Поиск определенных заданий в журнале ULS

  • Типы записей в журнале ULS

  • Параметры записей

  • Рекомендации по разрешению проблем с очередью

Настройка параметров файлов журнала ULS

Можно настроить параметры файлов ULS с помощью веб-сайта центра администрирования SharePoint. Эта страница позволяет:

  • Указать расположение по умолчанию для хранения файлов журнала.

  • Указать максимальное количество файлов журнала, которые могут храниться на сервере.

  • Указать период времени (в минутах), охватываемый каждым файлом журнала.

NoteПримечание:
Параметры файлов журнала применяются ко всем серверам фермы.

Настройка параметров файла журнала ULS

  1. В центре администрирования щелкните Операции. В разделе Ведение журналов и составление отчетов щелкните Сбор данных диагностики.

  2. На странице сбора данных диагностики в разделеЖурнал трассировки проверьте правильность пути, указанного в поле Путь. Расположение файлов журналов по умолчанию — C:\Program Files\Common Files\Microsoft Shared\Web server extensions\12\LOGS. Чтобы изменить расположение по умолчанию, введите в поле Путь новое значение.

  3. В поле Число файлов журнала укажите максимальное количество файлов журналов, которые хранятся на каждом сервере фермы. Значение по умолчанию — 96.

  4. В поле Число минут на использование файла журнала введите период времени (в минутах), охватываемый каждым файлом журнала. Значение по умолчанию — 30.

  5. Нажмите кнопку ОК.

Имена новых файлов журнала будут иметь следующий формат: имя сервера-год/месяц/день-время.log

Например, файл журнала, созданный 8 июня 2008 года в 13:20 на сервере Contoso, будет называться contoso-20080608-1320.log. Если Число минут на использование файла журнала равно 30, то будут последовательно созданы следующие файлы: contoso-20080608-1320.log contoso-20080608-1350.log, contoso-20080608-1420.log, contoso-20080608-1450.log и т.д.

Настройка Office Excel 2007 для просмотра файлов журнала ULS

Файлы журнала можно просматривать в любом текстовом редакторе, а также в Microsoft Office Excel. Последний позволяет сортировать файлы журнала по столбцам и обеспечивает большую удобочитаемость (особенно для длинных строк).

Настройка Office Excel 2007 для просмотра файлов журнала

  1. В Office Excel 2007 нажмите кнопку Office, а затем нажмите Открыть.

  2. В диалоговом окне Открытие документа перейдите к папке с файлами журнала.

  3. В списке Тип файлов (расположенном справа от поля Имя файла ) выберите Все файлы (*.*) — это позволит увидеть файлы журнала.

    NoteПримечание:
    Чтобы упорядочить список файлов по дате, щелкните правой кнопкой мыши в свободной области списка файлов и выберите Упорядочить значки, а затем нажмите Изменен.

  4. В списке файлов выберите файл журнала, который необходимо просмотреть.

  5. После открытия файла на вкладке Дом нажмите Фильтр и сортировка и затем нажмите Фильтр. Все строки будут отфильтрованы по указанном критерию. Например, если требуется просмотреть только записи Project Server, в столбце "Область" щелкните меню Фильтр, а затем снимите все другие флажки за исключением Project Server.

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

Поиск заданий

Чтобы просмотреть определенную запись в файле журнала, необходимо использовать в веб-клиенте Project страницу "Управление заданиями в очереди" совместно с журналами ULS.

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

Добавление столбца "Идентификатор группы заданий" в таблицу заданий

  1. На странице "Параметры сервера" в веб-клиенте Project в разделе Очередь нажмите Управление очередью.

  2. На странице "Управление заданиями в очереди" нажмите Столбцы.

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

  4. В панели "Таблица заданий" нажмите Обновить состояние и убедитесь, что столбец был добавлен.

После добавления столбца "Идентификатор группы заданий" можно контролировать записи заданий в журналах ULS с тем значением идентификатора группы заданий, которое отображается для задания на странице "Управление заданиями в очереди". Допустим, на странице "Управление заданиями в очереди" в таблице заданий вы заметили, что 8 июня 2008 года в 13:22 задание публикации проекта завершилось с ошибкой. Зная время сбоя, вы можете найти соответствующий файл журнала с информацией о сбое. Например, если период, охватываемый файлом журнала установлен в 30 минут, то файл contoso-20080608-1320.log будет содержать информацию о сбое (поскольку файл охватывает период от 13:20 до 13:50).

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

Просмотр элементов очереди

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

  • Задания, поставленные в очередь. Задание было отправлено Project Server в очередь для обработки.

  • Задания, принятые к обработке. После того, как задание было поставлено в очередь, рабочий поток очереди пытается его обработать.

Задания, поставленные в очередь

Когда задания ставится в очередь, для него в журнал ULS добавляются записи трех типов:

  • Запись о начале группы сообщений

  • Записи об отправке информации о задании в очередь

  • Запись об окончании группы сообщений

Запись о начале группы сообщений. Начальная запись в журнале ULS отмечает начало задания. Она сообщает очереди, что дополнительные данные о задании будут позднее переданы в нее. Пример записи о начале группы сообщений:

05/13/2008 11:24:09.05 w3wp.exe(0x0E38) 0x0160 ProjectServer ProjectServerQueue 8the Medium PWA:hppt://contoso/PWA, SSP:SharedService1, User:Contoso\EvaCorets, PSI: Project.QueueCreateProjectAndCheckOut [QUEUE][SENDER] ProjectQ: BeginMessageGroup(95e48e6e-71ad-4a6b-b997-86693cac4f66,41398775-d4a6-4c10-a523-4d0251d192c1,ProjectCreate,StandardPriority): JobUID: 6c2c97af-06b4-4038-8ee8-d83de92e59a9 ca5ca0b6-1dce-4d76-aefb-fec966aa8fe1

Записи об отправке информации о задании в очередь. После того, как очередь отправила в журнал запись о начале группы сообщений, она отправит несколько записей, связанных с этим заданием и описывающих данные, посланные в очередь. Отслеживать последовательность этих записей позволяет параметр ID. Эти записи могут идти в журнале последовательно или чередоваться с другими записями. Значение GroupUID (идентификатор группы заданий) позволяет отследить записи этого задания в файле журнала. В этот момент задание находится в состояние "Заполнение очереди". Пример записи об отправке информации о задании в очередь:

05/13/2008 11:24:09.07 w3wp.exe (0x0E38) 0x0160 ProjectServer ProjectServerQueue 8thf Medium PWA:http://contoso/PWA, SSP:SharedServices1, User:Contoso\EvaCorets, PSI: Project.QueueCreateProjectAndCheckOut  [QUEUE][SENDER] ProjectQ: Send( Microsoft.Office.Project.Server.BusinessLayer.QueueMsg.ProjectAddToMessage ): ID: 1 GroupUID: 95e48e6e-71ad-4a6b-b997-86693cac4f66  ca5ca0b6-1dce-4d76-aefb-fec966aa8fe1

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

05/13/2008 11:24:09.09 w3wp.exe(0x0E38) 0x0160 ProjectServer ProjectServerQueue 8the Medium PWA:hppt://contoso/PWA, SSP:SharedService1, User:Contoso\EvaCorets, PSI: Project.QueueCreateProjectAndCheckOut [QUEUE][SENDER] ProjectQ: EndMessageGroup(): GroupUID: 6c2c97af-06b4-4038-8ee8-d83de92e59a9 ca5ca0b6-1dce-4d76-aefb-fec966aa8fe1

Задания, принятые к обработке

После успешной постановки задания в очередь оно передается потоку обработки заданий. В процессе обработки задания в журнал поступают два типа записей:

  • Запись о начале обработки группы

  • Запись об успешном завершении обработки группы

Запись о начале обработки группы. Эта запись в журнале ULS означает, что задание было принято к обработке. В этой точке состояние задания будет "Обрабатывается". Пример записи о начале обработки группы заданий:

05/13/2008 11:24:09.55 Microsoft.Office.Project.Server (0x0E9C) 0x1378  ProjectServer   ProjectServerQueue 7h52 Medium PWA:http://Contoso/PWA, SSP:SharedServices1, User:Contoso\EvaCorets, PSI:[QUEUE] ProjectQ: Starting group 95e48e6e-71ad-4a6b-b997-86693cac4f66 type = ProjectCreate priority = StandardPriority   59d07fb9-158f-42b6-ac09-824d592c06c7

Запись об успешном завершении обработки группы заданий. По завершении успешной обработки задания оно отмечается в журнале ULS записью об успешном завершении обработки группы. Задание переходит в состояние "Успешно". Пример записи об окончании обработки группы:

05/13/2008 11:24:11.52 Microsoft.Office.Project.Server (0x0E9C) 0x1378  ProjectServer  ProjectServerQueue 7h5o Medium PWA:http://Contoso/PWA, SSP:SharedServices1, User:Contoso\EvaCorets, PSI:[QUEUE] ProjectQ: Group completed successfully: 95e48e6e-71ad-4a6b-b997-86693cac4f66 type = ProjectCreate 59d07fb9-158f-42b6-ac09-824d592c06c7

Параметры записей

Все записи в журнале ULS содержат следующие параметры:

Параметр Описание

PWA:http://contoso/PWA

Экземпляр Project Server, обрабатывающий задание очереди. В этом примере: "http://contoso/PWA".

SSP:ShareService1

Поставщик общих служб, инициатор задания (для экземпляра Project Server). В этом примере: "SharedService1".

User:Contoso\EvaCorets

Владелец задания. В данном примере это пользователь Windows с псевдонимом EvaCorets.

PSI: WinProj.PreSaveProject

Описывает вызов интерфейса Project Server Interface, который производится посредством задания. В этом примере WinProj.PreSaveProject означает, что вызовом интерфейса PSI является операция сохранения проекта Project Professional.

[SENDER]

Информирует, что сообщение посылается в очередь.

[QUEUE]

Определяет главные и рабочие потоки очереди.

[SERVICE]

Определяет процесс Queue Watcher Process.

[QSERVICE]

Определяет процесс Queue Worker Process.

ProjectQ:

Определяет очередь заданий проектов (в противоположность очереди заданий расписаний).

ProjectSave

Указывает, что задание имеет тип "Сохранено из веб-клиента Project". Тип задания добавляется записям, имеющим Type = in Starting Group или Group Completed Successfully.

StandardPriority

Устанавливает приоритет задания. Задания с низким приоритетом (например, запись в базу данных отчетности, выполняемую заданием опубликованного проекта) будут переданы в обработку после заданий с более высоким приоритетом. Приоритет добавляется записям, имеющим Priority = in Starting Group или Group Completed Successfully.

JobUID: de2f…

Определяет идентификатор задания. Это значение соответствует значению идентификатора задания на странице "Управление заданиями в очереди" в настройках Project Web Access Server.

NoteПримечание:
Значения идентификатора в последнем столбце записи задания в журналах ULS обычно могут быть соотнесены со значением идентификатора группы заданий на странице "Управление заданиями в очереди" в настройках Project Web Access Server.

Дополнительные сведения о потоках и процессах очереди см. в статье Система постановки в очередь Microsoft Office Project Server 2007.

См. также

Понятия

Система постановки в очередь Microsoft Office Project Server 2007
Рекомендации по вопросам устранения неполадок очереди Project Server
Настройка максимального числа потоков обработки заданий в службе очередей Project Server
Устранение неполадок заданий в очереди при получении состояния в очереди