在 SharePoint Server 中設定診斷記錄

適用于:yes-img-132013 yes-img-16 2016yes-img-192019 yes-img-se訂閱版本 no-img-sopMicrosoft 365 中的 SharePoint

先決條件

從 管理中心 執行此程序的使用者帳戶必須是 SharePoint 伺服器陣列管理員群組的成員。

診斷記錄設定的最佳作法

在初始部署或升級後,以及若對環境做出變更,SharePoint Server 環境可能需要組態診斷記錄的設定。 下列清單中的指南可協助您建立特定環境的最佳作法。

  • 變更伺服器寫入記錄的磁碟。

    根據預設,SharePoint Server 會將診斷記錄寫入本身安裝所在的相同磁碟和磁碟分割。 因為診斷記錄會使用大量的磁碟空間,而影響磁碟效能,因此建議您設定 SharePoint Server 寫入至未安裝 SharePoint Server 的其他磁碟。 您也應該要考慮 SharePoint Server 寫入記錄之磁碟的連線速度。 如果設定詳細資訊層級記錄,則伺服器會記錄大量的資料。 因此,遲緩的連線可能會導致記錄效能不佳。

  • 限制記錄的磁碟空間使用量。

    根據預設,診斷記錄可使用的磁碟空間是不受限制的。 因此,尤其若將記錄設定為寫入詳細資訊層級的事件時,請限制記錄使用的磁碟空間。 當達到磁碟限制時,SharePoint Server 會在記錄新的記錄資料前,移除最舊的記錄。

  • 謹慎使用詳細資訊設定。

    您可以將診斷記錄設定為記錄詳細資訊層級的事件。 這表示 SharePoint Server 會記錄所採取的每個動作。 詳細資訊層級記錄會快速使用磁碟空間,而影響磁碟與伺服器的效能。 您可以在做出重要變更時,使用詳細資訊層級記錄以記錄更多細節,然後在做出變更後將記錄重新設定為僅記錄較高層級的事件。

  • 定期備份記錄。

    診斷記錄包含重要的資料。 因此,定期備份記錄可確保此資料被保留下來。 在限制記錄的磁碟空間使用量時,或如果只將記錄保留幾天的時間,則在達到臨界值時,SharePoint Server 將自動刪除記錄檔案 (從最舊的檔案開始)。

  • 啟用事件記錄檔湧入保護。

    啟用此設定時,SharePoint Server 會偵測 Windows 事件記錄檔中的重複事件,並在狀況回復至一般狀態時才不再隱藏重複事件。

您可以設定事件記錄檔和追蹤記錄檔的診斷記錄層級。 這會限制可寫入每個記錄檔的資訊類型和數量。 下表定義事件記錄檔和追蹤記錄檔可用的記錄層級:

事件記錄檔層級

層級 定義

不會記錄。
重要
此訊息類型表示發生嚴重錯誤,導致解決方案重大失敗。
錯誤
此訊息類型表示緊急狀況。 您應調查所有錯誤事件。
警告
此訊息類型表示可能需要加以留意的潛在問題。 您應檢視並追蹤一段時間內所發生的警告訊息,以找出其模式。
資訊
不需對資訊訊息採取任何動作。 不過該訊息對監視解決方案的狀態提供寶貴的資料。
詳細資訊
此事件記錄檔層級會記錄冗長的事件或訊息。

追蹤記錄檔層級

層級 定義

不寫入追蹤記錄檔。
未預期
此層級會記錄的訊息是有關導致解決方案停止處理的事件。 設定為此層級時,記錄檔會包括未預期、例外狀況、判斷提示和重要層級的事件。
可監控
此層級會記錄的訊息是有關限制解決方案的功能,但未停止應用程式之所有無法復原的事件。 設定為此層級時,記錄檔也會包括「未預期」設定所記錄的事件。

此層級會記錄所有未預期但未停止解決方案處理的事件。 記錄檔設定為此層級時,記錄檔也會包括「可監控」設定所記錄的所有事件。

設為此層級時,追蹤記錄檔會包括除了「詳細資訊」和 VerboseEx 訊息之外的所有訊息。 此層級會記錄所有有關所執行操作的高階資訊。 此層級提供了足夠的詳細資訊,可建構資料流程和操作順序。 系統管理員或支援專業人員可使用此記錄層級對問題進行疑難排解。 若設為此層級,記錄檔也會包括「高」設定所記錄的所有事件。
詳細資訊
若設為此層級,記錄檔會包括大部分動作。 詳細資訊追蹤會產生很多記錄訊息。 此層級通常僅用於開發環境的偵錯作業。 記錄檔若設定為此層級,記錄檔也會包括「中」設定所記錄的所有事件。
VerboseEx
此層級僅由 Set-SPLogLevel PowerShell Cmdlet 支援,且會包括極低層級的診斷資料。 只應在開發環境中使用此層級。 若定為此層級,記錄檔也會包括「詳細資訊」設定所記錄的所有事件。

使用管理中心設定診斷記錄

您可以使用 SharePoint 管理中心網站來設定診斷記錄。

使用管理中心設定診斷記錄

  1. In Central Administration, on the home page, click Monitoring.

  2. 在 [監視] 頁面上,按一下 [報告] 區段中的 [設定診斷記錄]

  3. 在 [診斷記錄] 頁面的 [事件節流] 區段中,按照下列方式設定事件節流:

    設定所有類別的事件節流:

  4. 選取 [所有類別] 核取方塊。

  5. 選取 [回報至事件記錄的最低緊急事件] 清單中的事件記錄檔層級。

  6. 選取 [回報至追蹤記錄的最低緊急事件] 清單中的追蹤記錄層級。

    設定一或多個類別的事件節流:

  7. 選取所需類別的核取方塊。

  8. 選取 [回報至事件記錄的最低緊急事件] 清單中的事件記錄檔層級。

  9. 選取 [回報至追蹤記錄的最低緊急事件] 清單中的追蹤記錄層級。

    設定一或多個子類別的事件節流 (您可以展開一或多個類別,並選取任何子類別):

  10. 按一下類別旁的加號 [(+)] 展開類別。

  11. 選取子類別的核取方塊。

  12. 選取 [回報至事件記錄的最低緊急事件] 清單中的事件記錄檔層級。

  13. 選取 [回報至追蹤記錄的最低緊急事件] 清單中的追蹤記錄層級。

    若要將所有類別的事件節流回復為預設設定:

  14. 選取 [所有類別] 核取方塊。

  15. 選取 [回報至事件記錄的最低緊急事件] 清單中的 [重設為預設]

  16. 選取 [回報至追蹤記錄的最低緊急事件] 清單中的 [重設為預設]

  17. 在 [防止事件記錄檔濫記] 區段中,選取 [啟用防止事件記錄檔濫記] 核取方塊。

  18. 在 [追蹤記錄] 區段的 [路徑] 方塊中,輸入要寫入記錄的資料夾路徑。

  19. In the Number of days to store log files box, type the number of days (1-366) that you want logs to be kept. After this time, logs will automatically be deleted.

  20. To restrict the disk space that logs can use, select the Restrict Trace Log disk space usage check box, and then type the number gigabytes (GB) you want to restrict log files to. When logs reach this value, older logs will automatically be deleted.

  21. 在 [診斷記錄] 頁面上進行所需變更後,請按一下 [確定]

使用 PowerShell 設定診斷記錄

您可以使用 PowerShell 來設定診斷記錄。

使用 PowerShell 設定診斷記錄

  1. 確認您具備下列成員身分:

    • SQL Server 執行個體上的 securityadmin 固定伺服器角色。

    • 所有要更新之資料庫上的 db_owner 固定資料庫角色。

    • 正在執行 PowerShell Cmdlet 之所在伺服器上的系統管理員群組。

    系統管理員可以使用 Add-SPShellAdmin Cmdlet 授與使用 PowerShell Cmdlet 的權限。

    注意事項

    [!附註] 如果您不具備上述權限,請連絡安裝程式系統管理員或 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 命令提示字元處,輸入下列命令 ,然後按 ENTER :

Clear-SPLogLevel
  1. 若要啟用事件記錄檔湧入保護,請在 PowerShell 命令提示字元處,輸入下列命令:

    Set-SPDiagnosticConfig -EventLogFloodProtectionEnabled
    

如需詳細資訊,請參閱 Set-SPDiagnosticConfigSet-SPLogLevelGet-SPLogLevel

另請參閱

概念

SharePoint Server 2016 監視概觀