### 生成報告 > What the world really needs is more love and less paperwork. > > — Pearl Bailey 大型的基礎設施架構往往是真正的第一受害者。如果你正管理著許多機器， 那么使用 Puppet 的報告設施，可以為你提供一些關于正在發生什么的有價值的信息。 #### 操作步驟 要啟用報告，只要將如下的行加入客戶端的 puppet.conf 文件： ``` report = true ``` #### 工作原理 啟用報告之后，Puppet 將在 Puppetmaster 上生成報告文件，包含如下的數據： * 從 Puppetmaster 獲取配置所需要的時間 * Puppet 的總體運行時間 * 運行期間的日志消息輸出 * 客戶端配置清單中的所有資源列表 * Puppet 是否改變了每個資源 * 一個資源是否與配置清單不同步 默認情況下，這些報告存儲在 /var/lib/puppet/reports 目錄下，你也可以使用 reportdir 參數指定到不同的位置。你可以創建自己的腳本處理這些報告 （這些報告都是標準的 **YAML** 格式），或者使用工具，例如 **Puppet Dashboard** 來獲得您的網絡圖形概覽。 #### 更多用法 在下文中將解釋從 Puppet 報告中收集信息的幾個實用技巧。 ##### 從命令行啟用報告 如果你只是想要一個報告，或者你不想讓所有客戶端都發送報告， 你可以切換到命令行，手動執行帶有 --report 參數的命令： ``` # puppet agent --test --report ``` 你還可以使用如下帶有 --summarize 參數的命令看到關于 Puppet 的運行統計概要信息： ``` # puppet agent --test --summarize info: Retrieving plugin info: Caching catalog for cookbook.bitfieldconsulting.com info: Applying configuration version '1306169315' notice: Finished catalog run in 0.58 seconds Changes: Events: Resources: Total: 7 Time: Config retrieval: 3.65 Filebucket: 0.00 Schedule: 0.00 ``` ##### 將 Puppet 的信息記入系統日志 Puppet 也可以將日志信息發送到 Puppetmaster 的 **系統日志（syslog）**， 因此你可以使用標準的 syslog 工具分析這些日志消息。 為了實現這一點，你可以在 Puppetmaster 的配置文件 puppet.conf 中添加如下所示的選項： ``` [master] reports = store,log ``` 默認的報告類型是 store （將報告輸出到 /var/lib/puppet/reports）， log 選項是告訴 Puppet 同時將消息發送到 syslog。 #### 參見本書 * 本章的 [創建圖形化報告](#ch02sec03) 一節 * 本章的 [輸出調試信息](#ch02sec11) 一節 * 第 9 章的 [使用 Puppet Dashboard](#ch09sec05) 一節