[MQ 9.2.4 Nov 2021]

LogTransfer 関数によって生成される出力

転送ログ・イベントは、転送が実行依頼されてから完了するまでの転送の進行状況の詳細をキャプチャーします。 再同期化に入る転送に関する情報もキャプチャーされ、転送の進行状況を把握するのに役立ちます。

転送イベント形式

転送イベントは JSON 形式で、transferlogN.json ファイルに書き込まれます。このファイルは、エージェントのログ・ディレクトリーに作成されます。ここで、N は数値で、0 がデフォルトです。 すべてのイベントに以下の共通属性が含まれます。
  • 日付および時刻 (UTC)
  • 固有 ID

イベントのタイプおよび転送ログのレベルに応じて、書き込まれるイベント情報には追加の属性が含まれます。 転送ログ・レベルの info では最小限の情報が書き込まれますが、verbose レベルではより詳細な情報が含まれます。 以下の 「サンプル・イベント」 セクションでは、エージェントによってログに記録される転送イベントの例をいくつか説明します。

固有 ID

転送の進行に応じてさまざまなフェーズを簡単に識別できるように、固有 ID が含まれています (例: BFGTL0001)。 固有 ID は eventDescription 属性の一部であり、以下の 2 つの部分で構成されます。
BFGTL
すべての ID に使用される接頭部。ここで、BFG は Managed File Transfer で使用される標準接尾部であり、TL はこれが転送ログであることを示します。
数値
1 から始まる固有の番号。 以下に例を示します。
{
  "eventDescription": "BFGTL0001: New transfer request submitted"
}

サンプル・イベント

以下の表で、追加の関数によってログに記録される情報の例として、いくつかのイベントを説明します。 表の 2 列目のログ・レベル は、イベントがログに記録されるときのレベルを示しています。

重要: logTransfer レベルが verbose または moderateに設定されている場合は、以下の属性がイベント情報に組み込まれます。
  • sourceAgent
  • destinationAgent
  • threadId
イベント ログ・レベル 説明
転送する項目のリスト verbose 
{
  "dateTime": "<Data time in UTC>",
  "eventDescription": "BFGTL0002I: Generated detailed transfer item list.",
  "destinationAgent": "<Name of destination agent>",
  "sourceAgent": "<Name of source agent>",
  "threadId": "0000001d",
  "totalItemsInTransfer": <Number of items in the transfer>,
  "transferId": "<Transfer Identifier>",
  "transferItemsList": [{"source":"source item name",
                         "destination": "destination item name"}]
}

Example:
{
  "dateTime": "2022-01-14T12:56:54.219Z UTC",
  "eventDescription": "BFGTL0002I: Generated detailed transfer item list.",
  "destinationAgent": "QMBAGQ",
  "sourceAgent": "QMBAG1",
  "threadId": "0000001d",
  "totalItems": 1,
  "transferId": "414d5120514d4120202020202020202063bd17610a390040",
  "transferItems": [{
      "destination": "/results/rts/target/destFile.txt",
      "source": "DESTINATIONQ@QMB"
  }]
}
ソース・エージェントによってログに記録される、転送の監査情報 info、moderate、verbose 
{
  "dateTime": "<Date and time in UTC>",
  "transferId": "<Transfer Id>",
  "eventDescription": "BFGTL0008: Transfer progress information ",
  "progressInformation": [{
     "destination": "<Destination item name>",
     "resultCode": "<Result of transfer>",
     "supplement": "<Any supplemental information.>"
     "source": "<Source item name>"
  }],
  "sourceAgent": "<Source agent name>",
  "destinationAgent": "<Destination agent name>",
  "threadId": "Thread Id",
}

Example:
{
  "dateTime": "2022-01-14T14:17:20.075Z UTC",
  "transferId": "414D5120514D412020202020202020202FD01761013B0040",
  "eventDescription": "BFGTL0008: Transfer progress information",
  "progressInformation": [{
     "source": "MONITORQ@QMA"
     "destination": "/results/rts/target/destinationFile.txt",
     "resultCode": "Successful",
     "supplement": ""
  }],
  "sourceAgent": "QMAAG1",
  "destinationAgent": "QMBAG1",
  "threadId": "00000023",
}
以下は、レベルが info の場合にログに記録される情報の例です。
{
  "dateTime":"2022-01-16T03:28:26.234Z UTC",
"transferId":"414D51204D4654514D20202020202020EB89416101760040",
"eventDescription":"BFGTL0008I: Transfer progress information",
  "progressInformation": {
    "warnings":0,
    "failed":1,
    "successful":0,
    "unknown":0}
}
以下は、レベルが moderate の場合にログに記録される情報の例です。
{ 
"dateTime":"2022-01-16T03:30:46.766Z UTC",
"transferId":"414D51204D4654514D20202020202020EB89416101850040",
"eventDescription":"BFGTL0008I: Transfer progress information",
"progressInformation": [{
"source":"FileZilla:/home/mft/*",
"destination":"C:/MFT/FileZilla:/home/mft/*",
"itemSize":0,
"resultCode":"Failed",
"supplement":"BFGIO0110E: File \"/home/mft/*\" does not exist."}],
"sourceAgent":"IMQFT01"
"destinationAgent":"SRC",
}
項目のオープンでエラーが発生 info 
{
  "dateTime": "<Date and time in UTC>",
  "transferId": "<Transfer Id>",
  "eventDescription": "BFGTL0054E: Failed to open an item to transfer data.",
  "itemName": "Name of file or queue",
  "error":"<Error description>"
  "sourceAgent": "<Source agent name>",
  "destinationAgent": "<Destination agent name>",
  "threadId": "<Thread Id>",
}

Example:
{
  "dateTime": "2022-01-14T14:42:24.902Z UTC",
  "transferId": "414D512043514D485830312020202020B0D4176101370040",
  "eventDescription": " BFGTL0054E: Failed to open an item to transfer data.",
  "itemName":"/inbound/resource.xml",
  "error": "File not found"
  "sourceAgent": "CQMHX01AG1",
  "destinationAgent": "HX01AG1",
  "threadId": "0000001c"
エージェントの開始時にリカバリーされる転送のリスト verbose 
{
  "dateTime": "<Date and time in UTC>",
  "eventDescription": "The list of transfers being recovered as part of agent recovery process.",
  "agentName": "<Agent name>",
  "transfers": [{"transferId":"<transfer state>"}]
  "threadId": "<Thread Id>",
}

Example:
{
  "dateTime": "2022-01-14T14:42:24.902Z UTC",
  "eventDescription": "The list of transfers being recovered as part of agent recovery process.",
  "agentName": "CQMHX01AG1",
  "transfers": [ {"414D512043514D485830312020202020B0D4176101370040":"completeReceived"},
{"414D512043514D485830312020202020B0D4176101370050":"resynchronizing"}]
  "threadId": "0000001c",
}