4D アプリケーションは、デバッグあるいは実行の最適化のために有用な複数のログファイルを生成することができます。ログは通常SET DATABASE PARAMETERあるいはWEB SET OPTIONコマンドのセレクターを使用して開始・停止され、データベースのLogsフォルダ内に保存されます(4Dファイルの説明を参照してください)。

記録された情報は、問題の検知と修正のためには分析する必要があります。この付録では以下のログファイルの包括的な詳細を提供します:

• 4DRequestsLog.txt
• 4DRequestsLog_ProcessInfo.txt
• HTTPDebugLog.txt
• 4DDebugLog.txt (標準またはタブ分け)
• 4DDiagnosticLog.txt
• 4DIMAPLog.txt、4DPOP3Log.txt、および 4DSMTPLog.txt
• ORDA クライアントリクエストのログファイル

注: ログファイルがサーバーとクライアントの両方においてログファイルが生成可能な場合、サーバー側のログファイル名には"Server" が追加されます。例えば"4DRequestsLogServer.txt"のようにです。

これらのログファイルは、デバッグ中に時系列を確立しエントリー間のつながりを分かりやすくするために、いくつかのフィールドを共有しています:

• sequence_number: この番号は全てのデバッグログ間で固有で重複せず、ログファイルに関わらず新しいエントリーごとに増加されるので、オペレーションの厳密な順番を知ることができます。
• connection_uuid: 4Dクライアントで作成されサーバーに接続する4Dプロセスには、全てこの接続UUIDがサーバー側とクライアント側とで記録されます。これにより各プロセスをローンチしたリモートクライアントを簡単に識別することができます。

このログファイルはコマンドを実行した4D Serverマシン、あるいは4D リモートマシンによって実行された標準のリクエストを記録します(Webリクエストを除きます)。

このログの開始方法:

• サーバー上:
  
   SET DATABASE PARAMETER(4D Server log recording;1) //server side
• クライアント上:
  
   SET DATABASE PARAMETER(Client Log Recording;1) //remote side

注: この宣言は4DRequestsLog_ProcessInfo.txtも開始させます(以下参照)。

ヘッダー
このファイルは以下のヘッダーから始まります:

• Logセッション識別子
• アプリケーションをホストしているサーバーのホスト名
• ユーザーログイン名: サーバー上で4Dアプリケーションを実行したユーザーのOS上のログイン名

コンテンツ
各リクエストに対して、以下のフィールドが記録されます:

リクエストのフロー:

このログファイルはコマンドを実行した4D Serverマシン、あるいは4Dリモートマシンによって作成されたそれぞれのプロセスについての情報を記録します(Webリクエストを除きます)。


このログの開始方法:

• サーバー上:
  
   SET DATABASE PARAMETER(4D Server log recording;1) //server side
• クライアント上:
  
   SET DATABASE PARAMETER(Client Log Recording;1) //remote side

注: この宣言は4DRequestsLog.txt ログファイルも開始させます(上記参照)。

ヘッダー
このファイルは以下のヘッダーから始まります:

• ログセッション識別子
• アプリケーションをホストしているサーバーのホスト名
• ユーザーログイン名: サーバー上で4Dアプリケーションを実行したユーザーのOS上のログイン名

コンテンツ

各リクエストに対して、以下のフィールドが記録されます:

このログファイルは各HTTPリクエストとそれぞれのレスポンスをrawモードで記録します。ヘッダーを含めたリクエスト全体が記録されます。オプションとして、ボディも記録することができます。

このログの開始方法:

リクエストとレスポンスの両方に対して以下のフィールドが記録されます:

このログファイルは4Dプログラミングレベルで発生するそれぞれのイベントを記録します。標準モードではイベントの基本的なビューを提供します。

このログの開始方法:

それぞれのイベントに対して、以下のフィールドが記録されます:

このログファイルは4Dのプログラミングレベルで発生するそれぞれのイベントを、タブ分けされた、(標準のフォーマットに比べて)追加された情報を含むコンパクトなフォーマットで記録します。

このログの開始方法:

それぞれのイベントに対し、以下のフィールドが記録されます:

このログファイルには内部アプリケーションオペレーションに関連した複数のイベントが記録され、また人間に読めるように書かれています。LOG EVENT コマンドを使用することでカスタムの情報をこのファイルに含めることができます。

このログの開始方法:

それぞれのイベントにおいて、以下のフィールドが記録されます:

イベントによって、タスク、ソケットなどの他の様々なフィールドを記録に含めることができます。

これらのログファイルは以下のコマンドを使用して始動された、4D アプリケーションとメールサーバー(SMTP、POP3、IMAP) 間の通信をそれぞれ記録します:

• SMTP -  SMTP New transporter
• POP3 -  POP3 New transporter
• IMAP  -  IMAP New transporter

ログファイルは2つの種類を生成することができます:

• 通常バージョン:
  • 4DSMTPLog.txt、4DPOP3Log.txt、または 4DIMAPLog.txt と名前がつけられます。
  • 添付ファイルは含めません
  • 10MB ごとの自動循環ファイルリサイクルを使用します。
  • 通常のデバッギング用途を想定しています。

このログを開始するには以下の方法があります:

• •  SET DATABASE PARAMETER(SMTP Log;1) // SMTP ログを開始 または
 SET DATABASE PARAMETER(POP3 Log;1) // POP3 ログを開始 または
 SET DATABASE PARAMETER(IMAP Log;1) // IMAP ログを開始
    
     
  • 4D Server: 4D Server 管理ウィンドウ内のメンテナンスページ のリクエストとデバッグログを開始ボタンをクリックします。
    このログのパスはGet 4D file コマンドによって返されます。

• 拡張バージョン: 
  • 添付ファイルも含まれます。
  • 自動ファイルリサイクルは使用されません。
  • カスタムの名前を使用できます。
  • 特定の目的のために用意されています。

このログを開始するには以下の方法があります:

• •  $server:=New object
 ...
  //SMTP
 $server.logFile:="MySMTPAuthLog.txt"
 $transporter:=SMTP New transporter($server)
 
  // POP3
 $server.logFile:="MyPOP3AuthLog.txt"
 $transporter:=POP3 New transporter($server)
 
  //IMAP
 $server.logFile:="MyIMAPAuthLog.txt"
 $transporter:=IMAP New transporter($server)

コンテンツ

各リクエストごとに対して、以下のフィールドが記録されます:

このログファイルにはリモートマシンが送信する ORDA リクエストが記録されます。ログ情報はメモリか、あるいはディスク上のファイルに書くことができ、ファイル名や保管場所も任意に決めることができます。

このログの開始方法:

注: ORDAリクエストログにおいてユニークな連続番号を使うには、次のように開始します:

各リクエストに対して、以下のフィールドが記録されます: