共用方式為

檢視佇列工作項目的 ULS 記錄檔

  • 發行項

 

上次修改主題的時間： 2015-02-27

您可以使用伺服器的統一登入服務 (ULS) 記錄檔疑難排解 Microsoft Office Project Server 2007 的佇列問題。ULS 記錄檔中的佇列項目資訊，在與 Project Web Access 中的 [管理佇列] 頁面資訊或 Windows Server 事件檢視器搭配時特別實用。

本文說明：

  • 如何設定 ULS 記錄檔的設定

  • 如何設定 Microsoft Office Excel 2007 以檢視 ULS 記錄檔

  • 如何從搜尋 ULS 記錄檔中搜尋特定的佇列工作

  • ULS 記錄檔中的佇列工作項目類型

  • 佇列項目參數

  • 疑難排解佇列問題的最佳作法

設定 ULS 記錄檔的設定

您可以利用 SharePoint 管理中心網站設定 ULS 記錄檔的設定。在此頁面上，您可以：

  • 指定儲存記錄檔的預設位置。

  • 指定伺服器上所能儲存的記錄檔數目上限。

  • 指定每份記錄檔所能涵蓋的時間長度 (分鐘)。

Note附註：
這些記錄檔設定會套用到伺服器陣列中的所有伺服器。

設定 ULS 記錄檔的設定

  1. 在管理中心內，按一下 [作業]。在 [記錄與報告] 區段中，按一下 [診斷記錄]。

  2. 在 [診斷記錄] 頁面的 [追蹤記錄] 區段中，確認 [路徑] 欄位中所指定的位置。預設位置為 C:\Program Files\Common Files\Microsoft Shared\Web server extensions\12\LOGS。若要變更位置，請在 [路徑] 欄位中輸入新的位置。

  3. 在 [記錄檔數目] 欄位中，指定伺服器陣列之每部伺服器上所能儲存的記錄檔數目上限。預設值為 96。

  4. 在 [要使用記錄檔的分鐘數] 欄位中，輸入每份記錄檔的持續時間 (分鐘)。預設值為 30。

  5. 按一下 [確定]。

新記錄檔會以下列格式命令：[servername-year/month/day-time.log]

例如，在 2008 年 6 月 8 日下午 1: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 都可檢視記錄檔。Excel 可以依直欄排序記錄檔，同時亦比較容易閱讀 (尤其是查看內含長字串資料的列時)。

設定 Office Excel 2007 以檢視追蹤記錄檔

  1. 在 Office Excel 2007 中，按一下 [Office] 按鈕，然後按一下 [開啟]。

  2. 在 [開啟] 對話方塊中，瀏覽至記錄檔的位置。

  3. 在 [檔案類型] 清單中 (位於 [檔案名稱] 欄位右側) 選取 [所有檔案 (*.*)]，如此即可看到記錄檔。

    Note附註：
    若要依日期排列檔案清單，請以滑鼠右鍵按一下檔案清單中的開放區域，再按一下 [排序方式]，然後按一下 [修改日期]。

  4. 從檔案清單中選取您要檢視的記錄檔。

  5. 當記錄檔出現之後，請在 [首頁] 索引標籤上按一下 [排序及篩選]，然後按一下 [篩選]。如此即可依特定準則篩選所有列。例如，若只要檢視 Project Server 項目，可以按一下 [區域] 欄中的 [篩選] 功能表，然後清除 [Project Server] 以外的所有其他選項。

  6. 選取 [訊息] 欄。在 [首頁] 索引標籤上按一下 [格式]，然後按一下 [儲存格格式]。在 [儲存格格式] 頁面上，按一下 [對齊方式]，然後在 [文字控制] 區段中選取 [自動換行]。按一下 [確定]。訊息資料可能會很長，因此將直欄設定為自動換行，會比較容易檢視資料。

搜尋特定的佇列工作

若要從記錄檔中搜尋特定的項目，必須並用 Project Web Access 的 [管理佇列工作] 頁面與 ULS 記錄檔。

每個佇列工作都有工作群組識別碼。您可以利用此資料搜尋記錄檔。首先必須將 [工作群組識別碼] 欄新增到您的 [工作格線]。完成後，即可在 ULS 記錄檔中尋找特定值。

新增工作群組識別碼欄至工作格線

  1. 在 Project Web Access 中的 [伺服器設定] 頁面上，按一下 [佇列] 區段中的 [管理佇列]。

  2. 在 [管理佇列工作] 頁面上，按一下 [欄]。

  3. 在 [可用欄位] 清單中，選取 [工作群組識別碼]。按一下 [新增]，將工作群組識別碼移至 [選取的欄] 清單。

  4. 在 [工作格線] 工具列中，按一下 [重新整理狀態]，並確認已新增該欄。

新增 [工作群組識別碼] 欄之後，可以對照 [管理佇列工作] 頁面上該工作的對應工作群組識別碼值，檢查 ULS 記錄檔中的工作佇列項目。例如在 [管理佇列工作] 頁面上的 [工作格線] 中，假設您發現某專案發佈工作在 2008 年 6 月 8 日下午 1:22 失敗了。根據失敗的時間，您知道您可以找到人包含該失敗資訊的正確記錄檔。例如「記錄檔持續時間」 (要使用記錄檔參數的分鐘數) 若設為 30 分鐘，contoso-20080608-1320.log 就會包含該失敗資訊，因為範圍是從下午 1:20 到 1:50。

開啟記錄檔之後，可以使用欄位篩選搜尋屬於特定佇列工作的所有項目。例如，[關聯] 欄可讓您依據工作群組識別碼進行篩選。您也可以藉由篩選 [時間戳記] 欄 (依據失敗的時間)、[區域] 欄 ( 篩選 "Project Server") 或 [類別] 欄 (篩選「Project Server 佇列」) 縮小搜尋範圍。

檢視佇列項目元件

檢視 ULS 記錄檔中的佇列項目時，請注意其可區分為兩種功能類型：

  • **傳送至佇列的工作：**工作從 Project Server 傳送至佇列進行處理。

  • **挑選要處理的工作：**工作成功地傳送至佇列之後，佇列工作者執行緒嘗試處理該工作。

傳送至佇列的工作

當工作順利傳送至佇列之後，通常會在 ULS 記錄檔中顯示三種佇列工作項目的類型：

  • begin-message-group 項目

  • 傳送工作相關資料至佇列的項目

  • end-message-group 項目

**Begin-message-group 項目：**在 ULS 記錄檔中，第一個佇列工作項目是指出工作開始的標籤。其告訴佇列接著還會再傳送其他工作相關資料至其中。以下是 Begin-message-group 工作項目的範例：

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

**傳送工作相關資料至佇列的項目：**當佇列工作傳送 begin-message-group 項目之後，可能會有數個工作相關項目傳送至佇列。您可以透過識別碼參數值追蹤這些項目的順序。這些項目可能會依序出現在記錄檔中，也可能會散落在某段時間內，混列在其他記錄項目之間。您可以在記錄檔中使用工作的群組 UID 號碼追蹤工作的項目。此時工作的狀態會是「加入佇列中」。以下是工作相關項目的範例：

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

**end-message-group 項目：**當佇列收到佇列工作的所有資料時，會傳送end-message-group 項目至佇列。在收到此項目之前，佇列工作會處於「加入佇列中」狀態。該工作會在成功收到 end-message-group 項目之後轉為「等待處理中」狀態。以下是 end-message-group 項目的範例：

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

挑選要處理的工作

工作成功地提交至佇列之後，最後會由工作的工作者執行緒進行挑選處理。有兩種工作類型與此相關：

  • starting-group 項目

  • group-completed-successfully 項目

**starting-group 項目：**ULS 記錄檔中的starting-group 項目表示工作已開始進行處理。此時工作的狀態會是「處理中」。以下是 starting-group 項目的範例：

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

**group-completed-successfully 項目：**當工作成功完成處理時，會在項目 ULS 記錄檔中將工作標記為 group-completed-successfully。該工作的狀態會是「成功」。以下是 group-completed-successfully 項目的範例：

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

說明佇列工作的擁有者。在此範例中是別名為 EvaCorets 的 Windows 使用者。

PSI: WinProj.PreSaveProject

說明透過工作執行的 Project Server Interface (PSI) 呼叫。在此範例中，WinProj.PreSaveProject 代表透過 Project Professional 執行之專案儲存作業的 PSI 呼叫。

[SENDER]

表示正在將訊息傳送至佇列。

[QUEUE]

定義佇列的主要執行緒及佇列工作者執行緒。

[SERVICE]

定義佇列監看員處理序。

[QSERVICE]

定義佇列工作者處理序。

ProjectQ:

定義專案佇列 (與時程表佇列相反)。

ProjectSave

指定工作類型是從專案用戶端儲存。工作類型會附加 Type = in Starting Group 或 Group Completed Successfully 項目。

StandardPriority

說明工作優先順序。會先挑選優先順序較高的工作，再挑選優先順序較低的工作 (例如寫入專案發佈工作所衍生的報告資料庫) 進行處理。優先順序會附加 Priority = in Starting Group 或 Group Completed Successfully 項目。

JobUID: de2f…

定義佇列工作的 UID。工作 UID 值會與 [Project Web Access Server 設定] 之 [管理佇列工作] 頁面上的佇列工作 ID 值相對應。

Note附註：
在 ULS 記錄檔中，佇列工作項目最後一欄中的 UID 值，通常會與 [Project Web Access Server 設定] 中 [管理佇列工作] 頁面上的工作群組 UID 值相關聯。

如需佇列執行緒及處理序的詳細資訊，請參閱＜Microsoft Office Project Server 2007 佇列系統＞。

另請參閱

概念

Microsoft Office Project Server 2007 佇列系統
疑難排解 Project Server 佇列問題的最佳作法
設定 Project Server 佇列服務之工作處理器執行緒上限
疑難排解狀態為放入佇列的佇列工作