Sun Java System Message Queue 3.7 UR1 管理指南

配置及使用代理程式記錄功能

Message Queue 記錄程式會取得代理程式程式碼、除錯程式和度量產生器所產生的資訊，並且將這些資訊寫入數個輸出通道：標準輸出 (主控台)、記錄檔，以及 Solaris™ 作業系統上的 syslog 常駐程式程序。

您可以指定記錄程式收集的資訊類型，以及寫入每個輸出通道的類型。要特別注意的是，您可以指定您要寫入記錄檔的度量資訊。

本節描述代理程式的預設記錄配置，並介紹如何將記錄資訊重新導向至替代輸出通道、如何變更記錄檔自動重建準則，以及如何將度量資料傳送到記錄檔。

預設記錄配置

代理程式會自動配置為將記錄輸出儲存到一組自動重建的記錄檔中。這些記錄檔的所在目錄名稱，與相關聯代理程式之實例名稱相同 (請參閱附錄 AMessage Queue^TM 資料的特定平台位置)：

…/instances/instanceName/log

備註 –

如果代理程式的生命週期由應用程式伺服器所控制，則記錄檔的位置是在啟動該代理程式所在網域的網域目錄子目錄中：

…/appServer_domainName_dir/imq/instances/imqbroker/log

記錄檔為簡單的文字檔案。其命名方式如下 (從最早建立到最新建立)：

log.txt
log_1.txt
log_2.txt
…log_9.txt

依預設，每週自動重建一次記錄檔；而系統會維護 9 個備份檔案。

若要變更保留記錄檔的目錄，請將特性 imq.log.file.dirpath 設定為所需的路徑。
若要將記錄檔的根名稱從 log 變更為其他名稱，請設定 imq.log.file.filename 特性。

代理程式支援三種記錄層級：ERROR、WARNING 、INFO。表 10–2 解釋各個層級的涵義。

表 10–2 記錄層級


層級	說明
`ERROR`	表示可導致系統故障問題的訊息。
`WARNING`	應加以注意但不會導致系統故障的警示。
`INFO`	度量和其他資訊性訊息的報告。

設定某個記錄層級，則會收集此層級以及所有更高層級的訊息。預設記錄層級是 INFO，因此依預設，ERROR、 WARNING 和 INFO 訊息會全部記錄。

記錄訊息格式

記錄的訊息包含時間標記、訊息程式碼和訊息本身。資訊容量因您所設定的記錄層級而有所不同。以下為 INFO 訊息的範例。

[13/Sep/2000:16:13:36 PDT] [B1004]: Starting the broker service using tcp 
[25374,100] with min threads 50 and max threads of 500

若要變更時間標記的時區，請參閱表 14–8 中有關描述 imq.log.timezone 特性的資訊。

變更記錄程式配置

表 14–8 描述記錄的相關特性。

變更代理程式的記錄程式配置

設定記錄層級。

為一個或多個記錄種類設定輸出通道 (檔案和/或主控台)。

如果您將輸出記錄至檔案，請為此檔案配置自動重建準則。

可以透過設定記錄程式特性來完成這些步驟。您可以用以下兩種方法之一執行此作業：
- 啟動代理程式之前，請先變更或增加代理程式之 config.properties 檔案中的記錄程式特性。
- 在啟動代理程式的 imqbrokerd 指令中，指定記錄程式指令行選項。您也可以使用代理程式選項 -D 變更記錄程式特性 (或任何代理程式特性)。
在指令行上傳送的選項，會置換在代理程式實例配置檔案中所指定的特性。以下的 imqbrokerd 選項會影響記錄：

-metrics interval

代理程式度量的記錄時間間隔 (以秒為單位)

-loglevel level

記錄層級 (ERROR、WARNING、 INFO 或 NONE)

-silent

無訊息模式 (不記錄至主控台)

-tty

將所有訊息記錄至主控台

以下各節描述如何變更預設配置，以執行以下作業：
- 變更輸出通道 (記錄訊息的目標)
- 變更自動重建準則

變更輸出通道

依預設，錯誤和警告訊息可顯示在終端機上，也可記錄至記錄檔中。(在 Solaris 上，錯誤訊息也可寫入至系統的 syslog 常駐程式。)

您可以用以下方法變更記錄訊息的輸出通道：

若要使所有記錄種類 (對於指定的層級) 輸出顯示在畫面上，請使用 imqbrokerd 指令的 -tty 選項。
若要避免記錄輸出顯示在畫面上，請使用 imqbrokerd 指令的 -silent 選項。
使用 imq.log.file.output 特性，指定應寫入至記錄檔的記錄資訊種類。例如：
```
imq.log.file.output=ERROR
```
使用 imq.log.console.output 特性，指定應寫入至主控台的記錄資訊種類。例如：
```
imq.log.console.output=INFO
```
在 Solaris 上，使用 imq.log.syslog.output 特性，指定應寫入至 Solaris syslog 的記錄資訊種類。例如：
```
imq.log.syslog.output=NONE
```

備註 –

變更記錄程式輸出通道前，您必須確定所設定的記錄層級，支援要對映到輸出通道的資訊。例如，如果您將記錄層級設定為 ERROR，並且將 imq.log.console.output 特性設定為 WARNING，則不會記錄任何訊息，因為您未啟用 WARNING 訊息的記錄。

變更記錄檔自動重建準則

有兩個記錄檔自動重建準則：時間和容量。預設為使用時間準則，每七天自動重建一次檔案。

若要變更時間間隔，您需要變更特性 imq.log.file.rolloversecs。例如，以下特性定義將時間間隔變更為十天：
```
imq.log.file.rolloversecs=864000
```
若要將自動重建準則變更為取決於檔案容量，您需要設定 imq.log.file.rolloverbytes 特性。例如，以下定義會讓代理程式在檔案達到 500,000 個位元組的限制時，就自動重建檔案。
```
imq.log.file.rolloverbytes=500000
```

如果同時設定與時間相關的自動重建特性以及與容量相關的自動重建特性，則先達到的限制將觸發自動重建作業。如上所述，代理程式最多可保留九個自動重建檔案。

代理程式執行時，您可以設定或變更記錄檔自動重建特性。若要設定這些特性，請使用 imqcmd update bkr 指令。

將度量資料傳送到記錄檔

本節描述使用代理程式記錄檔報告度量資訊的程序。如需有關配置記錄程式的一般資訊，請參閱配置及使用代理程式記錄功能。

使用記錄檔報告度量資訊

配置代理程式的度量產生功能：
1. 確定 imq.metrics.enabled=true
  
  依預設，會開啟用於記錄的度量產生功能。
2. 設定度量產生的合適秒數時間間隔。
  
  imq.metrics.interval=interval
  
  您可以在 config.properties 檔案中設定此值，或在啟動代理程式時，使用 -metrics interval 指令行選項設定此值。

確定記錄程式已收集度量資訊：
imq.log.level=INFO
這是預設值。啟動代理程式時，您可以在 config.properties 檔案中設定此值，或使用 -loglevel level 指令行選項設定此值。

確定已設定記錄程式，將度量資訊寫入記錄檔：
imq.log.file.output=INFO
這是預設值。您可以在 config.properties 檔案中進行設定。

啟動代理程式。

以下所示為代理程式度量輸出到記錄檔的範例：

[21/Jul/2004:11:21:18 PDT]
Connections: 0    JVM Heap: 8323072 bytes (7226576 free) Threads: 0 (14-1010)
      In: 0 msgs (0bytes) 0 pkts (0 bytes)
     Out: 0 msgs (0bytes) 0 pkts (0 bytes)
 Rate In: 0 msgs/sec (0 bytes/sec) 0 pkts/sec (0 bytes/sec)
Rate Out: 0 msgs/sec (0 bytes/sec) 0 pkts/sec (0 bytes/sec)

如需有關度量資料的參考資訊，請參閱第 18 章, 度量參照。

記錄停用的訊息

您可以啟用代理程式停用的訊息之記錄功能來監視實體目標。無論您有沒有使用此停用的訊息佇列，都可以記錄這些停用的訊息。

啟用此停用的訊息之記錄功能後，代理程式會記錄下列類型的事件：

實體目標超出最大容量。
代理程式移除實體目標的訊息，原因可能如下：
- 已達目標容量限制。
- 訊息的時限已到。
- 訊息太大。
- 代理程式處理訊息時發生錯誤。

如果停用的訊息佇列在使用中，還會記錄下列類型的事件：

代理程式將訊息移動到停用的訊息佇列。
代理程式將停用的訊息佇列中的訊息移除並且捨棄。

以下為停用的訊息之記錄格式範例：

[29/Mar/2006:15:35:39 PST] [B1147]: Message 8-129.145.180.87(e7:6b:dd:5d:98:aa)-
35251-1143675279400 from destination Q:q0 has been placed on the DMQ because 
[B0053]: Message on destination Q:q0 Expired: expiration time 1143675279402, 
arrival time 1143675279401, JMSTimestamp 1143675279400

依預設，不記錄停用的訊息。若要記錄，請設定代理程式屬性 imq.destination.logDeadMsgs。